wm.mft.assets.vfs:changeParent

Use this service to change the parent virtual folder of a folder and link it to another parent folder, or to change a subfolder to a root folder in the ActiveTransfer Server Virtual File System (VFS).

vfsId	String The internal identifier of the virtual folder in ActiveTransfer Server for which you want to change the parent folder.
parentVfsId	String The internal identifier of the new parent virtual folder to which you want to link the virtual folder identified by vfsId above. Specify a null value in this parameter to set the virtual folder as the root folder in the VFS.

success	String If the service was successful in assigning a new parent to the specified virtual folder in ActiveTransfer Server. true The service was successful. false The service was not able to change the parent of the virtual folder in ActiveTransfer Server.
message	String A message that is logged after the service execution is complete.
validationErrors	String List An array of all the error messages logged during validation of input parameters.

After this service is executed, the folder identified by VfsId will be the child of the folder identified by parentVfsId.

If you specify a null value in parentVfsId for the folder identified by vfsId, the folder will not be assigned a parent after you run this service. The folder will be moved to the root level.

If the child folder already has a parent and you specify a new parent in parentVfsId, running this service will remove the existing link between the parent and child folder. The child folder will be assigned the new parent.

If the new parent has a partner, the child folder will be assigned the partner of the new parent. If parentVfsId is null, the partner associated with the child folder will not be changed.

If the parentVfsId is not null, after you run this service, the user access permissions of the users associated with the child folder will change as follows:

The child folder will inherit all the user permissions other than the folder traversal permission of the new parent.

If you have explicitly assigned user permissions to the child folder, these permissions will be retained.