Back to top image

Setting Up Your ServiceNow Connector

 

ServiceNow offers two different channels for translating content: Localization Framework (Smartling Translation Management System Spoke) and Dynamic Translation (Smartling MT Service Spoke). Your ServiceNow Connector is configured based on which translation channel you will be using. See ServiceNow Connector Overview. 

Please note that this Connector is a paid product. For pricing information, please reach out to your Smartling Customer Success Manager.

Setup with ServiceNow Localization Framework 

Step 1: Create a dedicated Smartling project for the ServiceNow Connector

You must create one dedicated Smartling project per ServiceNow environment. Using a single Smartling project for multiple ServiceNow environments can lead to issues in the translation process.

Each ServiceNow environment generates unique localization task (LFTask) numbers, which the Smartling connector uses as identifiers. If LFTask numbers from different ServiceNow environments are duplicated within the same Smartling project, it can cause conflicts and disrupt the workflow. 

To create a new Smartling project:

  1. Create a new Project in Smartling 
  2. Select the Project type "Connector"
  3. Select "ServiceNow" as your connecting platform
  4. During the Project creation, select the desired source and target locales 

Once the project has been created, ensure that all workflows, linguistic assets, and team members are set up correctly. In particular, we would recommend checking that the default workflows for all of your target languages are set up according to your preferences. If desired, these workflows will be used automatically for all translation requests with the Connector.

You will also need to create API tokens for each project. This is outlined in the Installation Guides referenced below. 

Step 2: Configure your project settings

You will now need to configure the project's language mapping and content parsing settings. 

Language Configuration 

  1. In your Smartling ServiceNow Project, click the Settings tab > ServiceNow Settings.
  2. Under the Language Configuration section, you will see the target languages in your Smartling project, along with the source language. The first time you open this page, the field to the left of each target language will be blank. 
  3. Enter the ServiceNow language ID for each target language in the empty fields. For example, if you have defined Filipino language with the ID "fil," then you must enter "fil" in the language mapping field. 
  4. Click the blue checkmark to save each mapping. 
    language-mapping.png

Content Parsing

Configure how Smartling should parse your fields from ServiceNow by following the steps below. For more information on content parsing options, please refer to this page.  

  1. In your Smartling ServiceNow Project, click the Settings tab > ServiceNow Settings.
  2. Under Content Parsing, click the down arrow to view all item fields.
  3. For each field, select a parsing option from the dropdown menu. 
    Content Parsing.png

Step 3: Install the Smartling Translation Management System Spoke app 

      1. Navigate to the ServiceNow store and find the Smartling TMS Spoke app. 
        TMS App.png
      2. Click on the app and then Get to install the app in your ServiceNow environment.

Step 4: Connect ServiceNow to Smartling 

Once the dedicated Smartling project has been fully set up and you have installed the Smartling TMS Spoke app, you will need to complete the configuration process. 

Please see the Installation Guide from the Smartling TMS Spoke app page for details on how to configure the connector. 
TMS Spoke -Install Guide.png


Setup with ServiceNow Dynamic Translation 

Step 1: Install the Smartling MT Service Spoke App 

      1. Navigate to the ServiceNow store and find the Smartling MT Service Spoke App.
        MT Spoke App.png
      2. Click on the app and then Get to install the app in your ServiceNow environment.

Step 2: Connect ServiceNow to Smartling 

      1. Please see the Installation Guide from the Smartling MT Service Spoke app page for details on how to configure the connector. 
        MT Spoke - Install Guide.png
      2. You will also need to configure your preferred MT Profile in Smartling. Please follow the steps outlined here.

Step 3: Language Configuration

Please send your Customer Success Manager a list of ServiceNow language codes that you intend to use for dynamic translation for Chat and other MT translation purposes. Our team will then complete the language configuration.

Table of Contents