Connecting to Microsoft Translator connecting-to-microsoft-translator

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.

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 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 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 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 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 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

Customizing Your Microsoft Translator Engine customizing-your-microsoft-translator-engine

Microsoft Translation configuration pages provide a convenient link to the Microsoft web site for customizing your Microsoft Translator engine. (https://hub.microsofttranslator.com)

  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 the configuration that you want to customize.
  3. On the configuration page, click Customize Translator. Use the Microsoft web page that opens to customize your service.

Activating the Translator Service Configurations 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 activating a complete section (tree) to activate the repository nodes that store the Microsoft Translator or third-party cloud service configurations. The nodes are located below the following parent nodes:

  • Microsoft Translation Service: /libs/settings/cloudconfigs/translation/msft-translation
  • Third-party Translation: /etc/cloudservices/machine-translation
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8