Integrating translation jobs with SDL World Server

This tutorial explains how to configure an integration with SDL WorldServer.

Set the deploymentName variable

First set the deploymentName variable.

$deploymentName="InfoShare"

Create mappings between SDL World Server locales and Content Manager languages

As SDL World Server and SDL Tridion Docs Content Manager use different identifiers for the languages, we need to create a mapping.

Use the New-ISHIntegrationWorldServerMapping cmdlet to create one mapping. Add multiple mappings into an array to describe all the necessary mappings.

For example:

# Create an array of mappings

$mappings=@(
    New-ISHIntegrationWorldServerMapping -ISHLanguage en -WSLocaleID 1145
    New-ISHIntegrationWorldServerMapping -ISHLanguage nl -WSLocaleID 1147
    New-ISHIntegrationWorldServerMapping -ISHLanguage fr -WSLocaleID 1146
    New-ISHIntegrationWorldServerMapping -ISHLanguage fo -WSLocaleID 1161
    New-ISHIntegrationWorldServerMapping -ISHLanguage it -WSLocaleID 1162
    New-ISHIntegrationWorldServerMapping -ISHLanguage es -WSLocaleID 1163
    New-ISHIntegrationWorldServerMapping -ISHLanguage pt -WSLocaleID 1164
    New-ISHIntegrationWorldServerMapping -ISHLanguage ru -WSLocaleID 1165
    New-ISHIntegrationWorldServerMapping -ISHLanguage zh -WSLocaleID 1166
    New-ISHIntegrationWorldServerMapping -ISHLanguage ja -WSLocaleID 1167
    New-ISHIntegrationWorldServerMapping -ISHLanguage de -WSLocaleID 1168
    New-ISHIntegrationWorldServerMapping -ISHLanguage ar -WSLocaleID 1170
    New-ISHIntegrationWorldServerMapping -ISHLanguage fi -WSLocaleID 1171
    New-ISHIntegrationWorldServerMapping -ISHLanguage no -WSLocaleID 1172
)

Configure the integration with SDL WorldServer

To configure the integration with SDL WorldServer, use the Set-ISHIntegrationWorldServer cmdlet. The integration requires the following information:

• The URI for WorldServer's service.
• The credentials to access the WorldServer service.
• The mapping configuration created above.

Note: The optional parameter -MaximumJobSize corresponds to the parameter "externalJobMaxTotalUncompressedSizeBytes" from the WorldServer configuration section.

# Uri and credentials for SDL World Server
$uri="http://worldserver.example.com:8080/ws/services"
$credential=Get-Credential -Message "SDL WorldServer integration credential" 

# Set the integration
Set-ISHIntegrationWorldServer -ISHDeployment $deploymentName -Name WorldServer -Uri $uri -Credential $credential -Mappings $mappings

Note: Content Manager requires that only one connector for SDL WorldServer is configured.

Remove the integration with SDL WorldServer

Use Remove-ISHIntegrationWorldServer -ISHDeployment $deploymentName.