Configuring XTM Connect – Drupal as the translation provider
Translation providers, known in Drupal as "providers", are used to establish connections between Drupal and XTM Cloud. Multiple providers can be configured, to offer Translation requesters a choice of different XTM Cloud setups. Provider configuration is a crucial step in integrating Drupal and XTM Cloud.
Select the Translation tool bar button in the Home screen.
In the screen, select the Providers option.
You see the currently configured translation providers, in the Providers tab screen.
Select the + Add provider button. You see the Add Provider screen.
Make these settings:
UI label
Description
Label
Enter a short label text that identifies the translation provider.
Machine name
Enter a machine-readable name for this translation provider. It must be unique, and contain only alphanumeric characters and underscores. Once you create this value, you will not be able to change it!
Description
In the large text field, enter a description for this translation provider. This can be very detailed, if required.
Auto accept finished translations
Select this checkbox to omit the reviewing of translations when they are returned to Drupal, from XTM Cloud. All translations will automatically be accepted. They will then be published, making them available for Drupal users to see.
Provider plugin
XTM Connect – Drupal is implemented in Drupal as a plugin. Select XTM from the dropdown.
When you select XTM as the Provider plugin, a new XTM PLUGIN SETTINGS section, containing XTM Connect – Drupal-specific settings, is displayed. Make these settings:
UI label
Description
XTM API URL
Enter the URL of the XTM Cloud system that this instance of XTM Connect – Drupal will connect to.
Default XTM API URL for the Public Cloud server: https://api.xtm-cloud.com/project-manager-api/services/v2/projectmanager/XTMWebService?wsdl
If your XTM Cloud instance uses a different server, you must adjust the second component of the URL, after "https://", to direct to your server.
Example
If your XTM Cloud instance is using the soc2 server, your XTM API URL will be: https://soc2.xtm-cloud.com/project-manager-api/services/v2/projectmanager/XTMWebService?wsdl
XTM API Client name
Specify the name that the User must enter in the Company name field on the XTM Cloud login page. This is the Company's account name in XTM Cloud. The company must have API access to XTM Cloud enabled.
XTM API User ID
This is the User ID that the user enters to log in to the XTM Cloud API.
XTM API Password
Specify the string that the User who is identified by the User ID above must enter in the Password field on the XTM Cloud login page.
XTM project Customer ID
Specify the ID of the default XTM Cloud customer for which this instance of Drupal will be used. This XTM Cloud Customer is created in XTM Cloud.
Project name prefix
Specify a prefix that is to be inserted at the start of the names of translation projects. Later, this prefix will then be used to distinguish Drupal projects from other projects in XTM Cloud.
Prefix format: can contain a combination of numbers, small and capital letters, underscores, hyphens or special characters.
Maximum length: 128 characters.
Example
Drupal_2023_.
Default project mode section
Note
This setting only applies for multilingual translation projects. For details, see Translating multilingual content: end-to-end process.
In this section, select one of these options as the default setting for how source translation items are sent to XTM Cloud, for translation, and then returned to Drupal:
Single file: all source translation items are sent to XTM Cloud in a single XML file, and then returned to Drupal in a single file at the end of the project.
Multiple files: the content from each source translation item is sent to XTM Cloud in its own, separate XML file. As soon as each file is completed, it is returned to Drupal.
Multiple files: the content from each source translation item is sent to XTM Cloud in its own, separate XML file. No translations are returned to Drupal until every file is completed. Translations are then all returned at once in a batch, in their separate, individual files.
Translation requesters can change this setting when they sent a job for translation in the Cart tab screen.
Enable multilingual projects in XTM
By default, a separate project is created for translation into each target language. To enable creation of multilingual projects (single XTM Cloud projects containing all target languages, instead of individual projects containing individual target languages), select this checkbox.
If you do so, this will enable Translation requesters to request multilingual translation projects in the Cart tab screen.
Language mapping section
The languages configured in Drupal need to be mapped to the languages present in XTM Cloud. Do so in the languages list below the Enable multilingual projects in XTM checkbox. Each Drupal language is identified by its language short code.
For each language:Compare the Drupal language short code with the XTM Cloud language name listed in the dropdown field below it.
If they do not match your requirements, select the dropdown field to display available XTM Cloud languages.
Select the required XTM Cloud language.
Example
You see the Drupal language short code "de". Default XTM Cloud language: "German". (This means "German (Germany)".) Required XTM Cloud language: "German (Austria)". To set the required German language variant, select "German (Austria)" from the dropdown.
Connect button
To test the settings you have made, and make sure that the connection to XTM Cloud has been configured correctly, you can select this button.
If the connection is established correctly, a screen message is displayed to tell you. Continue making settings.
If the connection is not established correctly, a screen message is displayed to warn you. Check the settings you have made, and correct them. Then test the connection again.
Warning
Do not proceed until the connection is configured correctly and working properly.
To save your settings, once you have verified that the connection to XTM Cloud is working properly, select the Save button at the bottom of the screen.
Result: you have configured XTM Connect – Drupal as the translation provider for your instance of Drupal.