Copy

Operation Name

Copy

Function overview

Duplicate file or directory.

Properties

For information about using variables, refer to "variables".

Basic settings

Item name	Required/Optional	Use of Variables	Description	Remarks
Name	Required	Not available	Enter the name on the script canvas.

Required settings

Item name	Required/Optional	Use of Variables	Description	Remarks
Copy source	Required	Available	Enter the path of the file or directory to copy. Click [Browse] button to activate the file Selectr and Select the file.	Please specify the absolute path of the DataSpider file system as the file path. Constrained Characters of DataSpider File System cannnot be used except for the path separator "/" and wildcard ("*","?").
Copy to	Required	Available	Enter the path of the destination of the copied file. Click [Browse] button to activate the file Selectr and Select the directory.	Please specify the absolute path of the DataSpider file system as the file path. Constrained Characters of DataSpider File System cannnot be used except for the path separator "/".

Option

Item name	Required/Optional	Use of Variables	Description	Remarks
Error when file already exists in copying destination	Optional	Not available	Select whether to raise an error when the file specified in the copy source already exist in the copy destination. [Checked]: (default) Raise error. [Not Checked]: Overwrite.	Copy option is only for files.When the specified directory exists in the copy destination, FileExistsException is thrown.

Comment

Item name	Required/Optional	Use of Variables	Description	Remarks
Comment	Optional	Not available	You can write a short description of this adapter. The description will be reflected in the specifications.

Schema

Input Schema

None.

Output Schema

None.

Transaction

Transaction is not supported.

PSP Usage

PSP is not supported.

Available Component variables

Variable name	Description	Remarks
success	Wither success or failure of the process is stored.	The value defaults to null. If successful the operation is true, returns false if it fails.
copyCount	Returns the number of the files or directories copied.	The value defaults to null.
message_category	Stroes the category to which corresponding message code belongs to, when an error occurs.	The value defaults to null.
message_code	Stores its corresponding message code of occured error.	The value defaults to null.
message_level	Stores the severity of the corresponding message code of the occured error.	The value defaults to null.
error_type	Stores the type of the occured error.	The value defaults to null. Error is represented in the format depicted below. Example:java.io.FileNotFoundException The message may vary depending on DataSpider Servista version.
error_message	Stores the error message for the occured error.	The value defaults to null. The message may vary depending on DataSpider Servista version.
error_trace	Stores stack trace of the occurred error.	The value defaults to null. The message may vary depending on DataSpider Servista version or the client application used.

Specification Limits

You can use wildcards in the [Copy source] on "* (zero time or more)" and "? (1 or 0 time)". Regular expressions are not allowed.

[Copy source] is case-sensitive.

Files copied before the error cannot be rolled back.

The last modified time of files copied is the time that this operation is executed.

Main exceptions

Exception name	Cause	Solution
InvalidPropertyConfigurationException <Property name> is not specified.	[<Property name>] is not specified.	Specify the [<Property name>].
FileExistsException	The specified file or directory already exist in the copy destination.	Check the file or directory in the [Copy source] or the [Copy to].
java.io.FileNotFoundException	The specified file or directory not found.	Check the file or the directory in the [Copy source] or the [Copy to].
PathIsNotAbsoluteException	The specified path is a relative path. The path only accepts an absolute path.	Specify an absolute path for the [Copy source] or the [Copy to].