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 theApiKey
parameter to the API key. - To use the services provided by sdlbeglobal.com, set the parameters
AccountId
,ApiKey
,UserId
andTouchpointId
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.