This article is intended for Oracle Service Cloud administrators responsible for installing and configuring the Language I/O Response add-in for automated ticket translation.
1. Add the Language I/O Status Field to Incidents
In this section we will create a custom field that is required by Language I/O for the storage of Incident translation status. This field is associated with the Incident, not with individual Incident Threads. It will contain the translation status of the thread most recently sent for translation. Individual thread translation statuses are viewable atop the Thread on the Language I/O tab.
- Navigate to Configuration =>Database =>Custom Fields and on the right-hand side under Custom Fields select Incident.
- Click on the New button in the Home Ribbon.
- In the Name field provide a description such as Language I/O Status.
- Under Data Type select the Text Field option.
- In the Column Name field enter "ln_status" without quotes. Note that if the text is not entered exactly as provided here, Language I/O Response will not work.
- Leave the check boxes unchecked. Notes and description are optional.
- Under Data Details select Plain Text.
- Leave Default Value and Mask empty.
- Under Size of Field enter 64.
- Under Interface Visibility make it visible to agent profiles who will be using the Language I/O add-in.
- Click on the Save & Close button in the Home Ribbon and agree to the terms in the dialog that pops up. Note that a custom field can take time to process depending upon your installation. Some of the subsequent steps can not be completed until this field has been successfully added to your database.
2. Upload and Deploy the Language I/O Custom Object Definition
In this section we will upload the definition files for a custom object that is required by Language I/O for the storage of translation-related threads that are displayed only on the Language I/O tab.
- Save the LNThread_1-2.zip file attached to this article somewhere on your local machine.
- Navigate to Configuration => Database => Object Designer.
- Click on the Import button in the Home Ribbon, browse to the zip file you just downloaded from this article and select Next.
- In the dialog that displays, make sure the LNThread item is selected and click on Next and agree to any subsequent prompts.
- Once the definition is imported, you will see a linguistnow package appear under the Custom Objects list in the underlying screen.
- Select Deploy in the Home Ribbon and agree to all prompts. Note that the deployment process can take time and you'll need to wait until it completes before you can use Language I/O.
3. Install the Language I/O Response Add-In Zip
In this section we will upload the Language I/O Response add-in into your Oracle Service Cloud instance and apply privileges to the profiles of agents who need to translate Incident content.
- Navigate to Configuration => Site Configuration => Add-In Manager and click on the New icon in the Home Ribbon. You will be prompted to upload the Language I/O Response add-in .zip file that is provided to you by your Language I/O project manager.
- Once the add-in is uploaded, select the Profile Access button in the Home Ribbon and grant profile-level and interface-level permissions according to who will need to use the Incident translation functionality.
- Select the Save & Close button in the Home Ribbon.
- Restart the Agent Desktop application as add-in changes won't register without a restart.
4. Add Language I/O Response & Status Field to the Incident Workspace
In this section we will add the Language I/O Response add-in to the Workspaces for agents who need to translate Incident threads. Secondly, we will add the Language I/O Status field to the Workspace.
- For each profile that you granted permission when you installed the add-in, open the associated Incident Workspace (Configuration => Application Appearance => Workspaces/Workflows).
- Create a new tab in the Workspace and label it Language I/O or something that will easily identify the add-in to users.
- While the Language I/O tab is selected in the Workspace editor, select Insert Control from the file menu.
- Scroll to the far right in the Home Ribbon and find Language I/O Response [Version] in the Workspace Add-Ins section.
- Drag and drop Language I/O Response add-in onto the blank tab you just created.
- Click on the Save button.
- Navigate to the tab/area in your Incident Workspace where you will want the Language I/O translation status field to display to users.
- Select Insert Field in the file menu and find the new Language I/O Status field in the fields that are displayed.
- Drag the Language I/O Status field onto the Workspace where you want it to be displayed.
- Repeat 8-9 for the Language field (it may be named differently if you are using Custom Locales).
- Click on the Save button.
5. Add Two New Rules to Workspaces
In this section we will add a rule to each Workspace using Language I/O that allows Language I/O to automatically switch over to the Messages tab within the Incident Workspace once the agent's translated response is ready to send. Secondly we will add a button and an associated rule that loads the add-in into the workspace.
- Select Rules in the file menu and click on the Add Rule button in the Home Ribbon if no rules yet exist. If you already have rules, click on the Rules button in the Home Ribbon and select the Add Rule option in the Rules window that is displayed.
- In the Step 1 box of the Trigger tab of the Rules dialog, click on Add next to A Named Event Fires.
- In the Step 2 box select the Add option enter the text "switch_to_messages_tab" (without quotes) and then click OK.
- Click the Next button at the bottom of the Rules dialog until you get to the Then Actions tab.
- In the Step 1 box, click on the Add link next to Focus a tab.
- In the Step 2 box, click Add under This rule will and in the resulting dialog, expand the nodes until you are able to select the Messages tab or whatever the Messages tab is called in your Workspace. You will want this rule to take you to the tab where agents normally enter their responses.
- Click on Next until you are taken to the Properties tab and name your rule something related to Language I/O so users will recognize it. Then click the Finish button at the bottom of the dialog.
- Click on Insert Control in the file menu, select the button control and drag it down onto the Language I/O tab, above the blank area where the Language I/O add-in will display so the button is sitting above it, preferably aligned on the left-hand side.
- You can add label text such as "Load Language I/O" or use one of the image labels attached to this article. We provide a variety of sizes as well as the photoshop .psd source file so you can resize it yourself.
- Select the button and then select Rules in the file menu.
- Click Add to launch the Rule creation wizard.
- Under Step 1 on the Triggers tab select the Add link next to "A button is clicked."
- Under Sep 2 on the Triggers tab, click on the link beneath "Apply this rule when" and in the dialog that displays, select the Language I/O button and click on OK.
- Skip to the Then Actions tab and under Step 1, click the Add link next to "Execute an add-in action."
- Under Step 2, click on the link beneath "Then this rule will" and in the dialog that displays, select the Language I/O Response add-in and in the value field, enter the word "load" without quotes, all lower-case.
- Skip to the Properties tab and give this rule a name such as "Language I/O Load" or something indicating that this rule loads the add-in.
- Click on the Finish button in the Rules Wizard.
- Click Save & Close in the Workspace editor.
6. Grant Profiles API and LNThread Custom Object Permissions
In this section we will make sure that all agent profiles that need to use Language I/O have the correct permissions.
- Open the Configuration => Staff Management => Profiles report and perform the below steps for each profile that will have access to the Language I/O Response add-in.
- Open the profile editor and select the Permissions button in the Home Ribbon.
- On the Administration tab check the Select All box next to Public SOAP API and also next to Public Knowledge Foundation API.
- Click on the Custom Objects tab and grant all permissions next to the LNThread custom object.
- Click the Save & Close button in the Home Ribbon.
Congratulations! You are now ready to use Language I/O Response.
7. Server Configuration Properties
1. Navigate to Configuration => Site Configuration => Add-In Manager => LN_Response.zip => Profile Access => select the relevant profile and interface.
AgentMessage, AutomaticMessage, CustomerMessage, OtherMessage: These affect the statusbar color for the various message types. You can use any color name from this list.
SendContext: For human translations, this sends the previous messages to the translator so they can understand the context of the message.
SendEmail: This determines whether Language I/O will automatically send translated agent messages. If yes, clicking "send" on a translation will email it to the customer. If no, clicking "send" will move you to the messages tab so that you can review, modify, and add standard text and articles to the message before sending. Availability of this option depends on workspace configuration.
All Site properties are unique to your OSC instance and should be set the same for every profile. Using different values for these will prevent Language I/O Chat from working.
LinguistNowLogin: Your Language I/O Representative will set this value for you, or tell you what it should be.
IncidentLocaleField: This should be left as default if you are using built-in locales. Otherwise, use the name of the custom locale field you created.
LinguistNowUrl: This should be left as https://golinguist.com/linguistnow/resources/ unless otherwise directed.
AgentCanChangeTranslationType: This determines whether the agent can select the un-preferred translation type for outgoing messages.
AgentCanRequestRetranslation: This determines whether the agent can request a human re-translation for a customer message.
PreferredType: This determines what type of translation Language I/O will prefer.
* machine - machine translation always preferred.
* hybrid - machine incoming, human outgoing.
* human - human translation always preferred.
SupportLocale: This represents the language that the agent speaks. If you are using Oracle's locales, and your agent speaks English, this value will be 1. If your agent speaks another language and you do not know its ID, contact your Language I/O Representative. If you are using custom locales, use the ID visible when you mouseover the appropriate language in the custom field's data details section.
TranslationTypeLocales: Used in conjunction with AgentCanChangeTranslationType, this limits which languages the agent can change translation type for. If it is left blank or has an invalid list, the agent can choose the type or not depending on the AgentCanChangeTranslationType setting.
To use this setting, give a comma separated list of which target languages the agents should be able to choose translation type for, i.e. 1, 2, 5
Language I/O Response version 1.3.4