Translating content: end-to-end process
This topic outlines the steps involved in creating a single source/single target language translation project in Drupal and sending it to XTM Cloud. This information applies for all content types selected in your instance of Drupal.
Note
Single or multiple projects for multiple target languages?
By default, XTM Connect – Drupal creates projects for a single language combination. By default, if you send particular content to XTM Cloud, for translation into multiple target languages, that content will be sent in the form of multiple projects, each one for a different target language.
Alternatively, you can create individual multilingual projects in which the same source content is translated into multiple languages. For details, see Translating multilingual content: end-to-end process.
The process for creating translations in Drupal and sending them to XTM Cloud involves two plugins, both of which are installed in Drupal.
To enable any translation projects to be created in Drupal and sent to XTM Cloud, these requirements must be met:
TMGMT, the Drupal Translation Management Tool plugin, must be installed and configured in Drupal.
The XTM Connect – Drupal plugin must be installed and configured in Drupal.
In the XTM Connect – Drupal plugin, it is especially important to ensure that the languages defined in Drupal are mapped to the languages defined in XTM Cloud.
For more details about these plugins, see the Integration overview. For details about general system requirements, see System requirements.
To create a single source/single target language translation project, follow the steps below.
1. Creating or selecting content in Drupal
In Drupal, use the Content screen to create content for translation. You can also send existing content for translation. In Drupal, there are two places in which you can send content for translation:
Content screen (described in step 2. below) or
Sources tab screen in the Translation screen (described in step 3. below).
In both cases, the source language content item for which you request translation is then sent to the Cart, which is the Drupal translation projects queue (described in step 4. below).
2. Working in the Drupal Content screen
In the Content tab screen (unlike the Sources screen described below), you can only select one source language content item at a time, and send it for translation.
Select the Content button in the main tool bar at the top of the screen. In the Content screen, you see a list of existing content items.
In the content items list below the Apply to selected items button, select the source language content item that you want to send for translation. To do so, select the checkbox next to its item name, listed in the TITLE column.
If the content item you want to send for translation is not displayed, use the filters at the top of the Sources tab screen to find and display it. For more details, see Filtering content items (Sources tab screen).
If the content item you want to send for translation does not exist yet, create it. For details, see Content screen actions.
In the OPERATIONS column, on the right of the screen, select the down arrow on the action button in the line containing the content item you want to send for translation.
Select the Translate option. The Translate tab screen, containing settings for your translation, is displayed.
In the LANGUAGE column, select the target languages into which you want the selected content item to be translated. A separate translation job item will be created for each language.
Now decide how you want to send the new job items for translation:
To send the new job items to the translation queue, which is called the Cart, in the OPERATIONS box, select the Add to cart button. If you need to send several job items to a translation provider at the same time, it can be useful to send them to the Cart and then send them to the translation provider all at once, later. Alternatively, they will be sent to the translation provider next time the cron job runs.
In this case, go to Translating content: end-to-end process.
To identify the translation job containing your content item, enter a name in the Label field, if required.
Select the Submit to provider button at the bottom of the screen. The translation job containing the new job items is generated and sent to XTM Cloud for translation.
3. Working in the Drupal Sources tab screen in the Translation screen
If you have not selected content items for translation in the Content screen, you can do so in the Sources tab screen. There, (unlike in the Content screen described above), you can, if required, select multiple content items and send them for translation.
Select the Translation button in the main tool bar at the top of the screen.
In the Translation screen, select the Sources option. In the Sources tab screen, you see a list of existing content items.
In the content items list below the CHECKOUT box, select the content items you want to send for translation. To do so, select the checkbox next to each relevant item name, listed in the TITLE (IN SOURCE LANGUAGE) column.
If the content items you want to send for translation are not displayed, use the filters at the top of the Sources tab screen to find and display them. For more details, see Filtering content items (Sources tab screen).
If you have used the filter to find a set of items that you want to translate, you can select them all at the same time.
To do so, select the checkbox at the top of the screen, on the left, next to the TITLE (IN SOURCE LANGUAGE) column header.
If required, now choose which languages you want your content to be translated into. You can do so here or later, in the Cart.
In the CHECKOUT section, select one target language, or several, or all target languages, as required. The languages into which content has already been translated are marked with a green tick
. Untranslated content in particular languages is marked with a gray cross 
.All the possible translation statuses are listed at the bottom of the content items list, in this screen.
To select one or a few target languages (even if they have already been translated):
In the CHECKOUT section, select the Target Languages dropdown.
Select Multiple from the dropdown. All possible target languages (those configured in your instance of Drupal) are listed.
Select each required target language. To do so, select the checkbox next to its name.
Tip
If you want to select most of the listed languages, select Check all at the bottom of the languages list, and then deselect the individual languages that you do not require, if this will save you time.
If you need to start again, you can deselect all languages. To do so, select Uncheck all at the bottom of the languages list.
Once you have selected the target languages you require, go to step 5.
To select all target languages (even if they have already been translated):
In the CHECKOUT section, select the Target Languages dropdown.
Select All from the dropdown. All possible target languages (those configured in your instance of Drupal) are selected.
Once you have selected the target languages you require, go to step 5.
Now decide how you want to send the selected content items for translation:
To send them directly, in the OPERATIONS box, select the Request translation button. A translation job containing the selected content items is generated, and sent directly to the selected provider (XTM Cloud).
To send them to the translation queue, which is called the Cart, in the OPERATIONS box, select the Add to cart button. If you need to send several translation jobs to a translation provider at the same time, it can be useful to send them to the Cart and then send them to the translation provider all at once, later. Alternatively, they will be sent to the translation provider next time the cron job runs.
You can also select target languages for your translation job in the Cart, if you have not done so in the Sources tab screen.
4. Working in the Drupal Cart tab screen in the Translation screen
You can now create translation jobs for sending to their selected translation provider. To do so, follow the steps below, for each selected source content item that you want to send translation. If you select more than one content item, the project settings you make (described below) will apply for all of them. Alternatively, if required, create a single, combined multilingual project for a single content item. For details, see Translating multilingual content: end-to-end process
To display the Cart tab screen, select the Cart tab.
In the Cart tab screen, you see a list of existing translation jobs.
First specify whether an item's existing source language is not to be used as the source language for this translation. To do so, select the Enforce source language checkbox. Then use the Source language dropdown, which is displayed below it, to select a new source language for this translation. Your setting will apply for this translation, but not in future.
Now, if you have not already done so in the Sources tab screen, choose which languages you want your content to be translated into. You can select one target language, or several or all target languages, as required. Select target languages for your translation from the Request translation into language(s) dropdown:
To select one target language, click on it. It is displayed with a dark background.
To select several target languages that are listed next to each other, click on the top one. Hold down the Shift key on your keyboard and then click on the bottom one. The selected target languages are displayed with a dark background.
To select several target languages that are not listed next to each other, click on the top one. Hold down the Ctrl key on your keyboard and then click on the languages you require. Each selected target language is displayed with a dark background.
Sending translation jobs to their selected translation provider: if several translation jobs are listed in the Cart, you can send them to their selected translation provider manually, before the next cron runs. To do so, select the Request translation button at the bottom of the screen. The Creating multiple translations screen is briefly displayed.
When the translation job has been sent to XTM Cloud, this is confirmed in a screen message in the Cart tab screen.
If automatic start has been configured for the selected project template, in XTM Cloud, the individual jobs are sent directly from XTM Cloud to the relevant Linguists.
(In the XTM Cloud Project template editor, one of the settings for an XTM Cloud project template is the Automatically start the project checkbox in the Workflow tab screen.)
If automatic start has not been configured for the selected project template, in XTM Cloud, a Project Manager must create a workflow there, manually, to send the individual jobs to the relevant Linguists.
5. Optional: Viewing translation project details in the Drupal Jobs tab screen in the Translation screen
If required, now select the Jobs tab. You see the Job overview screen. It contains details about current translation projects. You can also filter, cancel or delete projects there.
6. Optional: Viewing or managing translation projects in XTM Cloud
You can send content for translation in XTM Cloud, from Drupal, and create or update your multilingual Drupal content, without ever logging in to XTM Cloud. However, if required, you can also use the functionality in XTM Cloud to view or manage your translation projects. To do so, log in to XTM Cloud.
When you go to XTM Cloud, you see the project in the Projects tab, in XTM Cloud. Its name (in the Name column) will vary, depending on how your instance of XTM Cloud is configured, but the name could, for example, start with the prefix defined in the Project name prefix setting in the XTM Connect – Drupal plugin configuration.
The translation jobs are sent to the Translators automatically. When they have translated them (in XTM Workbench), and the translation project is finished, the completed translations are returned to Drupal automatically. These translations are not returned instantly but at the interval set for cron jobs in the Administration settings, in Drupal.
7. The final stages: checking and reviewing the translated texts
You can now:
Result: you have selected website content in Drupal and sent it to XTM Cloud in a translation project, for translation. The finished translation project has been returned to Drupal. The translated content has been uploaded to the website. You have checked it and the finalized content is now ready for users to visit.