Localization with XTM

Heretto CCMS makes DITA maps localization easier for XTM International users.

Remember: You must use DITA maps and not standalone DITA topics to localize content with XTM.

Overview

Supported Content Types
XTM packages support only textual content and cannot include any media files.
Tip: If you want to localize media files, you need to use a media package. Reach out to your XTM representative for recommendations on how to manage media files in XTM. For more information, see Localization with a Media Package.
Visual Editor
XTM provides a visual editor, which enables you to preview content in a similar layout to the final publication.

To set up the visual editor, XTM may ask you to provide an XSLT file to use for your preferred rendering of the content in the visual editor.

Send Content to XTM for Localization

Create an XTM Package in Heretto CCMS, which can be sent directly from Heretto CCMS to XTM for localization.

To localize content using XTM packages, you must have an XTM International account.
Note: Integrating your Heretto CCMS instance with XTM International requires initial configuration. For more information, contact a Heretto Customer Success Manager.
Remember: You must use DITA maps and not standalone DITA topics to localize content with XTM.
  1. In the content library, click the map you want to localize.

    On the right side of the screen, the Resource Details Drawer appears.

  2. Create a localization package for a map by doing on of the following:
    OptionDescription

    Recommended: Create a localization package for a released map

    1. In the Resource Details Drawer, select Releases .

    2. In the Releases tab, go to the release you want to localize and click Localize.

    Create a localization package for a branched map

    1. In the Resource Details Drawer, select Branches. You will see the list of branches related to your map.

    2. In the Branching tab, switch to the branch that contains the map you want to localize.

    3. The Branching tab closes and you are back in the content library. Click the map for which you want to localize content.

    4. In the Resource Details Drawer on the right of the screen, select the Jobs Tab.

    Create a localization package for a standard map

    In the Resource Details Drawer, select the Jobs Tab.

  3. Click the Create Localization Job Button.
  4. Configure the XTM localization package by completing the following steps:
    1. In the Job Type drop-down menu, select XTM Package.
    2. In the Manager drop-down menu, choose the person you want this project to be assigned to.
    3. Click the Locales field and select as many locales as you want.
    4. Click Due Date field and select the date when you want the action to be completed.
    5. In the Include drop-down menu. select the resources you want to send for translation.
    6. In the Customer drop-down menu , select the customer you want to assign the localization job to.
      The Localization Services Provider (LSP) who will be performing the localization work in XTM, or other Customer association as you've set it up in XTM.
    7. In the Template drop-down menu, select the project template you want to use for the localization job.
      The XTM project template for the localization job to follow, this may include things such as the workflow steps and assigned linguists.
    XTM start project menu
  5. Click the Create Button.
  6. In the Jobs Tab , click the file you want to send for localization.
  7. Click Send Project to XTM.

Your localization job is created and a workflow initiated at XTM.

Retrieve Localized Content from XTM

Once the localization process is completed using XTM software, you must retrieve the localized content into Heretto CCMS so you can view, manage, and publish the content.

All workflow steps for your localization job must be completed in XTM. You'll receive an email when the job is completed in XTM and ready to fetch. Then, you can retrieve the localized content from XTM.

Remember: You must use DITA maps and not standalone DITA topics to localize content with XTM.
  1. You need to select a map for which you want to retrieve localized content from XTM. You can do it by doing one of the following:
    OptionDescription

    Recommended: Retrieve localized content from XTM for a released map

    1. In the content library, click the map for which you want to retrieve the localized content. The Resource Details Drawer appears on the right side of the screen.

    2. In the Resource Details Drawer, select Releases.

    3. In the Releases tab, go to the related release for which you want to retrieve the localized content and click Localize.

    Retrieve localized content from XTM for a branched map

    1. In the content library, click the map for which you want to retrieve the localized content. The Resource Details Drawer appears on the right side of the screen.

    2. In the Resource Details Drawer, select Branches. You will see the list of branches related to your map.

    3. In the Branching tab, switch to the branch that contains the map for which you want to retrieve the localized content.

    4. The Branching tab closes and you are back in the content library. Click the map for which you want to retrieve the localized content.

    5. In the Resource Details Drawer on the right of the screen, select the Jobs Tab.

    Retrieve localized content from XTM for a standard map

    1. In the content library, click the map for which you want to retrieve the localized content. The Resource Details Drawer appears on the right side of the screen.

    2. In the Resource Details Drawer, select the Jobs Tab.

    Retrieve localized content from XTM for any map

    In the content library, go to Localization Jobs in the left pane.

  2. From the Localization Jobs list, select a job you want to retrieve localized content for. The value in the Job Type column will show XTM Package for this localization job.
  3. Click Fetch Translated Documents.

    The Download complete dialog will show when the file transfer is complete.

    XTM localization download complete
  4. Click OK to show the resources in the localization manager.
  5. Optional: Click Mark Job Complete to mark this localization job complete.
    Remember: Once you mark a localization job complete, you cannot undo the action.
    Tip: We recommend publishing the localized content and performing a quality verification before marking the job as complete.
    When you mark a job complete, it shows up under Completed Jobs in the Localization Jobs, which can help you organize your localization process. You cannot modify completed localization jobs.