Skip to main content
Version: 12.0

Integrate Machine Translation Service into ADONIS

Integrate a machine translation (MT) service into ADONIS to allow web client users to auto-translate models and objects. All MT services are web-based. Therefore, the machine running the ADONIS web application must be able to connect to the Internet.

Currently, ADONIS supports integration of Microsoft Translator out of the box. If you want to integrate a different MT service into ADONIS, please do not hesitate to contact your ADONIS consultant.

Integrate Microsoft Translator#

A successful integration of Microsoft Translator into ADONIS requires the following steps:

Assign Web Module to System Roles

Assign the following web module for all users or for certain system roles in the Administration Toolkit:

  • Translation Service Microsoft
note

How to assign web modules is described in the Administration Manual.

Sign up for Microsoft Translator and get credentials

In order to sign up for Microsoft Translator and get credentials:

  • Create a Microsoft Azure account (unless you already have one).

  • Go to http://portal.azure.com and sign in to the Azure portal.

  • Add a Microsoft Translator API subscription to your Azure account (API type "Translator Text API"). You can subscribe to the free 2,000,000 characters/month level to get started.

  • Your credentials consist of a key to access the service.

Adapt the Apache Tomcat Web Server

Adapt the settings for the login procedure on the web server side:

  • Open the folder “<Tomcat installation>/webapps“ and open the file ADONIS12_0.war with a file archiver. Edit the file adoxx_web.properties which can be found inside. Save the changes afterwards.

The configuration parameters that have to be adapted are listed below:

  • translationsvc.microsoft.azure.api.key

    Enter the key to access the Microsoft Translator service. The key must be encrypted with an encryption tool which can be found in the directory "03 Web Client\03 Tools\02 Password Encryption Tool" on the installation medium.

When using a multi-service subscription key with the Microsoft Translator service, you must include the region:

  • translationsvc.microsoft.azure.region

    Enter the subscription region of your multi-service subscription key.

note

For a list of regions, see the Microsoft Azure documentation.

When using Azure Active Directory (AAD) for authentication, you must include the subdomain:

  • translationsvc.microsoft.azure.subdomain

    Enter the subdomain associated with your resource.

If a proxy server is in use, the following additional settings have to be adapted:

  • http_proxy_ip

    Enter the IP address of your proxy server.

  • http_proxy_port

    Enter the port of your proxy server.

Done! Stop the Apache Tomcat web server and delete the folder “<Tomcat installation>/webapps/ADONIS12_0“. The machine must be able to connect to the Internet now. Restart the Apache Tomcat web server. You can use Microsoft Translator in the web client now.