Connecting to Microsoft Translator

Create a configuration for the Microsoft Translator cloud service to use your Microsoft Translation account for translating AEM page content or assets.

TIP

If you are new to translating content, please refer to our Sites Translation Journey, which is guided path through translating your AEM Sites content using AEM’s powerful translation tools, ideal for those with no AEM or translation experience.

NOTE

AEM provides a trial Microsoft Translation account that allows for a maximum of 2 000 000 free translated characters per month. To obtain an account subscription that is adequate for production systems, see Upgrading The Microsoft Translator Trial License Configuration.

Property Description
Translation Label The display name for the translation service
Translation Attribution (Optional) For user-generated content, the attribution that appears next to translated text, for example Translations by Microsoft
Workspace ID (Optional) The ID of your customized Microsoft Translator engine to use
Subscription Key Your Microsoft Subscription Key for Microsoft Translator

After you create the configuration, you need to activate it.

The following procedure creates a Microsoft Translator configuration.

  1. In the navigation panel, click or tap Tools -> Cloud Services -> Translation Cloud Services.

  2. Navigate to where you wish to create the configuration. Normally this is in your site root or it can be a global, default configuration.

  3. Tap or click the Create button.

  4. Define your configuration.

    1. Select Microsoft Translator in the drop-down.
    2. Type a title for your configuration. The title identifies the configuration in the Cloud Services console as well as in page property drop-down lists.
    3. Optionally, type a name to use for the repository node that stores the configuration.

    Create translation configuration

  5. Click Create.

  6. In the Edit Configuration window, provide the values for the translation service described in the previous table.

    Edit translation configuration

  7. Tap or click Connect to verify the connection.

  8. Tap or click Save & Close.

Upgrading The Microsoft Translator Trial License Configuration

Microsoft Translation configuration pages provide a convenient link to the Microsoft web site for obtaining an account subscription that is adequate for production systems.

  1. In the navigation panel, tap or click Tools -> Cloud Services -> Translation Cloud Services.
  2. Tap or click your existing Microsoft Translator configuration.
  3. Tap or click Edit.
  4. In the Edit Configuration window, tap or click Upgrade Subscription. A Microsoft web page with further details about the service opens.

Customizing Your Microsoft Translator Engine

Microsoft Translation configuration pages provide a convenient link to the Microsoft web site for customizing your Microsoft Translator engine.

  1. In the navigation panel, tap or click Tools -> Cloud Services -> Translation Cloud Services.
  2. Tap or click your existing Microsoft Translator configuration.
  3. Tap or click Edit.
  4. In the Edit Configuration window, tap or click Customize Translator. Use the Microsoft web page that opens to customize your service.

Activating the Translator Service Configurations

You need to activate your cloud service configurations to support translated content that is replicated to the publish instance. Use the method of publishing a tree to activate the repository nodes that store the Microsoft Translator configurations. The nodes are located below the following parent nodes:

  • /libs/settings/cloudconfigs/translation/msft-translation

On this page