Copy File

The Copy File activity allows you to copy files and directories to a new location.

Field	Global Var?	Description
Name	No	The name to appear as the label for the activity in the process definition.
Description	No	Short description of the activity.
Overwrite	No	Overwrite existing file or directory with the same name, if one exists. The activity raises an exception if the specified file or directory exists and this field is unchecked.
Create Destination Directory	No	Create any directories in the destination path that do not already exist. This activity raises an exception if any of the directories on the specified destination path do not exist and this field is unchecked.
Include Sub-Directories	No	When the source to copy is a directory, include all sub-directories in the source directory.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about mapping and transforming input data.

Input Item	Datatype	Description
fromFileName	string	The path and name of the file or directory to copy. For directories, you must specify an absolute path. You may use wildcards when specifying files within a directory. For example, to copy a directory, specify c:\myDirectory. To copy all text files in a directory, specify c:\myDirectory\*.txt.
toFileName	string	The destination for the copy operation. This must be an absolute path; wildcards cannot be used in this element.

For example, to copy a directory, specify c:\myDirectory. To copy all text files in a directory, specify c:\myDirectory\*.txt.

The Error Output tab lists the possible exceptions that can be thrown by this activity. See TIBCO ActiveMatrix BusinessWorks Error Codes for more information about error codes and corrective action to take.

Exception	Thrown When...
FileNotFoundException	The source file is not found or the destination is not found and the Create Destination Directory field is not checked on the Configuration tab.
IllegalCopyException	The destination exists and its type is different than the type of the specified source. For example, in the activity input, the fromFileName is a directory and the toFileName is a file.
FileAlreadyExistsException	The destination you are attempting to copy to already exists and the Overwrite field is not checked on the Configuration tab.
FileIOException	There is an I/O error. For example, the file or directory already exists and is write protected.