Localization Framework integration with Catalog Builder

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 3 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Localization Framework integration with Catalog Builder

    The Localization Framework integration with Catalog Builder in ServiceNow enables users to manage the translation of catalog items effectively. It provides tools for both manual and machine translation, facilitating the creation and modification of catalog items in multiple languages.

    Show full answer Show less

    Key Features

    • Translation Status Tab: This feature on the Catalog Builder dashboard allows you to view and manage the translation status of catalog items.
    • Translation Modes: Users can choose between Request Translation mode for new or existing items and Self-translation (ad hoc) mode for direct editing of translations.
    • Required Plugins: The Localization Framework Installer and Dynamic Translation plugins must be installed to utilize these capabilities.
    • Translation States: The system reflects various states such as Not Translated, Translations Requested, Partially Translated, and Translated, helping users track the translation progress.

    Key Outcomes

    By utilizing the Localization Framework, ServiceNow customers can:

    • Streamline the translation process for catalog items, ensuring accessibility for a diverse user base.
    • Request translations easily through the Translation Status tab, with clear visibility into the translation progress.
    • Edit translations on-the-fly, enhancing the accuracy and relevance of catalog item information.
    • Maintain a well-organized catalog with items available in multiple languages, thereby improving user experience.

    The Translation Status tab in the Catalog items tab on the Catalog Builder dashboard enables you to view the translation status of catalog items, and translate catalog items on the fly using manual or machine translation methods.

    Ensure that the following plugins are installed before you start using Localization Framework in Catalog Builder:

    1. Localization Framework Installer plugin for Service Catalog: The plugin enables the Localization Framework capabilities in Service Catalog and Catalog Builder.
    2. Dynamic Translation plugin: Enables on-the-fly machine translation capabilities.

    Translate catalog items information using one of the following modes:

    • Request Translation mode
    • Self-translation (ad hoc) mode

    Request translation mode for new catalog items

    Set the glide.sc.catalog_builder.localization.enable_request_translation_mode property to True, to enable the Request translations mode.

    When you create a new item, the Request translations step appears in the wizard steps region. Click Browse to view and select the languages you want to translate the catalog item information to.

    Figure 1. Request translations step
    Request translations step screen.

    For more information, see Request translations for Service Catalog items.

    Request translation mode for existing items

    Set the glide.sc.catalog_builder.localization.enable_request_translation_mode property to True, to enable the Request translations mode is enabled.

    On the Catalog Items tab, click the existing item that you want translated, then click the Translation status tab on the right pane (next to the Item details tab). You would see the list of languages configured in the system along with the state of that language for the catalog item and a Request translations link to request for a translation.

    Figure 2. Translation status tab
    Translation status tab

    Click the Request translations link below the language you want the translations for. A dialog appears prompting you to confirm the translation request. When you confirm the translation request on the Translation status tab, a localization task gets generated and its corresponding Localization item record ("LRITMXXXXXXX") shows up in place of the Request translations link. The state for that specific language changes to Translations requested.

    When the localization task completes in Localization Framework, the Request translations link comes back which you can use to request for translations again. The state changes to Translated, Partially translated, or Not translated on the Translation status tab, depending on whether the translations occur for all fields, some fields, or no fields in the table.

    For more information, see Request translations for Service Catalog items.

    Self-translation (ad hoc) mode

    Figure 3. Translation status tab with self-translation mode
    Translation status tab with self-translation mode

    Set the glide.sc.catalog_builder.localization.enable_request_translation_mode property to False to enable self-translation mode. The default value for this property is False.

    In the Catalog Items tab, click the existing item you want translated, then click the Translation status tab on the right pane (next to the Item Details tab). The list of languages configured in the system is displayed, along with the state of that language for the catalog item and an Edit translations link to edit the translation.

    Click the Edit translations link to open another tab that contains two comparison UI regions: The left region is the source language, and the right region is the target or translated language. You can compare the language translation side by side in the page, and make changes if required.

    For more information, see Request ad hoc translation for Service Catalog items.

    Figure 4. Self-translation
    Self-translation

    Translation States

    Table 1. Translation states for both modes
    State Mode Description
    Not available Request translation and Self-translation If the Localization Framework Insights record is not available, the translation state displayed by the system is Not Available, and the state appears near the language name.
    Not translated Request translation and Self-translation If there are no translations in the system for that specific catalog item for that language, the state Not Translated appears near the language name.
    Translations requested Request translation If there is an active LRTIM associated with a language for the item, the state Translations requested appears near the language name.
    Partially translated Request translation and Self-translation If there are partial translations in the system for that specific catalog item for that language, the state Partially Translated appears near the language name.
    Translated Request translation and Self-translation If all translations for that specific catalog item for that language exist in the system, the state Translated appears near the language name.