Skip to main content

XTM Connect – Adobe Experience Manager

In AEM Guides

Adobe Experience Manager Guides (referred to as AEM Guides later in this documentation) is a powerful enterprise-grade component content management solution (CCMS). It implements native DITA support in Adobe Experience Manager (AEM), enabling AEM to handle DITA-based content creation and delivery.

AEM Guides can be seen as a filterable content list. Combined with XTM Cloud connector, it provides a convenient, easy way to send DITA content for translation:

  • You can select an Adobe Experience Manager map and add it to a translation project. (In this context, a map is a container, used to add and organize information in a hierarchical structure. DITA content is structured in maps.). This content can be multilingual.

  • All translatable sub-components (content) in the map (other maps, topics, and so on) are then included in that translation project, and automatically sent for translation.

To send DITA content for translation in XTM Cloud, from AEM Guides:
  1. In AEM Assets, create empty target language folders for the content that you want to send for translation. For each target language folder "name", enter the appropriate language locale code. Enter whatever "title" you want.

    Note

    You only need to create empty target language folders if they are not already present. It is necessary to create these empty target language folders in Adobe Assets because they will be needed in step 6. below.

  2. In AEM Guides, access the Repository view.

  3. In it, browse through the DITA structures to find the map whose contents you want to translate.

  4. Double-click the map name to open it.

  5. Select the Manage tab. The title of the navigation panel on the left is Translation. You are prompted to Select the language to see the latest status of the translated copies.

  6. In the Translation panel, select one or more languages. To do so, select the checkbox next to their name. Only languages for which a folder already exists are displayed for selection. (This was the reason for creating the required folders in step 1., if they were not already present.)

  7. Select the Apply button. A list of all maps and their component maps/topics/media is displayed in a filterable list, along with metadata such as current statuses and versions. This list is a very convenient way to select and manage translatable or translated content. If required, use the TRANSLATION FILTERS options to find specific content. At this point, most all of the language copies for the selected map have the TRANSLATION STATUS "Missing Copy", but they will be created when they have been sent for translation.

  8. Select the required items. If the currently selected map is a parent map that contains other maps, you can select items from those maps too.

  9. Select the Send for Translation button in the top right-hand corner of the screen. A popup containing your translation project options is displayed.

  10. In the Submit for translation field, select the required project creation option, Example: Create a new translation project.

  11. In the Project title field, select the required project name.

  12. Select Submit. The project is then created instantly and sent for translation automatically. In the project overview screen, each language-specific Translation Job has the Status "Committed for translation".

    Note

    If the Translation Job Status is Committed for translation, but an Error panel below has the warning Failed to start translation, you should check the project's Translation Project Properties and then create a new project with the correct configuration.

    Tip

    Leave the screen containing the Translation Job Status open so that you can return to it easily when you have checked the Translation Project Properties.