FTP Delete Action

Declaration

<AMFTPDELETE SOURCE="text" EXCLUDE="text" SUBFOLDERS="yes/no" SESSION="text">

See Also

FTP Delete Action-Setting Properties, FTP Log On, FTP Upload, FTP Download, FTP Delete, FTP Rename, FTP Create Folder, FTP Remove Folder, FTP Change Folder, HTTP Post

Description

Deletes the file(s) specified from the FTP server. To specify more than one file use wildcards ( e.g. * or ? ). To specify multiple files or wildcard masks, separate them with a vertical bar. Example: /*.txt|*.bak.

Practical Usage

See description.

Parameters

General Tab

Remote File(s)

Text, Required
MARKUP:
a) SOURCE="/sourcefoldername/file.txt"
b) SOURCE="/sourcefoldername/*.txt"
c) SOURCE="/sourcefoldername/*.txt|/sourcefoldername/*.doc"
c) SOURCE="file.txt"

Specifies the file(s) to download. This can be a fully qualified UNIX style path and filename (preferred) or a single file (requires use of the FTP Change Folder action). Wildcards ( e.g. *.* or ? ) may be used to download files matching a certain mask. Multiple file and/or file masks may be specified by separating the entries with the | symbol.

Session Name

Text, Optional default="default"
MARKUP: SESSION="SeverB"

Specifies the session (created in a previous FTP Log On action) that should be used to perform the deletion. This allows for multiple simultaneous FTP transfers to take place.

 

Options Tab

Include subfolders

Yes/No, Optional default - NO
MARKUP: SUBFOLDERS="YES"

When set to YES, specifies that, if present, subfolders should be searched for files matching the mask specified in the "Source" [SOURCE] parameter

Exclude Mask

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

Causes the action to not delete any files 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)

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.

 <AMFTPDELETE SOURCE="/Temp/Book1.xlsx" />