Change Folder Action

Declaration

<AMCHANGEFOLDER FOLDER="text">

 

See Also

Copy File, Rename File, Delete File, Delete Folder, Create Folder. Touch File

Description

Changes the current folder for the running task. Use this action only when necessary, otherwise utilize fully qualified path names such as 'c:\docs\myfile.txt' when performing file actions.

Practical Usage

Required when using relative paths and filenames. Used to change the "current working folder".

Parameters

General Tab

Folder

Text, Required
MARKUP: FOLDER="c:\foldernametochangeto\"

Specifies the folder to change to.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

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

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMCHANGEFOLDER FOLDER="c:\docs\">