Delete File Action
<AMFILEDELETE SOURCE="text" SUBFOLDERS="yes/no" TORECYCLE="yes/no" ISNEWERTHAN="date" ISOLDERTHAN="date" EXCLUDE="text" ATTRFILTER="text" RESULTDATASET="Text" />
Deletes the file or files specified. To specify more than one file use wildcard characters (* or ?). To specify multiple files or wildcard masks, separate them with a pipe symbol (|). Example: c:\*.txt|c:\*.bak
Used to delete one or more files.
Specifies the files to delete. This can be a fully qualified path and file name (preferred) or a file name only (requires use of the Change Folder action). Wildcard characters (* or ?) may be used to delete files matching a certain mask. Multiple files and file masks may be specified by separating the entries with a pipe symbol (|).
Specifies whether to permanently delete the files or send them to the Recycle bin.
Specifies the name of a dataset to be created and populated with the result. In addition to the standard dataset fields, the dataset will contain the following:
Source: The path and file name of the source file.
Destination: The path and file name of the destination file.
Result: The result of the action - 0 for success, or an error code for failure.
Message: Textual information about the result.
When set to YES, specifies that, if present, subfolders should be searched for files matching the mask specified in the Source [SOURCE] parameter
Causes the action to not delete files matching the masks specified. Filenames or wildcard masks may be used. Multiple entries may be specified by separating them with a pipe symbol (|), for example: *.txt|*.bak
Causes the action to only delete files 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 (unless limited by the Only if older than [ISOLDERTHAN] parameter).
Causes the action to only delete files 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 (unless limited by the Only if newer than [ISNEWERTHAN] parameter).
This group of settings causes the action to filter which files are deleted based on the attribute settings of the source files.
In visual mode, a group of controls are provided to assist in the selection of this parameter. In markup mode, a single text item must be specified that contains the attributes of the files you wish to delete.
This action includes the Description tab for entering a custom step description.
More on setting custom step description
This action also includes the standard Error Causes and On Error failure handling options/tabs.
More on Error Handling Options
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
NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.
<AMFILEDELETE SOURCE="c:\folder1\*.*" />
<AMFILEDELETE SOURCE="c:\folder1\*.*" SUBFOLDERS="YES" ATTRFILTER="+r+a" RESULTDATASET="DeletionDS" />
<AMFILEDELETE SOURCE="c:\folder1\*.*" SUBFOLDERS="YES" SNEWERTHAN="%DateSerial(2007,02,01) + TimeSerial(20,42,51)%" RESULTDATASET="DeletionDS" />