Documentation Center

Integration requirements for SDL LiveContent Architect and SDL TMS

The following are items that will help you better understand the integration of SDL LiveContent Architect and SDL TMS and considerations when configuring translation and workflow.

SDL LiveContent Architect

Required for SDL LiveContent Architect integration:

  • Languages are defined as described for source and pivot languages (see related topic). For example:
    The following example defines a source language of English with target languages for German, Spanish, French, Italian and Chinese. The second group indicates that Chinese can be used as source language (pivot) for translating to Japanese and Korean.
    <GenerationScheme>
     <FromLanguage ref="en">
       <ToLanguage ref="de"/>
       <ToLanguage ref="es"/>
       <ToLanguage ref="fr"/>
       <ToLanguage ref="it"/>
       <ToLanguage ref="zh"/>
     </FromLanguage>
     <FromLanguage ref="zh">
       <ToLanguage ref="ja"/>
       <ToLanguage ref="ko"/>
     </FromLanguage>
    </GenerationScheme>
  • Translation templates come from SDL TMS and are automatically pushed to SDL LiveContent Architect by TranslationOrganizer.
  • SDL LiveContent Architect uses UTF-16 for the content.
  • The dedicated user (typically 'ServiceUser') having the role TRANSLATORSERVICE.
  • Statuses and status transitions, configured for the TRANSLATORSERVICE role, that define a workflow for the integration:
    • There is an initial status to indicate that the object is ready for translation.

      This is typically the To Be Translated status.

      This status is used by TranslationBuilder to create new target language objects and by TranslationOrganizer to identify and include objects to send.

    • With the status transition from the initial status, there is a status to indicate that the object is no longer under control of the CMS.

      This is typically the In Translation status.

      The status transition is: To Be Translated to In Translation.

      TranslationJob option Include 'In Translation' items forces the re-sending of objects in this status.

    • With the status transition from the status above, there is a status to indicate that the object is back in CMS control.

      This is typically the Translated status.

      The status transition is: In Translation to Translated.

    • The last status indicates that the translation was rejected and object should be re-translated.

      This is typically the Translation rejected status.

      The status transition is: Translated to Translation rejected.

    • The status transition from Translation rejected to In Translation allows items to be re-translated.
The system finds your configured initial and next status by executing a GetPossibleTransitionStatus on your object having the user role 'TRANSLATORSERVICE'. For every call, the system expects exactly one to status as a result, so it can deterministically push your object from one status to the next one.

Defining and configuring the TRANSLATORSERIVCE role and the status transition are described in Configuring the translation builder.

SDL TMS

Required for SDL TMS integration:

  • Configurations specifying the workflows and all necessary language pairs.
  • The workflow should contain minimally the following 2 steps:
    • "Content retrieval" step which is used by SDL LiveContent Architect to start getting the translation
    • "Completed" step which is used by SDL LiveContent Architect to indicate that the translation was downloaded successfully.
  • Refer to the SDL TMS manuals for the further details about how to configure the workflow in SDL TMS.