Connecting a Custom Machine Translation engine
Select Configuration > Settings > Translation.
Select the Machine translation tab.
In the MT engines section, select the Add custom MT button.
Result: The Add new custom MT popup is displayed.
In the Add new custom MT popup, fill the relevant fields:
Note
To customize the configuration parameters for the Custom Machine Translation:
To request support
Visit our Support Portal.
Table 32. Custom Machine Translation – default configuration parametersParameter
Description
Mandatory/Optional
Type
Valid values
Custom MT name
The preferred name of your custom Machine Translation engine.
Mandatory
Text field
Alphanumeric
Username
Your username in the custom Machine Translation engine.
Mandatory
Text field
Alphanumeric
Password
Your password to the custom Machine Translation engine.
Mandatory
Text field
Alphanumeric
Base URL
API service host.
Mandatory
Text field
Alphanumeric
Authentication endpoint
API authentication endpoint.
Mandatory
Text field
Alphanumeric
Translation endpoint
API request translation endpoint.
Mandatory
Text field
Alphanumeric
Batch size
XTM Cloud Administrator can customize the number of segments which will be sent in a single translation request.
Optional
Checkbox
Valid values:
Cleared (default).
When this checkbox is cleared, all file segments in a language combination, which meet the criteria selected in the General options section, will be sent to the MT engine in a single translation request.
Selected.
When you select this checkbox, the mandatory text field is displayed in which you specify the batch size.
The default value is 1.
Batch size value
XTM Cloud Administrator can specify the maximum number of segments which will be sent in a single translation request.
Mandatory when the Batch size checkbox is selected
Text field
Numeric
Default value is 1.
Check status endpoint
The API endpoint in which the status of the translation request is checked.
Mandatory
Text field
Alphanumeric
At intervals of seconds
Preferred time intervals at which the status has to be checked.
Mandatory
Text field
Numeric, in seconds
In progress status
Describes enums which may be returned by the MT service in response to the check status request to report the translation is still in progress. XTM Cloud will continue sending the check status request until MT service returns success or failure enum.
Optional
Text field
Alphanumeric
Default enums are:
IN_PROGRESS
QUEUED
Success status
Describes enums which may be returned by the MT service in response to the check status request to report the translation process has been successfully finished. XTM Cloud will stop the status checking process and proceed to the download translation step.
Optional
Text field
Alphanumeric
Default enum is: COMPLETED
Failure status
Describes enums which may be returned by the MT service in response to the check status request to report the error occurred or the translation process has been canceled. XTM Cloud will abandon the machine translation process for the batch.
Optional
Text field
Alphanumeric
Default enums are:
CANCELLED
ERROR
Download translation endpoint
API download translation endpoint.
Mandatory
Text field
Alphanumeric
Custom fields
Allows to select which custom fields will be sent in the requests header.
Optional
Multiple selection
Predefined values specified under Configuration > Data > Custom fields > Project custom fields by selecting the Custom MT checkbox. For details see Project custom fields.
Custom fields prefix
Defines prefix used for custom field names.
Optional
Text field
Alphanumeric
Select Add.
At the bottom of the page, select Save.
Result: The new MT engine is displayed in the Configuration > Settings > Translation > Machine Translation section.
Project Managers can enable or disable the Custom MT at customer level. They can also add the Custom MT to a new project while creating it, or to an existing one in the Project Editor. Additionally, they can enable or disable the Custom MT for the relevant project template(s).