Renaming Files

Renaming Files

After you create a basic file rename action as described in Creating a Basic File Operation Action, use this procedure to set the properties of the action.

To set the properties of a file rename action

1. In the Source Filter box, enter the name of the file whose transfer will trigger this event. By default, ActiveTransfer Server considers all files.

Note: You can use wildcard characters to filter the file names. For example, enter *.zip to trigger the event only when zip files are uploaded or downloaded. To trigger an event based on a name string in the zip files, use the name string in the Source Filter box, preceded and followed by wildcard characters. For example, enter *invoice*.zip to trigger the event based on the file URLs, when zip files containing the character string invoice in their file names are uploaded or downloaded. If you define a Source Filter for an action, the action acts only on the files that are filtered out.

For information on the use of wildcards in ActiveTransfer Server, see Use of Special Characters in Search.

2. If you want to use regular expression in the source filter, specify a valid regular expression in Source Filter and select Use regular expression.

Examples for regular expressions:

(.(?!purchaseorder))*	Excludes files with the file URL containing purchaseorder
./out/.	Include files with the file URL containing the folder out
^abc(.*)123$	Includes anything that starts with abc and ends with 123. Matches abc123, abcxyz123, but not abcxyz123def
NEW-((.doc)\|(_backup_*))	Includes anything starting with NEW- that either ends in .doc, or is followed by the string _backup_

3. In the New File Name box, enter the new file name for the file.

4. Select additional properties for the file rename action as follows:

Select this option...	To...
Retry [ ] times, at intervals of [ ] second(s)	Retry a failed rename operation for the specified number of times, at the interval specified in seconds.
Skip sub-items, if parent is already renamed	Rename a folder but not the files beneath the folder.
Execute error action	Execute an error action if the file operation fails.
Execute asynchronously	Execute the file operation in a different thread so that it does not interfere with other actions.

5. Click Save.

6. If you selected the Execute error action check box, define an error action as described in Defining an Error Action.

7. If you are finished defining actions for this event, activate the event as described in Activating an Event.

Result:

A “Rename” action renames the files passed on from the previous action. The files that are renamed are not passed on to the next action.