<<<<<<< action_if_folder_exists.htm <meta name=layout-height content=2029>

If Folder Exists Action

Declaration

<AMIFFOLDEREXISTS ACTION="text [options]" FOLDER="text" EXCLUDE="text" ISNEWERTHAN="datetime" ISOLDERTHAN="datetime" ATTRFILTER="text [attribute mask]"/AMIF>

See Also

    If Folder Exists Action-Setting Properties, If File Exists Action, Else Action, End If Action, The BASIC Language All Groups

Description

Causes the steps following this action to execute if the specified folder is in the specified state.  If not, execution follows the next Else or End If action, whichever comes first. Wildcards can be used.

Practical Usage

To check if a folder exists (or not) and take conditional action depending on the result.

Parameters

General Tab

If

Text, Optional Default: exist)
MARKUP: ACTION="not_exist"

Specifies the type of check to be performed..

The available options are:

Folder

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

Specifies the folder to check.

Advanced Tab

Exclude Mask

Text, Optional default - (blank)
MARKUP: EXCLUDE="*.txt"

If a wildcard is specified in filename, causes the action to not check folders matching the mask(s) specified. Filenames or wildcard ( e.g. * or ? ) masks may be used, multiple entries may be specified by separating them with the | symbol (e.g. *.txt|*.bak)

Only if newer than

date, Optional default - (none)
MARKUP: ISNEWERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%"

If a wildcard is specified in the foldername, causes the action to check folders only if the source is newer than the date/time specified. If parameter is left blank or not included, the date of the files will be ignored.

Only if older than

date, Optional default - (none)
MARKUP: ISOLDERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%"

If a wildcard is specified in the foldername, causes the action to check folders only if the source is older than the date/time specified. If parameter is left blank or not included, the date of the files will be ignored (excluding "Only if newer" [ISNEWER] parameter).

Attributes Tab

Attributes

Text, Optional (blank)
MARKUP:
ATTRFILTER="+R+A-S-H" (delete read-only and archive files, not system or hidden)
ATTRFILTER="-S" (do not delete "system" files)

This group of settings causes the action to filter which folders are checked based on the attribute settings of the folders. In visual mode, a group of controls are provided to assist in the selection of this parameter.

In markup mode, build a single text item must be specified that contains the attributes of the folders you wish to check.

Available Options:

R—Read only: Specifying "+R" causes folders with this attribute turned on to be included, "-R" causes files with this attribute turned off to be included, not specifying the letter (default) causes this attribute to be ignored.

A—Archive: Specifying "+A" causes folders with this attribute turned on to be included, "-A" causes files with this attribute turned off to be included, not specifying the letter (default) causes this attribute to be ignored.

S—System: Specifying "+S" causes folders with this attribute turned on to be included, "-S" causes files with this attribute turned off to be included, not specifying the letter (default) causes this attribute to be ignored.

H—Hidden: Specifying "+R" causes folders with this attribute turned on to be included, "-H" causes files with this attribute turned off to be included, not specifying the letter (default) causes this attribute to be ignored.

C—Compression: Specifying "+C" causes folders with this attribute turned on to be included, "-C" causes files with this attribute turned off to be included, not specifying the letter (default) causes this attribute to be ignored.

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

Examples

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

<AMIFFOLDEREXISTS SOURCE="c:\foldername">
<AMMESSAGEBOX>Folder Exists</AMMESSAGEBOX>
</AMIF>