Introduction
Profiles form the starting points for specifying file transfers, with a Profile being specified each time a command is sent to JADE to start a file transfer operation.
...
The subject of this page is the basic principles lying behind this two-stage configuration procedure.
Configuration Elements in the JADE Schema
In the XSD Schema used to structure the JADE configuration parameters, the Profiles element, which is the parent of all individual Profile elements, lies at the top of one of the three major branches in the configuration, alongside the Fragments and General branches. This hierarchy is shown schematically below:
...
This two-stage configuration procedure allows a flexibility not possible with a single XML hierarchy and, in particular, allows elements to be reused.
What is a Profile Element?
A Profile can be seen as a specification of what is to be done and contains hierarchical information about:
...
Any number of profiles can be specified within a file transfer configuration.
What is a ProtocolFragment Element?
ProtocolFragment elements can be seen as a specification of how the file transfer is to be carried out. Each file transfer Profile contains a reference calling at least one ProtocolFragment.
...
ProtocolFragment elements can be reused - i.e. a ProtocolFragment can be referenced from any number of profiles.
Configuration Procedure
Whilst Profiles form the starting points when running a file transfer command, with the ProtocolFragments then being called from within a Profile Element, the configuration procedure is usually carried out in the reverse order: The necessary ProtocolFragments are configured first, before the Profile elements which call these fragments are specified.
Referencing Profiles and ProtocolFragments
Both Profiles and ProfileFragments can be seen as predefined file transfer specifications that are called up as required:
...
See Running File Transfers with the JADE Client for an example of how to call a Profile.
Configuring File Transfers with the SOS XML Editor
We recommend that you use the SOS XML Editor to generate your whole configuration file. The editor effectively functions like a wizard: due to the use of the JADE XSD schema in the editor, you will be effectively guided through the configuration process and end up with a validated configuration that you can implement as required.
General Comments
The advantage of this approach - which may at first seen somewhat complex - is that:
...
A Fragment can be used as both a source or as a target within the one Configuration.
Further Information
- The use of the Operations element - the only Profiles child element whose use is required - is described in the Operation Element section of this manual.
- The Profile child elements are described in detail in the Profiles parameter reference.
...