Introduction
JS7 offers to manage file transfer configurations, see JS7 - File Transfer.
- Instead of managing the file transfer configuration from the JOC Cockpit GUI some users might prefer
- to manage the XML configuration for file transfers externally, for example from a repository,
- to generate the XML configuration based on input from sources such as a database,
- to deploy the file transfer configuration within the scope of an automated CI/CD pipeline.
- The JS7 offers the JS7 - REST Web Service API to perform such operations
- A simplified wrapper for the REST Web Service is available from the JS7 - PowerShell Module
- Below examples make use of the JS7 PowerShell Module. Running the examples with the
-debug
switch logs the respective requests that can easily be integrated with individual REST Clients.
Configuration Format
The file transfer configuration format is XML For details about the format see YADE - Reference Documentation - XSD Schema Reference.
Examples
Get list of available File Transfer configurations
The PowerShell CLI 2.0 - Cmdlets - Get-JS7FileTransferItem cmdlet can be used without further arguments to return the list of available file transfer configurations.
The name of a file transfer configuration is used for the subtab in the JOC Cockpit Configuration view.
$yadeConfigItems = Get-JS7FileTransferItem foreach( $yadeConfigItem in $yadeConfigItems ) { Write-Output $yadeConfigItem.name }
Read File Transfer configuration
The PowerShell CLI 2.0 - Cmdlets - Get-JS7FileTransferItem cmdlet can be used with the -Name
argument to return the respective file transfer configuration in XML format.
The resulting XML object can be used to navigate using respective DOM methods.
[xml] $yadeConfig = Get-JS7FileTransferItem -Name primaryAgent Write-Output $yadeConfig.Configurations.Fragments.ProtocolFragments
Store File Transfer configuration
The PowerShell CLI 2.0 - Cmdlets - Set-JS7FileTransferItem cmdlet can be used with the -Name
and -Configuration
arguments to add or to update a file transfer configuration with the JOC Cockpit inventory.
- The
-Name
argument specifies the name of the file transfer configuration. - The
-Configuration
argument specifies an XML object that holds the respective file transfer configuration in XML format. - The below example makes use of an empty configuration, for available XML elements see
[xml] $xml = '<?xml version="1.0" encoding="UTF-8" standalone="no" ?><Configurations/>' Set-JS7FileTransferItem -Name sample21 -Configuration $xml
Remove File Transfer configuration
The PowerShell CLI 2.0 - Cmdlets - Remove-JS7FileTransferItem cmdlet can be used with the -Name
argument to remove an individual file transfer configuration from the JOC Cockpit inventory.
Remove-JS7FileTransferItem -Name sample21