Table of Contents |
---|
Overview
File transfer parameters in JADE YADE are defined hierarchically and are sorted into two branches - Profiles and Fragments. A Profile specifies what is to be done (e.g. copy from A to B) and the Fragment defines how this is to be done (e.g. using Protocol protocol X, authentication Y, etc.).
Fragments (see the link to the relevant section of this manual at the foot of this article) are generally configured before Profiles. The The considerations necessary for defining the Profile branch of the configuration are described in this article.
How to generate the Profile configuration
The diagram below shows the minimum parameter hierarchy (i.e. without optional parameters) required to specify a file transfer from a remote source per FTP protocol to the local file system.
When the SOS XML Editor is used to generate the configuration you will be guided using the Add child button to insert valid elements starting with the Profiles element and proceed down the hierarchy.
Note that the links behind each parameter element name in the diagram lead to the Parameter Reference page for Documentation for that element, which provides detailed information about the parameter.
- Profiles
- Profile (profile_id= 'p1')
- Operation
- Copy
- CopySource
- CopySourceFragmentRef
- FTPFragmentRef (Has the ref Attribute attribute which specifies the source ProtocolFragment)
- SourceFileOptions (optional)
- CopySourceFragmentRef
- CopyTarget
- CopyTargetFragmentRef
- LocalTarget (A ProtocolFragment does not need to be defined here as the target is the local file system)
- Directory
- CopyTargetFragmentRef
- CopySource
- Copy
- Operation
- Profile (profile_id= 'p2')
- etc....
- Profile (profile_id= 'p1')
Each individual file transfer is headed up by a Profile, which is added as a child of the Profiles element.
The individual parameters that have to be specified in the Profile are as follows:
- The Profile requires a 'profile_id' which is used to call the profile when the transfer is called from the command line.
- Each Profile element is required to have an Operation element.
Note that the Operation specified defines subsequent descencent - descendant elements. For example, a Rename operation will require a different descendants to a Move operation. See the YADE User Manual - The Operation - What is to be done? article for more information.
- In the example, a Copy operation is specified, which, in turn, requires that CopySource and CopyTarget elements are set.
- The CopySource element has two child elements:
- a CopySourceFragmentRef element, which is required. This element in turn requires an FTPFragmentRef element, which contains the reference specifying the ProtocolFragment protocol fragment element. The ProtocolFragment The protocol fragment then specifies the transfer connection parameters such as authentication, protocol, etc.
- Note that the FragmentRef element (FTPFragmentRef), which is used to specify the ProtocolFragment fragment element, is protocol-specific. This allows optional pre- and post-processing child elements - which are not shown in the diagram hierarchy - to be added to the profile as child elements of the FTPFragmentRef element. Such elements are protocol-specific.
- a SourceFileOptions element which is also required - together with the Selection element - can be optionally and is used to specify a range of parameters related to aspects of file selection.
- a CopySourceFragmentRef element, which is required. This element in turn requires an FTPFragmentRef element, which contains the reference specifying the ProtocolFragment protocol fragment element. The ProtocolFragment The protocol fragment then specifies the transfer connection parameters such as authentication, protocol, etc.
- The CopyTarget element does not need a corresponding FTPFragmentRef child element as the target is the local file system. However, the LocalTarget element must be specified.
- The Directory element is used to specify a target directory if a directory other than the user's rood root directory is requiredused.
Calling Profile Elements
A Profile is specified by its 'profile_id' attribute attribute, which is used to call the profile when the transfer is called from the command line.
An example showing the YADE command line call syntax can be seen in the Configuring and Running File Transfers article.
Note
Status | ||||
---|---|---|---|---|
|
The following optional elements can be specified as children of the Profiles element, alongside the Operation elements:
Further Information
Related Sections of this User Manual:
- YADE User Manual - Configuration Formats & Tools
- YADE User Manual - Configuring and Running File Transfers
- YADE User Manual - Configuration 1 - An Overview
- YADE User Manual - Configuration 2 - The Fragments Branch
- YADE User Manual - Configuration 3 - The Profile Branch (this page)
Other documents
- The use of the Operations element - the only Profiles child element whose use is required - is described in the Operation section of this manual.
- Client:
- JobScheduler:
- Notifications:
- CredentialStore: