Diagram
A Copy operation performs the transfer of files between a source and a target host. Two settings groups are available to specify a Copy operation: This parameter specifies the source of a Copy operation. The following frequently used settings groups are available: This element references a readable fragment that is used to copy files in a Copy operation. Any number of reusable Fragments elements can be configured and are distinguished by YADE based on their name attribute. A subsequent fragment reference element points to the fragment that is used as source in the Copy operation. This element references the fragment that is used for an FTP file transfer operation. Any number of reusable FTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPFragment element. This attribute identifies the fragment that is used for the FTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable FTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPSFragment element. This attribute identifies the fragment that is used for the FTPS protocol. This element references the fragment that is used for an HTTP file transfer operation. Any number of reusable HTTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPFragment element. This attribute identifies the fragment that is used for the HTTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable HTTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPSFragment element. This attribute identifies the fragment that is used for the HTTPS protocol. A local source is considered to be located locally to the YADE Client, i.e. in the local file system. This element references the fragment that is used for an SFTP file transfer operation. Any number of reusable SFTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SFTPFragment element. This attribute identifies the fragment that is used for the SFTP protocol. This element references the fragment that is used for an SMB file transfer operation. Any number of reusable SMBFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SMBFragment element. This attribute identifies the fragment that is used for the SMB protocol. This element references the fragment that is used for an WebDAV file transfer operation. Any number of reusable WebDAVFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the WebDAVFragment element. This attribute identifies the fragment that is used for the WebDAV protocol. Alternative fragements can be specified as a replacement for existing file transfer fragments in case that a connection cannot be established with those fragments. Alternative fragments can be specified from a range of protocol fragments for use with the source of a file transfer operation without modifying files. For each fragment type depending on the file transfer protocol in use an alternative fragment type is available. This element references the fragment that is used for an FTP file transfer operation. Any number of reusable FTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPFragment element. This attribute identifies the fragment that is used for the FTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable FTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPSFragment element. This attribute identifies the fragment that is used for the FTPS protocol. This element references the fragment that is used for an HTTP file transfer operation. Any number of reusable HTTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPFragment element. This attribute identifies the fragment that is used for the HTTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable HTTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPSFragment element. This attribute identifies the fragment that is used for the HTTPS protocol. A local source is considered to be located locally to the YADE Client, i.e. in the local file system. This element references the fragment that is used for an SFTP file transfer operation. Any number of reusable SFTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SFTPFragment element. This attribute identifies the fragment that is used for the SFTP protocol. This element references the fragment that is used for an SMB file transfer operation. Any number of reusable SMBFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SMBFragment element. This attribute identifies the fragment that is used for the SMB protocol. This element references the fragment that is used for an WebDAV file transfer operation. Any number of reusable WebDAVFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the WebDAVFragment element. This attribute identifies the fragment that is used for the WebDAV protocol. This parameter is used to specify a directory on one of the involved servers. Directories can be adressed using a folder structure, e.g. /folder1/folder2. For Windows systems when used with the LocalSource parameter then a Windows path including a drive letter can be specified. For all server systems the standard syntax using can be used which includes forward slashes to separate folder names. The directory can be set absolute or relative to the working directory, where the working directory depends on the server configuration. If for example a user "test" connects to an SFTP server then this user might have /home/test/ as a working directory. This applies to servers that use the home directory as the working directory. In this case you can use relative and absolute adressing as in These options apply to the handling of files on a source server. They specify e.g. the Selection of files for Copy and Move operations. A file Selection includes specifying one of In some file transfer scenarios the recipient of a file does not know when the sender creates the file. In case of (very) large files the recipient may try to read the file before the sender has finished writing it. This can result in the recipient retrieving an incomplete file. Including the CheckSteadyState parameter ensures that the file is checked at its reception point for completeness before starting the transfer. Including the CheckSteadyState parameter ensures that the file is checked at its reception point for completeness before starting the transfer. If the check of the steady state of one incoming file did not succeed successfully then no file will be transferred. Note that this is not a very reliable approach as the recipient checks the date of last modification and the size of the file. If neither changes during a specified a period of time then the file is assumed to be complete. However, if transmission is terminated without the file being completely written, the network goes down or the processing speed of the file is slow, then the receiver will get a corrupted file. The shorter the check interval is chosen the more likely it may happen that a file is detected as steady, although this was not yet finished writing. Directives are options that specify the behavior with specific file characteristics: Polling is the YADE capability to wait for incoming files. This parameter specifies the maximum number of files that are considered for transfer. If additional files were available then they will be ignored. Note that it is not possible to specify which files will be ignored should the value set for this parameter be exceeded. It therefore only makes sense to use this parameter in particular situations such as when the contents of a directory will be repeatedly polled. This parameter makes use of a checksum file that is available with the source of a file transfer. The name of the checksum file is assumed to be the same as the source file with an additional extension .md5. During file transfer the contents of the checksum file is compared with the checksum that is calculated from the transfer of the file. When used with a jump host then integrity checking applies to source and jump host, not to the target of the transfer. With this element being used a checksum file is expected on the source system and the integrity hash for the target file is calculated and compared with the respective integrity hash of the source file. If the hashes are not equal then the file transfer will be rolled back. If the checksum file on the source system is missing then this will be reported as an information but will not affect the transfer of files. This parameter specifies the target of a Copy operation. The following frequently used settings groups are available: This element references a writeable fragment that is used to copy files in a Copy operation. Any number of reusable Fragments elements can be configured and are distinguished by YADE based on their name attribute. A subsequent fragment reference element points to the fragment that is used as target in the Copy operation. This element references the fragment that is used for an FTP file transfer operation. Any number of reusable FTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPFragment element. This attribute identifies the fragment that is used for the FTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable FTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPSFragment element. This attribute identifies the fragment that is used for the FTPS protocol. This element references the fragment that is used for an HTTP file transfer operation. Any number of reusable HTTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPFragment element. This attribute identifies the fragment that is used for the HTTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable HTTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPSFragment element. This attribute identifies the fragment that is used for the HTTPS protocol. A local target is considered to be located on the server where the YADE Client is operated, i.e. in the local file system. This element references the fragment that is used for an SFTP file transfer operation. Any number of reusable SFTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SFTPFragment element. This attribute identifies the fragment that is used for the SFTP protocol. This element references the fragment that is used for an SMB file transfer operation. Any number of reusable SMBFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SMBFragment element. This attribute identifies the fragment that is used for the SMB protocol. This element references the fragment that is used for an WebDAV file transfer operation. Any number of reusable WebDAVFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the WebDAVFragment element. This attribute identifies the fragment that is used for the WebDAV protocol. Alternative fragements can be specified as a replacement for existing file transfer fragments in case that a connection cannot be established with those fragments. Alternative fragments can be specified from a range of protocol fragments for use with the source or target of a file transfer operation that required modifying files. For each fragment type depending on the file transfer protocol in use an alternative fragment type is available. This element references the fragment that is used for an FTP file transfer operation. Any number of reusable FTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPFragment element. This attribute identifies the fragment that is used for the FTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable FTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the FTPSFragment element. This attribute identifies the fragment that is used for the FTPS protocol. This element references the fragment that is used for an HTTP file transfer operation. Any number of reusable HTTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPFragment element. This attribute identifies the fragment that is used for the HTTP protocol. This element references the fragment that is used for an FTPS file transfer operation. Any number of reusable HTTPSFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the HTTPSFragment element. This attribute identifies the fragment that is used for the HTTPS protocol. A local target is considered to be located on the server where the YADE Client is operated, i.e. in the local file system. This element references the fragment that is used for an SFTP file transfer operation. Any number of reusable SFTPFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SFTPFragment element. This attribute identifies the fragment that is used for the SFTP protocol. This element references the fragment that is used for an SMB file transfer operation. Any number of reusable SMBFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the SMBFragment element. This attribute identifies the fragment that is used for the SMB protocol. This element references the fragment that is used for an WebDAV file transfer operation. Any number of reusable WebDAVFragment elements can be configured and are distinguished by YADE based on their name attribute. The reference to a fragment is based on the value of the ref attribute of this element to the corresponding name attribute of the WebDAVFragment element. This attribute identifies the fragment that is used for the WebDAV protocol. This parameter is used to specify a directory on one of the involved servers. Directories can be adressed using a folder structure, e.g. /folder1/folder2. For Windows systems when used with the LocalSource parameter then a Windows path including a drive letter can be specified. For all server systems the standard syntax using can be used which includes forward slashes to separate folder names. The directory can be set absolute or relative to the working directory, where the working directory depends on the server configuration. If for example a user "test" connects to an SFTP server then this user might have /home/test/ as a working directory. This applies to servers that use the home directory as the working directory. In this case you can use relative and absolute adressing as in This parameter is used to specify a directory on one of the involved servers. Directories can be adressed using a folder structure, e.g. /folder1/folder2. For Windows systems when used with the LocalSource parameter then a Windows path including a drive letter can be specified. For all server systems the standard syntax using can be used which includes forward slashes to separate folder names. The directory can be set absolute or relative to the working directory, where the working directory depends on the server configuration. If for example a user "test" connects to an SFTP server then this user might have /home/test/ as a working directory. This applies to servers that use the home directory as the working directory. In this case you can use relative and absolute adressing as in These options apply to files on a target server. They specify e.g. the Atomicity of a file transfer for Copy and Move operations. This parameter specifies wether the content of a source file should be appended to the target file, should the target file exist. If AppendFiles is specified with the value "true" then the parameter DisableOverwriteFiles will be ignored. This parameter specifies that after transfer of each file to a target server YADE will try to read the file from the target server and compare the number of bytes of the original file on the source server and the file on the target server. This option determines whether the individual files from the results list should be transferred individually and then should be cumulated (i.e. concatenated into a single file) to the transfer target. The name of the cumulative file is specified using the CumulativeFilename parameter. The CumulativeFileSeparator parameter is used to specify a string that is added to the target file, between the individual files in order to allow these files to be separated later on. Should the source files be deleted after transfer then the Move operation can be used. This parameter specifies whether or not the content of the source files should be compressed for the target files using a zip algorithm. In case of sending files each file will be compressed in a single zip file. The extension of the filename is configured with the parameter CompressedFileExtension. A gzip-compatible compression is used, no further software components are required. The following parameters are ignored should CompressFiles be used: This parameter causes a checksum file to be created on the target server that contains the integrity hash value. The file name is created by using the target file name and adding the hash algorithm as an extension, e.g. a target file "myFiles.tar.gz" will cause the integrity hash file "myFiles.tar.gz.md5" to be created when using MD5 with the HashAlgorithm parameter. This parameter specifies that YADE will try to assign the modification date of the source file to the target file. This functionality makes use of commands that are specific for the file transfer protocol, e.g. FTP, SFTP, and is therefore not available for all protocols. In addition server side settings might restrict the use of such commands. This parameter specifies that YADE will try to create the directory on the target server that is specified with the Directory parameter should this directory not exist. This parameter has no effect on the subfolders during a recursive transfer. Subfolders of recursive transfer are always created if they do not exist. This functionality makes use of commands that are specific for the file transfer protocol, e.g. FTP, SFTP, and is therefore not available for all protocols. Please consider that server side settings might restrict the use of such commands. This parameter specifies whether existing target files can be overwritten in a file transfer. Transfer options specify the optional behavior of file transfer, e.g. the transactional behavior. The maximum size of a data block is defined with this option. This parameter specifies whether a transfer should be processed within a single transaction, i.e. either all objects are successfully transferred or none. Should an error occur during a transfer operation then all transfers will be rolled back. When specifying the value true then the following applies: To control reconnect behavior, the YADE has two options: Sets for each single file transfer the number of reconnection attempts if there is a connection failure. This option specifies the wait interval between attempts. Possible values: Combined values (with blank as separator):
Copy
Element
Type
Required
Description
CopySource
Required
Notes
CopySourceFragmentRef
[ReadableFragmentRefType]
Required
ReadableFragmentRefType / FTPFragmentRef
Required
Notes
ReadableFragmentRefType / FTPSFragmentRef
Required
Notes
ReadableFragmentRefType / HTTPFragmentRef
Required
Notes
ReadableFragmentRefType / HTTPSFragmentRef
Required
Notes
ReadableFragmentRefType / LocalSource
Required
Notes
ReadableFragmentRefType / SFTPFragmentRef
Required
Notes
ReadableFragmentRefType / SMBFragmentRef
Required
Notes
ReadableFragmentRefType / WebDAVFragmentRef
Required
Notes
AlternativeCopySourceFragmentRef
Optional
FTPFragmentRef
Required
Notes
FTPSFragmentRef
Required
Notes
HTTPFragmentRef
Required
Notes
HTTPSFragmentRef
Required
Notes
LocalSource
Required
Notes
SFTPFragmentRef
Required
Notes
SMBFragmentRef
Required
Notes
WebDAVFragmentRef
Required
Notes
Directory
string
Optional
as values for the Directory parameter.
SourceFileOptions
Required
Notes
Selection
Required
CheckSteadyState
Optional
Notes
Directives
Optional
Notes
Polling
Optional
ResultSet
Optional
MaxFiles
int
Optional
CheckIntegrityHash
Optional
Notes
CopyTarget
Required
Notes
CopyTargetFragmentRef
[WriteableFragmentRefType]
Required
WriteableFragmentRefType / FTPFragmentRef
Required
Notes
WriteableFragmentRefType / FTPSFragmentRef
Required
Notes
WriteableFragmentRefType / HTTPFragmentRef
Required
Notes
WriteableFragmentRefType / HTTPSFragmentRef
Required
Notes
WriteableFragmentRefType / LocalTarget
Required
Notes
WriteableFragmentRefType / SFTPFragmentRef
Required
Notes
WriteableFragmentRefType / SMBFragmentRef
Required
Notes
WriteableFragmentRefType / WebDAVFragmentRef
Required
Notes
AlternativeCopyTargetFragmentRef
Optional
FTPFragmentRef
Required
Notes
FTPSFragmentRef
Required
Notes
HTTPFragmentRef
Required
Notes
HTTPSFragmentRef
Required
Notes
LocalTarget
Required
Notes
SFTPFragmentRef
Required
Notes
SMBFragmentRef
Required
Notes
WebDAVFragmentRef
Required
Notes
Directory
string
Optional
as values for the Directory parameter.
Directory
string
Required
as values for the Directory parameter.
TargetFileOptions
Optional
Notes
AppendFiles
boolean
Optional
Notes
Atomicity
[AtomicityType]
Optional
CheckSize
boolean
Optional
Notes
CumulateFiles
Optional
Notes
CompressFiles
Optional
Notes
CreateIntegrityHashFile
Optional
Notes
KeepModificationDate
boolean
Optional
Notes
DisableMakeDirectories
boolean
Optional
Notes
DisableOverwriteFiles
boolean
Optional
Notes
TransferOptions
Optional
Notes
BufferSize
int
Optional
Notes
Transactional
boolean
Optional
Notes
RetryOnConnectionError
Optional
Notes
RetryCountMax
int
Required
Notes
RetryInterval
string
Optional
Notes
References Notes
References
References Notes
References
References
References
References
References
References
References
References
References Notes
References
References
References
References
References
References
References
References
References Notes
References
References Notes
References
References
References Notes
References Notes
References
References
References Notes
References
References
References
References
References
References
References
References
References Notes
References
References
References
References
References
References
References
References
References Notes
References Notes
References
References
References
References
References
References
References
References
References
References
References
References
References
References
References
Overview
Content Tools