Definition and Usage
Change the name of a folder. This command allows you to rename an existing folder to a new name and optionally handle situations where a folder with the new name already exists.
Parameter Values
Input parameters
Parameter | Description | Possible Values | Required | Options / Notes |
Folder to rename | Please select the folder you wish to rename | - | Yes | Use the folder selector to choose the target folder |
New folder name | New folder name. Rename fails if the name already exists. | - | Yes | You can enter a text string or use a variable |
If folder exists | When the folder already exists, you can choose either not to rename or to overwrite it. | Skip, Overwrite | Yes | When overwriting, files in the original folder without name conflicts will be preserved |
Error handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will trigger an error and stop the execution of the entire app. |
Retry command | If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process. |
Ignore error & continue | When an error occurs, the action will be ignored, and the workflow will continue without interruption. |
Variables produced
Store the updated folder path in a new variable. The output variable will contain the full path to the renamed folder.
Using Variables in Conditions
You can use variables in the "New folder name" parameter by clicking the {x} icon. This allows you to dynamically set folder names based on previously defined variables. For example, you could use a variable that contains a timestamp or other dynamic content to create unique folder names.
Notes
Ensure you have proper permissions to rename the folder before executing this command.
The rename operation may fail if the folder is currently in use by another process or application.
When using the "Overwrite" option, be cautious as it may result in merging folder contents.
Absolute paths are recommended when specifying folder locations to avoid ambiguity.
Special characters in folder names might cause issues depending on the operating system.