DocumentationAEM 6.5User Guide

Configuring the Translation Integration Framework configuring-the-translation-integration-framework

Last update: Tue Dec 19 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

The Translation Integration Framework integrates with third-party translation services to orchestrate the translation of AEM content.

  • Connect to your translation service provider.
  • Create a Translation Integration Framework configuration.
  • Associate the cloud configurations with your pages.

For an overview of the content translation features in AEM, see Translating Content for Multilingual Sites.

Connecting to a Translation Service Provider connecting-to-a-translation-service-provider

Create a cloud configuration that connects AEM to your translation service provider. AEM includes the capability to connect to Microsoft Translator by default.
The following translation vendors provide an implementation of the new API for the Translation Projects. Links to learn more about the integration:

NOTE
To find the latest list of human and machine translation providers, have a look at these pages:

After you install a connector package, you can create a cloud configuration for the connector. Typically, you need to provide your credentials for authenticating with the translation service. For information about adding a cloud configuration for the Microsoft Translator connector, see Integrating with Microsoft Translator.

You can create multiple cloud configurations for the same connector if necessary. For example, create one configuration for each of the accounts or projects that you have with the same vendor.

After you configure a connection, you can create the translation integration framework configuration that uses it.

Creating a Translation Integration Configuration creating-a-translation-integration-configuration

Create a translation integration framework configuration to specify how to translate your content. The configuration includes the following information:

  • Which translation service provider to use.
  • Whether human or machine translation is to be performed.
  • Whether to translate other content that is associated with a page or asset, such as tags.

After you create a framework configuration, you associate the cloud configuration with the pages that you want to translate according to the configuration. When the translation process is started, the translation workflow proceeds according to the associated framework configuration.

When different sections of your website have different translation requirements, create multiple framework configurations accordingly. For example, a multilingual website includes English, Spanish, and Japanese language copies. The site owner uses two different translation service providers for Spanish and Japanese translations. Therefore, two configurations of the framework are configured. Each configuration uses a different translation service provider.

After you configure a translation integration framework, you can associate it with the pages that use it.

Note: For an overview of the content translation features in AEM, see Translating Content for Multilingual Sites.

A single configuration of the framework controls how to translate page content, community content, and assets.
chlimage_1-386

Sites Configuration Properties sites-configuration-properties

The Sites properties control how the translation of page content is performed.

Property
Description
Translation Workflow

Select the translation method that the framework performs for site content:

  • Machine Translation: The translation provider performs the translation using machine translation in real time.
  • Human Translation: Content is sent to the translation provider to be translated by translators.
  • Do Not Translate: Content is not sent for translation. This is to skip certain content branches which would not be translated but could be updated with latest content.
Translation Provider
Select the translation provider to perform the translation. A provider appears in the list when their corresponding connector is installed.
Content Category
(Machine Translation Only) A category that describes the content that you are translating. The category can affect the choice of terminology and phrasing when translating content.
Translate Component Strings
Select to translate component strings of components that are associated with the page.
Translate Tags
Select to translate tags that are associated with the page.
Translate Page Assets

Select how to translate assets that are added to components from the file system or referenced from Assets:

  • Do not translate: Page assets are not translated.
  • Using Sites translation workflow: Assets are handled according to the configuration properties on the Sites tab.
  • Using Assets translation workflow: Assets are handled according to the configuration of the properties on the Assets tab.
Auto-Execute Translation
Select to execute translation jobs automatically after translation projects are created. You do not have an opportunity to review and scope the translation job when you select this option.

Communities Configuration Properties communities-configuration-properties

Communities properties control how the translation of user-generated content is performed. The translation of user-generated content always uses machine translation. For more information, see Translating User Generated Content.

Property
Description
Translation Provider
Select the translation provider to perform the translation. The provider for which cloud configurations are created appear in the list.
Content Category
A category that describes the content that you are translating. The category can affect the choice of terminology and phrasing when translating content.
Choose A Locale To Use As The Global Share Store
(Optional) By selecting a locale for storing UGC, posts from all language copies will appear in one global conversation. By convention, choose the locale for the base language for the website. Choosing No Common Store will disable global translation. By default, global translation is disabled.

Assets Configuration Properties assets-configuration-properties

Assets properties control how to configure assets. For more information about translating assets, see Creating Language Copies for Assets.

Property
Description
Translation Workflow

Select the type of translation that the framework performs for assets:

  • Machine Translation: The translation provider performs the translation immediately using machine translation.
  • Human Translation: Content is automatically sent to the translation provider to be manually translated.
  • Do Not Translate: Assets are not sent for translation.
Translation Provider
Select the translation provider to perform the translation. A provider appears in the list when their corresponding connector is installed.
Content Category
(Machine Translation only) A category that describes the content that you are translating. The category can affect the choice of terminology and phrasing when translating content.
Translate Assets
Select to include assets in the translation project.
Translate Metadata
Select to translate asset metadata.
Translate Tags
Select to translate tags that are associated with the asset.
Auto-Execute Translation
Select to execute translation jobs automatically after translation projects are created. You do not have an opportunity to review or scope the translation job when you select this option.

  1. In the side bar, click Tools > Operations > Cloud > Cloud Services.

  2. In the Translation Integration area, whether any configurations have been created determines which link appears:

    • If no configurations have been created, click Configure Now.
    • If configurations already exist, click Show Configurations, and then click the + link that appears next to Available Configurations.

  3. Type a name for the configuration and then click Create.

  4. Configure the properties on the Sites, Communities, and Assets tab, and then click OK.

Configuring Pages for Translation configuring-pages-for-translation

To configure the translation of your source pages into other languages, associate the pages with the following cloud configurations:

  • The cloud configuration that connects AEM to your translation provider.
  • The translation integration framework that configures the details of the translation.

The translation integration framework cloud configuration identifies the cloud configuration to use for connecting to the service provider. When you associate a source page with a framework cloud configuration, the page must be associated with the service provider cloud configuration that the framework cloud configuration uses.

When you associate a page with a cloud configuration, the descendants of the page inherit the association. For example, if you associate the /content/geometrixx/en/products page with a Translation Integration Framework, the Products page and all pages below it are translated according to the framework.

When required, you can override the association on a descendent page. For example, the content of a web site is mostly about clothing. However, one branch of pages describes the company. The root page of the site is associated with a Translation Integration Framework that specifies machine translation using the Clothing category. The branch that describes the company uses a framework that performs machine translation using the General category.

Further, for any communities SCF components on the pages, the user generated content (UGC) will include the ability for users to translate content. For more information, see Translation of User Generated Content.

Associating a Page with a Translation Provider associating-a-page-with-a-translation-provider

Associate a page with the translation provider that you are using to translate the page and descendent pages.

  1. In the Sites console, select the page to configure and click View Properties.
  2. Click Edit then click the Cloud Services tab.
  3. Click Add Configuration > Translation Integration.
  4. Select the translation provider to use, and then click Done.

Associating Pages with a Translation Integration Framework associating-pages-with-a-translation-integration-framework

Associate a page with the Translation Integration Framework that defines how you want to perform the translation of the page and descendent pages.

  1. In the Sites console, select the page to configure and click View Properties.
  2. Click Edit then click the Cloud Services tab.
  3. Click Add Configuration > Translation Integration.
  4. Select the translation integration framework to use, and then click Done.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2