Introduction
Use of the JADE Client will be significantly changed with the introduction of an XSD schema and XML configuration files with version 1.11. The use of the schema is intended to simplify file transfer configuration for the Client - particularly for complex file transfer situations.
File transfer configurations specified for Client versions up to 1.10.x will need to be modified before they can be run with versions 1.11 onwards.
The schema takes account of interdependencies and incompatibilities between parameters and therefore significantly reduces the chances for configuration errors.
The schema uses a standardized parameter syntax and the majority of parameter names will be changed to a greater or lesser degree with its introduction.
A graphical editor is available that will generate XML file transfer configuration files for the JADE Client.
A parameter mapping is available for users wishing to compare settings file and XML file transfer configurations.ADD LINK
File transfer configuration up to Version 1.10.x
File transfer configurations are stored in a settings.ini file.
Individual parameters are grouped together in profiles that can be reused and allow a 'single point of definition' approach to be followed.
Parameters that can be defined separately for the source and target parts of the transfer - for example, the host name and port number - are set with the source_ and target_ prefixes.
This is illustrated in the following example profile:
[ftp_server_2_local]
;;
operation = copy
;;
source_host = test.sos-berlin.com
source_protocol = ftp
source_port = 21
source_user = demo
source_password = demo
source_dir = /
;;
target_host = localhost
target_protocol = local
target_dir = ${USERPROFILE}\jade_demo\a
Detailed descriptions of the parameter configuration and the use of profiles is available in our JADE Tutorials. These include examples that can be tested using our test FTP and SFTP servers. A download containing a configuration file for the tutorial examples is also available.
File transfer configuration from Version 1.11 onwards
The XML schema that will be introduced with version 1.11 of JADE will allow parameter dependencies in JADE to be checked before transfer configurations are tested.
An XML editor is available that will simplify the creation and validation of schema-compatible file transfer configurations.
The basic principles behind the organization of the schema and parameters will be described in this document. A detailed description of individual parameters can be found in our Parameter Reference.
The following code block shows the same test host FTP file transfer example described in the previous section in XML form and ready for use in version 1.11 of the JADE Client.
Although longer and seemingly more complex than the settings file configuration version shown above, this example was produced using the graphical editor and therefore has been validated against the JADE Client XSD Schema. It is error and conflict free.
<?xml version="1.0" encoding="UTF-8"?>
<Configurations>
<Fragments>
<ProtocolFragments>
<FTPFragment name="test.sos-berlin.com">
<BasicAuthentication>
<Account><![CDATA[demo]]></Account>
<Password><![CDATA[demo]]></Password>
</BasicAuthentication>
<BasicConnection>
<Hostname><![CDATA[test.sos-berlin.com]]></Hostname>
<Port><![CDATA[21]]></Port>
</BasicConnection>
</FTPFragment>
</ProtocolFragments>
</Fragments>
<Profiles>
<Profile profile_id="ftp_server_2_local">
<Operation>
<Copy>
<CopySource>
<CopySourceFragmentRef>
<FTPFragmentRef ref="test.sos-berlin.com" />
</CopySourceFragmentRef>
<SourceFileOptions>
<Selection>
<FilePathSelection>
<FilePath><![CDATA[/]]></FilePath>
</FilePathSelection>
</Selection>
</SourceFileOptions>
</CopySource>
<CopyTarget>
<CopyTargetFragmentRef>
<LocalTarget />
</CopyTargetFragmentRef>
<Directory><![CDATA[${USERPROFILE}\jade_demo\a]]></Directory>
</CopyTarget>
</Copy>
</Operation>
</Profile>
</Profiles>
</Configurations>
Pages
Navigation