File System - Change Folder

Declaration

<AMCHANGEFOLDER FOLDER="text" />

Description: Changes the current folder or "working directory" for the running task. This is similar to double-clicking the folder you wish to change to in Windows Explorer or using the Cd or Chdir command in MS-DOS (For example: 'chdir c:\' or 'cd c:\').

IMPORTANT: NOTE: Use this activity only when necessary, otherwise, specify fully qualified path names such as 'c:\folderName\subFolderName\fileName.txt' when performing file related operations.

Practical Usage

Commonly used to change the working directory when using relative paths.

General Parameters

Property

Type

Required

Default

Markup

Description

Folder

Text

Yes

(Empty)

FOLDER="C:\Temp\FolderName"

The full path and folder name of the folder to change to.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Example

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Change to folder "c:\documents\folder1".  

<AMCHANGEFOLDER FOLDER="c:\documents\folder1" />