Configuring the integration between IBM Watson Language Translator and OpenPages

Define integration information for IBM Watson® Language Translator so that it can be used in the UI in OpenPages®.

Before you begin

You need a IBM Watson Language Translator service. For more information, see Configuring IBM Watson Language Translator on IBM Cloud.

Set the following application permissions:

  • Set the Watson Language Translator permissions for administrators who are allowed to access the Administration menu > Integrations > Watson Language Translator menu item.
  • Set the Watson Language Translator UI permission for users who are allowed to use IBM Watson Language Translator to view translated text in Task Views by using the Watson Language Translator on icon. It also allows access to the Auto Translate icon icon from administrator tasks.

    For more information, see Types of application permissions.

Procedure

  1. Get the service URL and API key for the IBM Watson Language Translator service. For more information, see Configuring IBM Watson Language Translator on IBM Cloud.
  2. Click Administration menu > Integrations > Watson Language Translator.
  3. Copy the IBM Watson Language Translator service URL into Service URL.
  4. Optional: Type the IBM Watson Language Translator API version into API Version.
    To use the default value that is used by OpenPages, leave the field empty.

    For more information, see Versioning in the IBM Watson Language Translator documentation.

  5. Copy the IBM Watson Language Translator API key into API Key.
  6. In Confidence Threshold enter the lowest confidence score that a suggestion must meet. This is a confidence score for recognizing a particular language. It is not a confidence score of the quality of the translated text.
  7. Define the object types that are allowed to be translated.
    • To enable translation for all object types, set Enable all Object Types to true.
    • To restrict translation to specific object types, set Enable all Object Types to false. Under Object Types, click the check box next to each object type that is allowed to be translated.
  8. Click Save.
  9. Click Test Connection to check the connection.
  10. Test the functionality across the system. You can use the following logging options to help you to troubleshoot the integration:

Results

Note: Should you ever want to turn off the IBM Watson Language Translator feature after it has been configured, clear the Watson Language Translator UI permission on users. The buttons for the IBM Watson Language Translator are then hidden.