You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Diagram

Unable to render 'XSD Viewer' macro

Could not find the given XSD (xsd_macro64b74ce33804436d65a68ae7081b00e7.png) on page (JADE Parameter Reference - MoveSource)

Elements

MoveSource
References Notes

This parameter specifies the source of a Move operation.

The following frequently used settings groups are available:

Element Type Required Description
MoveSourceFragmentRef [ReadableFragmentRefType]
  • Occurrence: 1
Required
References Notes

This element references a readable fragment that is used to move files in a Move 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 Move operation.

ReadableFragmentRefType / FTPFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the FTP protocol.

ReadableFragmentRefType / FTPSFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the FTPS protocol.

ReadableFragmentRefType / HTTPFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the HTTP protocol.

ReadableFragmentRefType / HTTPSFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the HTTPS protocol.

ReadableFragmentRefType / LocalSource
  • Occurrence: 1
Required
References Notes

A local source is considered to be located locally to the YADE Client, i.e. in the local file system.

ReadableFragmentRefType / SFTPFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the SFTP protocol.

ReadableFragmentRefType / SMBFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the SMB protocol.

ReadableFragmentRefType / WebDAVFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the WebDAV protocol.

AlternativeMoveSourceFragmentRef
  • Occurrence: 0..unbounded
Optional
References Notes

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.

FTPFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the FTP protocol.

FTPSFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the FTPS protocol.

HTTPFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the HTTP protocol.

HTTPSFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the HTTPS protocol.

LocalTarget
  • Occurrence: 1
Required
References Notes

A local target is considered to be located on the server where the YADE Client is operated, i.e. in the local file system.

SFTPFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the SFTP protocol.

SMBFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the SMB protocol.

WebDAVFragmentRef
  • Occurrence: 1
Required
References Notes

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.

ref

This attribute identifies the fragment that is used for the WebDAV protocol.

Directory string
  • Min: 1
  • Whitespace: preserve
  • Occurrence: 0..1
Optional
References Notes

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

  • data
  • /home/test/data
as values for the Directory parameter.
SourceFileOptions
  • Occurrence: 1
Required
References Notes

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.

CheckSteadyState
  • Occurrence: 0..1
Optional
References Notes

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
  • Occurrence: 0..1
Optional
References Notes

Directives are options that specify the behavior with specific file characteristics:

  • DisableErrorOnNoFilesFound: do not raise an error if no files are found on the source server
  • TransferZeroByteFiles: specify whether zero byte files should be transferred and processed by subsequent commands
MaxFiles int
  • Pattern: [\-+]?[0-9]+
  • Whitespace: collapse
  • Occurrence: 0..1
Optional
References Notes

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.

CheckIntegrityHash
  • Occurrence: 0..1
Optional
References Notes

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.

  • No labels