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).
Input Parameters
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. |
Output Parameters
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. |
Usage Notes
![*](bullet.gif)
After this service is executed, the folder identified by
VfsId will be the child of the folder identified by
parentVfsId.
![*](bullet.gif)
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.
![*](bullet.gif)
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.
![*](bullet.gif)
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.
![*](bullet.gif)
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:
![*](bullet.gif)
All user access permissions inherited from the old parent folder are removed.
![*](bullet.gif)
The child folder will inherit all the user permissions other than the folder traversal permission of the new parent.
![*](bullet.gif)
If you have explicitly assigned user permissions to the child folder, these permissions will be retained.
![*](bullet.gif)
Circular parent-child relationships in the VFS will not be allowed.