Connecting to Microsoft Translator

Last update: May 3, 2023

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

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

PropertyDescription
Translation LabelThe 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 KeyYour Microsoft Subscription Key for Microsoft Translator.

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

The following procedure uses the touch-optimized UI to create a Microsoft Translator configuration.

  1. On the rail, click or tap Tools > Cloud Services.

  2. In the Microsoft Translator area, then click or tap Show Configurations.

  3. Click the + link next to Available Configurations.

    chlimage_1-382

  4. 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. The default name is based on the title. Optionally, type a name to use for the repository node that stores the configuration. You should use the default value for the Parent Configuration property which is the path of the repository node.

  5. Click Create.

  6. In the dialog box that appears, type values for the properties and then click OK.

Sample Microsoft Translator Cloud Service Configurations

The following Microsoft Translator cloud service configurations are installed with the Geometrixx samples. Some sample configurations use a trial Microsoft Translation account that allows for a maximum of 2 000 000 free translated characters per month.

Microsoft Translator Trial License

The Microsoft Translator Trial License configuration is a sample configuration that is installed with the Geometrixx Outdoors sample package. This configuration uses a Microsoft Translator account that has a free subscription that allows for 2 000 000 translated characters per month.

Microsoft Translator Trial License - Geometrixx-outdoors

The Microsoft Translator Trial License - Geometrixx-outdoors configuration is a sample configuration that is installed with Geometrixx Outdoors. This configuration uses the same free Microsoft Translator account as the Microsoft Translator Trial License configuration. The account has a free subscription that allows for 2 000 000 translated characters per month.

This Microsoft Translator configuration is optimized for use with the type of content of the Geometrixx Outdoors sample site.

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. On the rail, click or tap Tools > Operations > Cloud > Cloud Services.

  2. In the Microsoft Translator area, click or tap Show Configurations, then click or tap Microsoft Translator Trial License (Microsoft Translation Configuration).

    chlimage_1-383

  3. On the configuration page, click Upgrade Subscription. Use the Microsoft web page that opens to configure your account.

    chlimage_1-384