tFileCopy Standard properties

File Name

Specify the path to the file to be copied.

This field does not appear when the Copy a directory check box is selected.

Copy a directory

Select this check box to copy a directory including all subdirectories and files in it.

Source directory

Specify the source directory to copy.

This field appears only when the Copy a directory check box is selected.

Destination directory

Specify the directory to copy the source file or directory to.

Rename

Select this check box if you want to rename the file copied to the destination.

This field does not appear when the Copy a directory check box is selected.

Destination filename

Specify a new name for the file to be copied.

This field appears only when the Rename check box is selected.

Remove source file

Select this check box to move the source file to the destination directory. This processor does not perform a copy operation, unless you select the Force copy instead of move check box in the Advanced settings.

This field does not appear when the Copy a directory check box is selected.

Replace existing file

Select this check box to overwrite any existing file with the newly copied file.

This field does not appear when the Copy a directory check box is selected.

Create the directory if it doesn't exist

Select this check box to create the specified destination directory if it does not exist.

This field does not appear when the Copy a directory check box is selected.

Force copy instead of move

Select this option to perform a copy operation instead of the default move operation.

This field appears only when the Remove source file check box is selected.

Preserve last modified time

Select this option to use the last modified time of the source file as that of the destination file.

If this option is not selected, the current OS behavior for last modified time is adopted.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a Job level as well as at each component level.

Global Variables

DESTINATION_FILENAME: the destination file name. This is an After variable and it returns a string.

DESTINATION_FILEPATH: the destination file path. This is an After variable and it returns a string.

SOURCE_DIRECTORY: the source directory. This is an After variable and it returns a string.

DESTINATION_DIRECTORY: the destination directory. This is an After variable and it returns a string.

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it.

For more information about variables, see Using contexts and variables.

Usage rule

This component can be used as a standalone component.

Connections

Outgoing links (from this component to another):

Row: Main.

Trigger: On Subjob Ok; On Subjob Error; Run if; On Component Ok; On Component Error.

Incoming links (from one component to this one):

Row: Main; Reject; Iterate.

Trigger: Run if; On Subjob Ok; On Subjob Error; On component Ok; On Component Error; Synchronize; Parallelize.

For further information regarding connections, see Using connections in a Job.