CTSX Transperfect
Content management Incubator Version 4.1.2 Magnolia 6.3 compatible
The CTSX Transperfect module performs translations using the Transperfect APIs. Translations are handled asynchronously.
Installing with Maven
Maven is the easiest way to install the module. Add the following to your bundle:
| In order to start the translation process, please make sure that the core and apps modules in the CTSX Framework have already been installed. |
<dependency>
<groupId>info.magnolia.translation</groupId>
<artifactId>magnolia-content-translation-support-ext-translations-com</artifactId>
<version>4.1.2</version>
</dependency><dependency>
<groupId>com.translations.globallink</groupId>
<artifactId>globallink-connect-api</artifactId>
<version>4.18.4</version>
</dependency>Configuration
Configuration of the Transperfect service provider is handled in the module config. This provider should be configured with the following path:
modules
└── content-translation-support-ext-translations-com
└── config
├── translationProviders
│ └── transComProviderConfigFile.yaml
For users upgrading from version 4.0.0 to version 4.1.0, ensure you move your existing translation provider configuration to the correct path.
|
|
Use JCR for module configuration.
When using |
This provider can be configured with the following properties.
| Property | Description |
|---|---|
|
optional Translation agent name. |
|
optional , default is When true the content review process (workflow) is bypassed. |
|
required Definition class for the translator to be used. See |
|
required Identifies the configuration within Magnolia. |
|
required Number of days system continue to listen to GlobalLink PD (calculated from last modified date of a submission). |
|
optional The default configuration used by the system in the case of multiple translation services being used. |
|
required Enable or disable the configuration using this flag. |
|
required Depends on the version of GlobalLink PD you use. For version 5 use "Magnolia". For version 4 use "xliff". |
|
required Implementation class for interfacing with Transperfect. See |
|
only required in 3.4.10+ Id of the project setup with Transperfect. |
|
only required in 3.4.10+ This basic auth token is only used to get PD credential. You can get these credentials from a PD administrator. |
|
optional Prefix added to submitted documents. Example: |
|
optional, default is 840000 Download expiration time in milliseconds. Default to 14 minutes (840,000 ms). |
|
required Additional request headers to be sent on submission creation, configured as a content node of properties where the property key is the header name, and the property value is the header value. The
Example: |
|
required Tech tracking is a set of four key/value pairs that allow an integration to specify the following information: adaptorName - Name of the adaptor that created the submission adaptorVersion - Version of the adaptor clientVersion - Name and version of the client system technologyProduct - Code of the technology product that created the submission; please check with the GL Support team for the code of your specific technology product |
Sample configuration
4.1.0+'config':
'jcr:primaryType': 'mgnl:content'
'translationProviders':
'translationsComConfig':
'agentName': 'xxx'
'autoTranslationAllowed': 'false'
'class': 'info.magnolia.translation.ext.provider.translationscom.definition.TranslationsComProviderDefinition'
'configName': 'translations.com'
'daysListen': '1'
'defaultFlag': 'false'
'enabledFlag': 'true'
'fileFormat': 'xxx'
'implementationClass': 'info.magnolia.translation.ext.provider.translationscom.translator.TranslationsComRestTranslator'
'projectId': 'xxx'
'basicKey': 'xxx'
'submissionPrefix': 'xxx'
'url': 'xxx'
'headerParams':
'User-Agent': 'Magnolia 4.1.1 PROD'
'techTracking':
'adaptorName': 'xxx'
'adaptorVersion': 'xxx'
'clientVersion': 'xxx'
'technologyProduct': 'xxx'Usage
After registration and starting, the Content Translation Support Extended (CTSX) module will bind the Transperfect translator to Configuration field.
| You can test the connection to the translator api before using. |
How it works
Use the same steps outlined with CTSX Google Translator but you will choose Transperfect instead of Google.com in the Configuration.
| In additional, at the Step 2 after submitting the batch you must to wait for the response from Transperfect’s GlobalLink Project Director app (PD). |
| You would be able to see the Pulse notification for translation result as soon as the submission has been delivered on PD. |
