MS Azure Translator Connector

For the most up-to-date documentation, please visit docs.brix.ch

The "Auto Translator" plugin automatically translates nodes (on creation and meta data update) and assets (on meta data update).

Properties

To be configured in {home}/appserver/conf/custom.properties

autoTranslator.license

type: String, required: yes, default: -, since v1.2.0

The license key for the plugin (product: autoTranslator), provided by brix.

autoTranslator.ignoreNodeTypeIds

type: List of String (comma-separated), required: no, default: -

A list of node type Ids which should be ignored.

autoTranslator.ignoreNodeIds

type: List of String (comma-separated), required: no, default: -

A list of node Ids to ignore (including their children).

autoTranslator.ignoreInformationFieldIdOnAssetTypeId

type: List of String (comma-separated), required: no, default: -

A list of <assetTypeId>:<informationFieldId> pairs to be ignored.

autoTranslator.languagePreferences

type: List of String (comma-separated), required: no, default: -

A list of preferred languages. The "Auto Translator" first checks the preferred languages in order and if it finds a non-empty field, this text and the corresponding language are used as source for the translations. Afterwards the plugin tries to use the default language. If there was still no non-empty field then all the available languages are checked (random, order cannot be guaranteed).

autoTranslator.translationService

type: String, required: yes, default: -

The translation service to be used. Currently only "microsoft" is supported.

autoTranslator.microsoft.url

type: String, required: yes (if the microsoft service was selected), default: -

The URL to the microsoft translation service, e.g. https://api.cognitive.microsofttranslator.com/translate?api-version=3.0.

autoTranslator.microsoft.subscriptionKey

type: String, required: yes (if the microsoft service was selected), default: -

The subscription key delivered by the microsoft (see Installation).

Installation

  1. Create a Microsoft Azure account and sign in
  2. Switch to the portal
  3. Go to "all resources"
  4. Click "add"
  5. Enter "Translator Text" in the search box and then select from the results
  6. Select "create" to define the details for the subscription
  7. From the Pricing tier list, select the pricing tier that best fits your needs (up to 2.5M characters/month are free)
  8. Fill out the descriptive fields and click "create" to finish the subscription
  9. Go to "all resources" and open the subscription just created
  10. Click on "keys" and copy one of the keys into your properties file: autoTranslator.microsoft.subscriptionKey

Links

Release Notes

1.0.0

Released 2018-07-09

Initial Version

1.2.0

Released 2019-01-28

Added license