Connector Framework Server 23.2

# Translate Documents

CFS can use third-party translation services to translate documents into other languages. This can be useful when you have documents that are not in your users' native language.

IMPORTANT: To perform translation, you must have a license for one of the supported translation services. CFS relies on third-party services to translate text between languages. The language translation library that CFS uses to communicate with third-party translation services is not included in the standard CFS installation but can be obtained through OpenText software support.

OpenText recommends that you configure the `LanguageTranslation` task as a post-import task. Use the `Post` parameter to specify the name of a section that contains the task settings.

The following is an example task that uses the translation services provided by an SDL Enterprise Translation Server:

    [ImportTasks]
    Post0=Library:LanguageTranslation

    [LanguageTranslation]
    Library=LanguageTranslation
    TranslatorType=SdlEts
    ApiBaseUrl=https://host:port
    ApiKey=0a12b34c56d78e9
    SourceField=DRECONTENT
    TargetField=DRECONTENT
    TargetLanguage=ENG
    Quality=medium-high

The following is an example task that uses the translation services provided by sdlbeglobal.com:

    [ImportTasks]
    Post0=Library:LanguageTranslation

    [LanguageTranslation]
    Library=LanguageTranslation
    TranslatorType=SdlBeGlobal
    AccountId=12345
    ApiKey=0a12b34c56d78e9
    UserId=23456
    TouchpointId=34567
    SourceField=DRECONTENT
    TargetField=DRECONTENT
    TargetLanguage=ENG

In both cases, the `TranslatorType` configuration parameter specifies the type of translation service to use. To use an SDL Enterprise Translation Server, set this parameter to `SdlEts`. To use the services that are provided by `sdlbeglobal.com`, set this parameter to `SdlBeGlobal`. You must then set the relevant parameters that are required to use the API:

- To use an SDL Enterprise Translation Server, set the configuration parameter `ApiBaseUrl` to the base URL of the API to use for translation, and the `ApiKey` parameter to the API key.
- To use the services provided by sdlbeglobal.com, set the parameters `AccountId`, `ApiKey`, `UserId` and `TouchpointId` to the values provided by SDL.

The remaining parameters are optional but you can set these to customize the task to your use case.

The `SourceField` configuration parameter specifies the name of the document field to translate, and the `TargetField` parameter specifies the name of the field to contain the results. If you specify the same field name for both parameters, CFS reads the text from the field, sends it for translation, and then writes the result back to the same field (which overwrites the original value).

The source language is detected automatically, but if automatic detection is not successful you can specify the source language by setting the configuration parameter `SourceLanguage`, which accepts the name of a language or a three-letter language code. Alternatively, you can configure the task to read the source language from a document field, by setting the parameter `SourceLanguageField`. For information about the languages that are supported, refer to the SDL documentation or translation service user interface.

The target language is specified by the configuration parameter `TargetLanguage`, which has a default value of `ENG` (English).

If you are using an SDL Enterprise Translation Server, you can also choose how to balance translation quality and speed by setting the `Quality` parameter.

For more information about the configuration parameters that you can use to configure the language translation task, refer to the Connector Framework Server Reference.

Copyright 2023 Open Text
Version 23.2 | Last updated March 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Connector Framework Server 23.2

Topic Title: Translate Documents