Configuring Language I/O for ServiceNow

Configuring the Language I/O Translation Service

 First, search for and change the current scope to “Language I/O”. Click the "globe" icon in the top-right corner and find the Language I/O Translator Service Spoke:

(Click to enlarge)

Then, follow these steps:

1. Navigate to Language I/O > Translator Configurations and open the configuration record with the name “Language I/O”
2. Set the record to “Active”:
   
   (Click to enlarge)
   
   Important: Only one configuration should be active (Active: true) at a time. Disable any other configuration if applicable:
   
   (Click to enlarge)
3. In the "Preferences"section, check both the “Mark as default for translation” and “Mark as default for detection” options:
   
   (Click to enlarge)
4. In the "Language Code Mappings"" section, create new language code mappings to map the ServiceNow language codes to the Language I/O language codes. Code mappings means that the language codes in ServiceNow match the language codes used by Language I/O (for example fr-FR for French. If you are unsure of the correct codes, please consult your Language I/O Customer Success Manager):
   
   (Click to enlarge)
5. Save your changes.

Setting up Connections and Credentials

1. Open Language I/O > Connections & Credentials and open the “Language I/O” record:
   
   (Click to enlarge)
2. Make sure that “Language I/O” in the Connections tab is active. Click the “Language I/O Customer ID” credential associated with the record.
3. Enter your Language I/O API credentials as the username and password. Make sure it is set to “Active”:
   
   (Click to enlarge)
   
4. (Optional) Enable the system property x_tmlab_lang_io.force_detect. This forces the "Translate Text" subflow to run the "Detect Language subflow" before translating the text:
   
   (Click to enlarge)
   
   Note: For more information about flows and subflows, see your ServiceNow documentation.

Retranslating content

The retranslate button on single and multi-line text fields only shows after a first translation is successful. You can only use it once: after you click it, the retranslate button disappears:

(Click to enlarge)

Single-line text fields

To enable the retranslation feature in a single line text field on the form:

1. Open the form. Right-click on the field and click "Configure Dictionary".
2. In the attributes section, add “Field Decoration” attribute with a value of “x_tmlab_lang_io_retranslation”.

(Click to enlarge)

Multi-line text fields

To enable the retranslation feature in a multi-line text field on the form:

1. Navigate to the form that you want to edit. Right-click on the hamburger icon at the top-left and go to Configure > Form Layout.
2. Find the “Retranslation” item and add it below the multi-line text field.

To add the retranslation feature to a second multi-line text field in the same form:

1. Go to System UI > Form Sections.
2. Open the record in the table and view where the formatter is located. The formatter on the case table is on the sn_customerservice_case table in the case view.
3. In the "Section Elements" related list, there is an entry named x_tmlab_lang_io_retranslation.xml.
4. Open the record. Right-click on the hamburger icon and click "Insert". A new x_tmlab_lang_io_retranslation.xml entry is now available.
5. Return to the form that you want to edit.
6. Click on the hamburger icon and go to "Form layout".
7. Add the new Retranslation entry below the multi-line text field
   Note: You can find the formatter that comes with the application in the task table. If you want to place the retranslate button in a different table, make sure that you insert the formatter and section element into the target table. You can do this via a simple script to set the table.

Activity stream

The retranslate button for the activity stream only shows when you can translate the last work note or comment in the activity stream. When you click the "Translate Last Note" button, it is replaced with a ‘Retranslate Last Note’ button. When you click the "Retranslate Last Note" button, the button disappears until new work notes or comments appear that can be translated:

(Click to enlarge)

To enable retranslation on the activity stream:

1. Go to System UI > UI Actions.
2. Open the ‘Translate Last Note’ record.
   1. Copy the record to the desired table.
   2. Verify and make sure it is active.
3. Open the ‘Retranslate Last Note’ record.
   1. Copy the record to the desired table.
   2. Verify and make sure it is active.