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.

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.

...

$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.

...

[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.

...

[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.

...