---
sourceDocument: Xanadu ServiceNow AI Platform Administration
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/platform-administration

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Integrate with a translation management system

# Integrate with a translation management system {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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.  
      {#integrate-with-tms__table_w3s_k2c_5nb__entry__2}

      | Error code | Error message |
      |-|-|
      | 40510 | Error while requesting translations. |
      | 40520 | Error while retrieving translations. |
      | 40500 | Authentication failed. |
      [Table 1. Standard error codes and messages]

      {#integrate-with-tms__table_w3s_k2c_5nb}
   2. Ensure that the input and output fields are in the following format for the subflows:  
      {#integrate-with-tms__table_ekn_4fc_5nb__entry__3}{#integrate-with-tms__table_ekn_4fc_5nb__entry__4}

      | 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 2. Request translation subflow]

      {#integrate-with-tms__table_ekn_4fc_5nb}  
      {#integrate-with-tms__table_nn3_rfc_5nb__entry__3}{#integrate-with-tms__table_nn3_rfc_5nb__entry__4}

      | 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 |
      [Table 3. Retrieve translation subflow]

      {#integrate-with-tms__table_nn3_rfc_5nb}
   {#integrate-with-tms__substeps_ozq_zdc_5nb}
2. Create and configure a custom translation management system and activate it.  
   See [Create a custom translation management system](https://servicenow-prod.fluidtopics.net/Ha2I~vxKqdUC8cXBLkEBJQ "Configure Localization Framework with a third-party translation management system of your choice to localize an artifact.").  
   Note:  
   Localization Framework depends on Integration Hub to build integrations with third-party systems.