Amazon Translate

1 Introduction

The Amazon Translate connector enables you to connect your app to Amazon Translate and build web applications that work with state-of-the-art multi-language text translation.

1.1 Typical Use Cases

Amazon Translate is a neural machine translation service that delivers fast, high-quality, affordable, and customizable language translation. Neural machine translation is a form of language translation automation that uses deep learning models to deliver more accurate and more natural sounding translation than traditional statistical and rule-based translation algorithms. With Amazon Translate, you can localize content such as websites and applications for your diverse users, easily translate large volumes of text for analysis, and efficiently enable cross-lingual communication between users.

1.2 Prerequisites

The Amazon Translate connector requires Mendix Studio Pro 9.18.0 or above.

To authenticate with Amazon Web Service (AWS), you must also install and configure the AWS authentication connector. If you are using the Amazon Translate Connector version 2.0 or higher, it requires the AWS Authentication connector version 3.0 or higher. For more information about installing and configuring the AWS Authentication connector, see AWS Authentication.

1.3 Licensing and Cost

This connector is available as a free download from the Mendix Marketplace, but the AWS service to which is connects may incur a usage cost. For more information, refer to AWS documentation.

Depending on your use case, your deployment environment, and the type of app that you want to build, you may also need a license for your Mendix app. For more information, refer to Licensing Apps.

2 Installation

Follow the instructions in Using Marketplace Content to import the Amazon Translate connector into your app.

3 Configuration

After you install the connector, you can find it in the App Explorer, in the AmazonTranslateConnector section. The connector provides the domain model and activities that you can use to implement automatic translation for your app.

3.1 Configuring AWS Authentication

In order to use the Amazon Translate service, you must authenticate with AWS. To do so, you must set up a configuration profile in your Mendix app. After you set up the configuration profile, the connector module handles the authentication internally.

As of version 3.0.0 of the AWS Authentication Connector, all the resources and logic required to set up authentication are centralized inside the AWS Authentication Connector module.

The AWS Authentication Connector supports both static credentials and temporary credentials. For more information and detailed instructions please refer to the AWS Authentication Connector documentation page.

4 Technical Reference

To help you work with the Amazon Translate connector, the following sections of this document list the available entities, enumerations, and actions that you can use in your application.

4.1 Domain model

The domain model is a data model that describes the information in your application domain in an abstract way. For more information, see Domain Model.

4.1.1 ListLanguagesRequest

4.1.2 ListLanguagesResponse

4.1.3 Language

4.1.4 TranslateTextRequest

4.1.5 TranslateTextResponse

4.2 Activities

Activities define the actions that are executed in a microflow or a nanoflow.

4.2.1 ListLanguages

The ListLanguages Amazon Translate action allow you to retrieve a list of supported languages that can used for translation. It requires a valid ENUM_Region and Credentials object, as well as a ListLanguagesRequest object and returns a ListLanguagesResponse object. The input and output for this service are shown in the table below:

4.2.2 TranslateText

The TranslateText Amazon Translate action allow you to retrieve the translation of the input text. It requires a valid ENUM_Region and Credentials object, as well as a TranslateTextRequest object and returns a TranslateTextResponse object. The input and output for this service are shown in the table below: