Microsoft Machine Translator connector
Overview
The Translation module provides an out-of-the-box Microsoft Machine Translator connector with a quick setup, which enables you to utilize Azure AI Translator service. This is a neural machine translation service that you use to translate text and documents instantly or in batches (across a broad range of supported languages).
Create a Translator resource
To configure this connector, you must first sign up for Azure AI Translator v3 service in Microsoft Azure portal.
You need an endpoint URL and a resource key generated for authenticating requests to the Azure AI Translator service API.
For detailed instructions, see Microsoft documentation » Create a Translator resource.
Configure the connector
To configure the connector in Sitefinity CMS backend, perform the following:
- From Sitefinity NuGet Repository, download and install
Progress.Sitefinity.Translations.MicrosoftMachineTranslatorConnector NuGet package.
- Build and run your project.
- In Sitefinity CMS backend, navigate to Administration » Settings » Advanced » Translations » Connectors » MicrosoftMachineTranslatorConnector » Parameters.
- Set the
apiKey parameter to the resource key generated by the Azure AI Translator.
- Set the
baseURL parameter to one of the endpoint URLs supported by the Azure AI Translator API.
For more information, see Microsoft documentation » Translator v3.0 » Base URLs.
If you do not configure the baseURL parameter, the system uses the Global (non-regional) base URL.
- Set the
region parameter to one of the regions supported by the Azure AI Translator API.
If you have not changed the default base URL, you do not need to configure the region parameter.
For more information, see Microsoft documentation » Authenticate requests to Azure AI services » Supported regions.
NOTE: The Azure geography of the base URL must include the region that you have configured.
- Optionally, you may configure additional parameters of the Azure AI Translator service.
For more information, see Microsoft documentation » Translator v3.0 » Optional parameters.
To do this, click queryString on the left and then in Value, enter the additional parameters.
NOTE: You should format the string in the Value field using the query string format without the leading ? or & characters. Use & to separate the added parameters.
-
Navigate back to MicrosoftMachineTranslatorConnector.
- Select the Enabled checkbox to activate the connector.
- Deselect the Strip HTML tags checkbox.
- Save your changes.
RESULT: The connector appears as an option in the Translation service dropdown box when you are sending items for translation.