Move File Action—Setting Properties

The Move File action is used to move files on an individual machine or across a network.

To set Move File properties

  1. From the Task Builder Available Actions pane, open the File folder and double-click the Move File action or drag it into the Steps pane. The following properties dialog appears:

  1. In the Source box, click the Open Folder button and navigate to the files to be copied. Use SHIFT+click to select groups of files, or CTRL+click to select multiple individual files. Alternately, you can type in the path and file names. You can use asterisk (*) and question mark (?) as wildcard characters. For example, use *.DOC to include all files in the selected folder with a .DOC extension. Separate multiple entries with a pipe symbol (|). Example: C:\SourceFolder\*.doc|SourceFile1.txt

  2. In the Destination box, click the Open Folder button and navigate to the folder or enter the path and (optionally) the file name for the destination location.  

    Folders that do not exist will be created at runtime provided the logged-on user has the rights to do so. Example path: C:\ExistingFolder\NewFolder\

  3. To populate a dataset with the result, enter a name for the dataset in the Create and populate dataset with result information box. (Dataset names must be alphanumeric, begin with a letter, and contain no spaces.)

    The dataset fields will be Source, Destination, Result, and Message. The Result field returns 0 for success or a Windows error code for failure. The Message field provides textual information about the result.

  4. Click the Options tab and select or clear the check boxes according to the following guidelines:

  5. In the Exclude mask box, enter the names of any files or folders within the selected source folder that you want to exclude from the action. You can use asterisk (*) and question mark (?) as wildcard characters. Separate multiple entries with a pipe symbol (|).

  6. To exclude files from the action based on date, select the Only if newer than or Only if older than check boxes. Then use the date and time boxes to select the desired date and time. You can also click the Custom button and select a limiter such as Last 24 hours, or you can select Expression and enter an expression.

  7. To limit the action according to file attributes, click the Attributes tab and then select On or Off for any attributes that you want used as criteria in the file selection. The default is Doesn't matter, which means the attribute will be ignored. The attributes to select from are: Read-only, Archive, System, Hidden, and Compression.

  8. To set the Description tab properties, refer to Description Tab Options.

  9. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  10. When finished, click OK to save settings and close the properties dialog window.

See Also

About Actions

Adding Task Steps

Move File Action