Rename Folder

Renames a directory or folder. This action can optionally move the renamed folder to a new location. If the folder specified contains sub-folders and files, they will also be included during runtime. Only user-created folders can be renamed. System or special folders cannot be renamed. Commonly used to rename and/or move a single directory and all of its subdirectories.

Declaration

<AMRENAMEFOLDER FOLDER="text" NEWNAME="text" RESULTDATASET="text" />

Example 1 - Rename Folder action used to move a folder and its files from one directory to the another. The original folder name is specified.

<AMRENAMEFOLDER FOLDER="C:\FolderName" NEWNAME="C:\NewFolderName" RESULTDATASET="FolderRenameDS" />

Example 2 - Rename Folder action used to rename a folder to a new name as well as move it to another location.

<AMRENAMEFOLDER FOLDER="C:\FolderName" NEWNAME="C:\NewFolderName" RESULTDATASET="FolderRenameDS" />

See Also

Join File, Copy File, Delete File, Delete Folder, Create Folder, Touch File, Calculate File Checksum, Concatenate Files, Get File(s) information, About Datasets

General Tab

Property

Type

Required

Default

Markup

Description

Original Folder Name

Text

Yes

(Empty)

a)FOLDER="c:\sourcefolder\"

b)FOLDER="c:\sourcefolder\subfolder"

Specifies the path and folder name of the folder(s) to rename.

New Folder Name

Text

Yes

(Empty)

a)NEWFOLDER="c:\destfolder\"

b)NEWFOLDER="c:\destfolder\subfolder"

The new destination and/or folder name or the new destination folder and (optionally) Folders specified that do not exist will be automatically created at runtime. Wildcard characters (* or ?) may be used.

Create and Populate Dataset with Result Information

Text

No

(Empty)

RESULTDATASET="DatasetName"

The name of a dataset to be created and populated with status regarding this operation.

More about datasets

Description Tab

The Description tab allows you to customize the text description of any step as it appears in the Task Builder's Steps Pane.

More on setting custom step description

Error Causes Tab

The Error Causes tab allows you to select/omit specific errors that should cause a particular step to fail.

More on Error Causes

On Error Tab

The On Error tab allows you to determine what the task should do if a particular step encounters an error.

More about On Error properties

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, % Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables

More on expressions

More on the expression builder