Integrate with a translation management system

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read

    • Integrate with any translation management system of your choice to localize the artifacts requested for translations.

    Before you begin

    Role required: localization_admin

    Procedure

    1. Create subflows to request translations and to retrieve the translated content using Integration Hub subflows, actions, and connections and credentials.
      1. Ensure that the error messages and codes from the TMS provider are mapped correctly with the error messages and codes supported the ServiceNow platform.
        Table 1. Standard error codes and messages
        Error code Error message
        40510 Error while requesting translations.
        40520 Error while retrieving translations.
        40500 Authentication failed.
      2. Ensure that the input and output fields are in the following format for the subflows:
        Table 2. Request translation subflow
        Field Name Description Type
        Inputs
        lftask_number Associated localization task number. String
        xliff_1_2_content Content of an artifact which must be translated in XLIFF 1.2 format.
        For example, 
        'csv', 'xliff 1.2'
        		 String
        source_language Language code of the source text.
        For example, 
        'en'
        		 String
        target_language Language code of the target text.
        For example, 
        'fr', 'it'
        		 String
        Outputs
        project_info The ID for the project created for an artifact configuration. Object
        status Status of the request.

        For example, Success or Failure.

        		 Choice
        error_message The reason for the error that populates when an error occurs. String
        error_code The error code that populates when an error occurs. String
        Table 3. Retrieve translation subflow
        Field Name Description Type
        Inputs
        lftask_number Associated localization task number. String
        project_info The ID for the project created for an artifact configuration. Object
        Outputs
        translated_xliff_1_2 Translated XLIFF file received from the TMS. String
        status Status of the request.

        For example, Success or Failure.

        		 Choice
        error_message The reason for the error that populates when an error occurs. String
        error_code The error code that populates when an error occurs. String
    2. Create and configure a custom translation management system and activate it.

      See Create a custom translation management system.

      Note:
      Localization Framework depends on Integration Hub to build integrations with third-party systems.