Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Interim save

...

Optional child elements can be listed by right-clicking on an element and then selecting the required child from the list of available options as shown in the next screenshot.:

A Simple Configuration

The next screenshot shows a completed configuration that will download a series of files from our online test FTP server and write them to the local file system.

...

The structure of the configuration is described in more detail in the JADE User Manual - Configuring and Running File Transfers article and its child articles.

Saving the configuration

The configuration is saved in the standard way by clicking on the diskette symbol in the upper left menu or by using a right click on the configuration Edit1 tab.

This causes the configuration to be saved by default in the following formats:

  • the XML format that will become the new standard for JADE with release 1.11,
  • the settings.ini format that will that will remain standard until release 1.11.

More information about the change of formats can be found in the JADE User Manual - Configuration Formats & Tools article.

The following code boxes show the simple configuration described above in XML and in settings.ini formats:

Code Block
titleSimple file transfer configuration in XML format
collapsetrue
<?xml version="1.0" encoding="utf-8"?>
<Configurations>
  <Fragments>
    <ProtocolFragments>
      <FTPFragment name="ftp_demo_sos-berlin">
        <BasicConnection>
          <Hostname><![CDATA[test.sos-berlin.com]]></Hostname>
        </BasicConnection>
        <BasicAuthentication>
          <Account><![CDATA[demo]]></Account>
          <Password><![CDATA[demo]]></Password>
        </BasicAuthentication>
      </FTPFragment>
    </ProtocolFragments>
  </Fragments>
  <Profiles>
    <Profile profile_id="ftp_server_2_local">
      <Operation>
        <Copy>
          <CopySource>
            <CopySourceFragmentRef>
              <FTPFragmentRef ref="ftp_demo_sos-berlin" />
            </CopySourceFragmentRef>
            <SourceFileOptions>
              <Selection>
                <FilePathSelection>
                  <FilePath><![CDATA[/]]></FilePath>
                </FilePathSelection>
              </Selection>
            </SourceFileOptions>
          </CopySource>
          <CopyTarget>
            <CopyTargetFragmentRef>
              <LocalTarget />
            </CopyTargetFragmentRef>
            <Directory><![CDATA[C:\Users\aa\jade_demo\a]]></Directory>
          </CopyTarget>
        </Copy>
      </Operation>
    </Profile>
  </Profiles>
</Configurations>
Code Block
titleSimple file transfer configuration in settings.ini format
collapsetrue
 [protocol_fragment_ftp@ftp_demo_sos-berlin]
protocol                            = ftp

host                                = test.sos-berlin.com
user                                = demo
password                            = demo

[ftp_server_2_local]
operation                           = copy

source_include                      = protocol_fragment_ftp@ftp_demo_sos-berlin
file_path                           = /

target_protocol                     = local
target_dir                          = C:\Users\aa\jade_demo\a
Automatic Configuration Validation

Note that during saving the XML Editor automatically validates the configuration

...

against the Schema and highlights errors.

Running the configuration

The simple configuration described above is started from the command line or in a batch file on Windows systems using one of the following calls:

Code Block
titleRunning the file transfer XML configuration on Windows format
jade.cmd -settings="sos-berlin_demo_2_local.xml" -profile="ftp_server_2_local"
Code Block
titleRunning the file transfer settings.ini configuration on Windows format
jade.cmd -settings="sos-berlin_demo_2_local.ini" -profile="ftp_server_2_local"

 

More information including example calls for Unix systems can be found in the JADE User Manual - Configuring and Running File Transfers article.

Saving the configuration

Running the configuration

Running the configuration