Rename

Change a file name in the DropZone.

Rename changes a file name in the DropZone. When the file is transferred to the target Endpoint(s) (either via an explicit transfer call or via an implicit deployment) it will be given the new name.

rename takes three named parameters:

Parameter Description
from Mandatory. The name of the file to be renamed.
to Mandatory. The new name for the file.
serverspecific Optional. A Boolean value (true/false) that indicates that the file should be renamed for each target Endpoint. Defaults to false. Set this parameter to true should the new name include a value associated with an Endpoint.

Example:

Rename a file before it's deployed:

rename(from: "config.txt", to: "config.xml");

Example: Create a file named for each _Endpoint_:

rename(from: "config.txt", to: "${server.name}\_config.xml",

serverspecific: true);

If the target _Endpoint_s are server1 and server2 then server1 will receive the config.txt renamed to server1\_config.xml and server2 will receivethe config.txt renamed to server2\_config.xml.
Last modified May 19, 2020: after dmscript (aa9d9ae)