Set Attributes Action

Declaration

<AMSETATTRIBUTES SOURCE="text" SUBFOLDERS="yes/no" ISNEWERTHAN="date" ISOLDERTHAN="date" ATTRIBUTES="text (+/-RASH combination)" ATTRFILTER="text (+/-RASH combination)" EXCLUDE="text" RESULTDATASET="text" />

See Also

Set Attributes Action-Setting Properties, Calculate File Checksum Action, Concatenate Files Action, Get File(s) information Action, Read from File Action, Write to File Action

Description

Sets the attributes of the selected files to the specified attribute mask.

Practical Usage

Used to set the attributes of one or more files.

Parameters

General Tab

Source

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

Specifies the files that should be affected by the attribute change. 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 specify files matching a certain mask. Multiple file and/or file masks may be specified by separating the entries with a pipe symbol (|).

Attributes

Text, Required
MARKUP:
a) ATTRIBUTES="+A+H" (turn on archive and hidden attributes)
b) ATTRIBUTES="-R-S-H" (turn off read-only, system, and hidden attributes)
c) ATTRIBUTES="-R-A+S+H" (turn off read-only and archive attributes, turn on system and hidden attributes)

Specifies the attribute combination that the files should be changed to reflect.

In Visual mode simply select from the drop-down lists. In AML mode, use the RASH attribute system as outlined below.

Using the RASH Attribute System:

+ is Turn On
- is Turn Off

R - Read-Only
A - Archive
S - System
H - Hidden

Examples:

Use +R to turn on the read-only attribute and - R to turn it off. Not specifying R as a part of the text would ignore it.

Use +A to turn on the archive attribute and - A to turn it off. Not specifying A as a part of the text would ignore it.

To change several attributes in a single pass, simply put them together:

Create and Populate Dataset

Text, Optional
MARKUP: RESULTDATASET="DatasetName"

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:

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 not to affect 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

Only if Newer Than

Date, Optional, Default: (none)
MARKUP: ISNEWERTHAN="%DateSerial(2007,02,01) + TimeSerial(00,00,00)%"

Causes the action to only affect files if the source is newer than the date/time specified. If this 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).

Only if Older Than

Date, Optional, Default: (none)
MARKUP: ISOLDERTHAN="%DateSerial(2007,02,01) + TimeSerial(00,00,00)%"

Causes the action to only affect files if the source is older than the date/time specified. If this 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).

Attributes Tab

Attributes

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

This group of settings causes the action to filter which files are affected by the attribute change based on the original attribute settings of the source files.

In visual mode, a group of controls are provided to assist in the selection of this parameter. In AML mode, a single text item must be specified that contains the original attribute mask of the files you wish to affect.

Available Options:

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.

<AMSETATTRIBUTES SOURCE="c:\myfile.txt" ATTRIBUTES="+s" />

<AMSETATTRIBUTES SOURCE="C:\SourceFolder\*.*" SUBFOLDERS="YES" ISOLDERTHAN="%DateSerial(2007,02,26) + TimeSerial(23,41,46)%" ATTRIBUTES="+a" ATTRFILTER="-s-h" EXCLUDE="*.pri" RESULTDATASET="SetAttrDataset" />