importPackage(Packages.java.io); importPackage(Packages.de.elo.ix.client); //@include lib_Class.js //@include lib_sol.common.ObjectUtils.js //@include lib_sol.common.SordUtils.js //@include lib_sol.common.RepoUtils.js //@include lib_sol.common.UserUtils.js //@include lib_sol.common.ix.FunctionBase.js var logger = sol.create("sol.Logger", { scope: "sol.common.ix.functions.CopyFolderContents" }); /** * Copies whole folder recursively. * * # As IX function call * * sol.common.IxUtils.execute("RF_sol_function_CopyFolderContents", { * objId: 123, * source: 1233, * copySourceAcl: false, * inheritDestinationAcl: true * }); * * # Node configuration example: * * { * "source": "ARCPATH:/MyTemplates/MyTemplate1" * } * * @author JHR, ELO Digital Office GmbH * @version 1.04.000 * * @eloix * @requires sol.Logger * @requires sol.common.JsonUtils * @requires sol.common.ObjectUtils * @requires sol.common.ix.RfUtils * @requires sol.common.ix.FunctionBase * */ sol.define("sol.common.ix.functions.CopyFolderContents", { extend: "sol.common.ix.FunctionBase", requiredConfig: ["objId", "source"], /** * @cfg {Number} objId (required) * ObjectId of destination folder */ /** * @cfg {Number} source (required) * ObjectId of source folder which content should be copied */ /** * @cfg {Boolean} [copySourceAcl=false] * Copies the ACL of parent element when set */ copySourceAcl: false, /** * @cfg {Boolean} [inheritDestinationAcl=true] * Inherits the ACL of the destination element when set */ inheritDestinationAcl: true, /** * @cfg {Boolean} [copyOnlyWorkversion=true] * Copy only the work version */ copyOnlyWorkversion: true, /** * @cfg {Boolean} [copyOnlyBaseElement=false] * Copy only the base element */ copyOnlyBaseElement: false, /** * @cfg {String} name * If set, the new elements name will set to this, instead of the sources name */ /** * @cfg {Boolean} [useQuickCopy=false] * If `true` the copy process will be executed asynchronous. The first element will be created as fast as possible and the children will be copied in a background job. */ useQuickCopy: false, /** * @cfg {Object[]} metadata Only applied if {@link #useQuickCopy} is `true`. * Set additional metadata on the root element after copying the element. * For syntax of the see {@link sol.common.SordUtils#updateSord updateSord}. */ /** * @cfg {Object[]} acl Only applied if {@link #useQuickCopy} is `true`. * @cfg {String} [acl.mode="ADD"] Supported are `SET` and `ADD` * @cfg {Object[]} acl.entries Definition which ACL should be set/added * @cfg {String} acl.entries.userId Either userId or userName has to be defined * @cfg {String} acl.entries.userName Either userId or userName has to be defined. `userName` can be "$CURRENTUSER" to use the current user. * @cfg {String} [acl.entries.type="USER"] Defines if the ACL item is for a user or a group (`USER` or `GROUP`). * @cfg {Object} acl.entries.rights Definition of access * Change access in addition to `copySourceAcl` and `inheritDestinationAcl`. */ /** * @private * @cfg {Number} [sleepTime=200] * The time in ms to recheck, if the process has finished. * For longer running copy processes this value can be increased to reduce the number of polling requests. * Not used when `useQuickCopy = true`. */ initialize: function (config) { var me = this; me.$super("sol.common.ix.FunctionBase", "initialize", [config]); me.sleepTime = (sol.common.ObjectUtils.isNumber(config.sleepTime)) ? config.sleepTime : 200; }, /** * Copies whole folder recursively. * @returns {String} The objId of the copied folder */ process: function () { var me = this, ixConn, newObjId; if (me.source == "") { throw "InvalidArgument: 'source' parameter can not be empty."; } ixConn = (me.asAdmin === true) ? ixConnectAdmin : ixConnect; me.source = sol.common.RepoUtils.getObjId(me.source); me.logger.info(["CopyFolderContents: source={0}, newParent={1}", me.source, me.objId]); if (me.useQuickCopy === true) { newObjId = me.executeQuickCopy(ixConn); } else { me.logger.debug("Use old synchronous copy process."); newObjId = me.executeBackgroundCopy(ixConn, [me.source], me.objId, me.name, false); } return newObjId; }, executeQuickCopy: function (ixConn) { var me = this, sordProperties = ["name", "desc", "objKeys", "type", "aclItems"], srcSord, newSord, newAclItems, additionalMapItems, mapItems, children, childrenIds; srcSord = ixConn.ix().checkoutSord(me.source, SordC.mbAllIndex, LockC.NO); if (sol.common.SordUtils.isDocument(srcSord)) { me.logger.debug("Use old synchronous copy process for documents."); return me.executeBackgroundCopy(ixConn, [me.source], me.objId, me.name, false); } newSord = sol.common.SordUtils.cloneSord(srcSord, { dstParentId: me.objId, memberNames: sordProperties, inheritDestinationAcl: me.inheritDestinationAcl }); if (me.name) { newSord.name = me.name; } if (me.acl && me.acl.entries && (me.acl.entries.length > 0)) { newAclItems = (me.acl.mode == "SET") ? [] : Array.prototype.slice.call(newSord.aclItems); me.acl.entries.forEach(function (aclEntry) { var accessCode, userId, userName, type; accessCode = sol.common.AclUtils.createAccessCode(aclEntry.rights); userId = (typeof aclEntry.userId !== "undefined") ? aclEntry.userId : ""; userName = (typeof aclEntry.userName !== "undefined") ? aclEntry.userName : ""; type = (aclEntry.type == "GROUP") ? AclItemC.TYPE_GROUP : AclItemC.TYPE_USER; if (userName == "$CURRENTUSER") { userName = String(ixConnect.loginResult.user.name); } newAclItems.push(new AclItem(accessCode, userId, userName, type)); }); newSord.aclItems = newAclItems; } if (me.metadata && (me.metadata.length > 0)) { additionalMapItems = sol.common.SordUtils.updateSord(newSord, me.metadata); } ixConn.ix().checkinSord(newSord, SordC.mbAllIndex, LockC.NO); mapItems = ixConn.ix().checkoutMap(MapDomainC.DOMAIN_SORD, srcSord.id, null, LockC.NO).items || []; if (additionalMapItems) { mapItems = mapItems.concat(additionalMapItems); } if (mapItems.length > 0) { ixConn.ix().checkinMap(MapDomainC.DOMAIN_SORD, newSord.id, newSord.id, mapItems, LockC.NO); } children = sol.common.RepoUtils.findChildren(srcSord.id, { includeFolders: true, includeDocuments: true, includeReferences: true, sordZ: SordC.mbMin }, ixConn); if (children && (children.length > 0)) { childrenIds = children.map(function (child) { return String(child.id); }); me.copySourceAcl = false; me.inheritDestinationAcl = true; me.executeBackgroundCopy(ixConn, childrenIds, newSord.id, null, true); } return newSord.id; }, executeBackgroundCopy: function (ixConn, startIds, parentId, name, async) { var me = this, dstObjId = null, navInfo, procInfo, jobState; navInfo = new NavigationInfo(); navInfo.startIDs = startIds; procInfo = new ProcessInfo(); procInfo.desc = "sol.common.ix.functions.CopyFolderContents"; procInfo.errorMode = ProcessInfoC.ERRORMODE_CRITICAL_ONLY; procInfo.procCopyElements = new ProcessCopyElements(); procInfo.procCopyElements.copyOptions = new CopyOptions(); if (me.name) { procInfo.procCopyElements.copyOptions.targetName = name; } if (me.copyOnlyWorkversion) { procInfo.procCopyElements.copyOptions.copyOnlyWorkversion = true; } if (me.copyOnlyBaseElement) { procInfo.procCopyElements.copyOptions.copyOnlyBaseElement = true; } else { procInfo.procCopyElements.copyOptions.copyStructuresAndDocuments = true; } procInfo.procCopyElements.copyOptions.newParentId = parentId; procInfo.procCopyElements.createMapping = !async; // Set permissions if (me.copySourceAcl != me.inheritDestinationAcl) { if (me.copySourceAcl) { procInfo.procCopyElements.copyOptions.keepOriginalPermissions = true; } if (me.inheritDestinationAcl) { procInfo.procCopyElements.copyOptions.takeTargetPermissions = true; } } me.logger.debug(["start copy process: startIds={0}, parentId={1}", startIds, parentId]); jobState = ixConn.ix().processTrees(navInfo, procInfo); if (!async) { while (jobState && jobState.jobRunning) { Packages.java.lang.Thread.sleep(me.sleepTime); jobState = ixConn.ix().queryJobState(jobState.getJobGuid(), true, true, true); me.logger.debug(["jobState.countProcessed={0}, jobState.countErrors={1}", jobState.countProcessed, jobState.countErrors]); } me.logger.debug(["Job '{0}' finished: jobState.countProcessed={1}, jobState.countErrors={2}", procInfo.desc, jobState.countProcessed, jobState.countErrors]); dstObjId = jobState.procInfo.procCopyElements.copyResult.mapIdsSource2Copy.get(new java.lang.Integer(me.source)); } return dstObjId; } }); /** * @member sol.common.ix.functions.CopyFolderContents * @static * @inheritdoc sol.common.ix.FunctionBase#onEnterNode */ function onEnterNode(clInfo, userId, wFDiagram, nodeId) { var params, module; logger.enter("onEnterNode_sol.common.ix.functions.CopyFolderContents", { flowId: wFDiagram.id, nodeId: nodeId }); sol.common.WfUtils.checkMainAdminWf(wFDiagram); params = sol.common.WfUtils.parseAndCheckParams(wFDiagram, nodeId); params.objId = wFDiagram.objId; module = sol.create("sol.common.ix.functions.CopyFolderContents", params); module.process(); logger.exit("onEnterNode_sol.common.ix.functions.CopyFolderContents"); } /** * @member sol.common.ix.functions.CopyFolderContents * @static * @inheritdoc sol.common.ix.FunctionBase#onExitNode */ function onExitNode(clInfo, userId, wFDiagram, nodeId) { var params, module; logger.enter("onExitNode_sol.common.ix.functions.CopyFolderContents", { flowId: wFDiagram.id, nodeId: nodeId }); sol.common.WfUtils.checkMainAdminWf(wFDiagram); params = sol.common.WfUtils.parseAndCheckParams(wFDiagram, nodeId); params.objId = wFDiagram.objId; module = sol.create("sol.common.ix.functions.CopyFolderContents", params); module.process(); logger.exit("onExitNode_sol.common.ix.functions.CopyFolderContents"); } /** * @member sol.common.ix.functions.CopyFolderContents * @method RF_sol_function_CopyFolderContents * @static * @inheritdoc sol.common.ix.FunctionBase#RF_FunctionName */ function RF_sol_function_CopyFolderContents(iXSEContext, args) { var params, module, objId; logger.enter("RF_sol_function_CopyFolderContents", args); params = sol.common.ix.RfUtils.parseAndCheckParams(iXSEContext, arguments.callee.name, args, "objId", "source", "copySourceAcl", "inheritDestinationAcl"); try { sol.common.ix.RfUtils.checkMainAdminRights(iXSEContext.user, params); } catch (e) { params.asAdmin = false; } module = sol.create("sol.common.ix.functions.CopyFolderContents", params); objId = module.process(); logger.exit("RF_sol_function_CopyFolderContents"); return sol.common.JsonUtils.stringifyAll(objId); }