Dynamics Translation Service (Preview)

Translation, Alignment, and Regeneration operations powered by Dynamics Translation Service.

This connector is available in the following products and regions:

The Dynamics 365 Translation Service connector integrates with the Power Platform, enabling users to access DTS directly from a flow or app. This connector calls the DTS API on its user's behalf, saving them a trip to the website. This connector allows for translating user interface (UI) files, regenerating translation requests, and creating translation memory (TM) files. By leveraging these functionalities, you will be able to automate your translation workflow.

Prerequisites

You will need the following to proceed:

• A Microsoft Power Apps or Power Automate plan with custom connector feature.
• An account with access to Dynamics Lifecycle Services.

How to get credentials

This connector uses OAuth via an Microsoft Entra ID app for authentication. Since DTS resides in LCS, you need LCS API permissions in your application. The following procedure guides you through the app registration process for an Microsoft Entra ID app for use with this connector.

1. Sign in to the Azure portal as the user who will be used to communicate with the LCS API.
2. Under Azure services, select App registrations.
3. On the App registrations page, select New registration.
4. On the Register an application page, in the Name field, enter a name for the app.
5. Under Supported account types, select an option to specify which accounts should be supported.
6. Select Register.
7. On the page for your new app registration, in the left navigation pane, under Manage, select API permissions.
8. On the API permissions page, select Add a permission.
9. On the APIs my organization uses tab, find and select the Dynamics Lifecycle services API.
10. Select the checkbox for the API permission that has the user_impersonation scope, and then select Add permissions.
11. Select the button to grant admin consent for the permissions. When you're prompted to confirm the action, select Yes.
12. In the left navigation pane, under Manage, select Authentication.
13. On the Authentication page, under Advanced settings, set the Allow public client flows option to Yes.
14. In the left navigation pane, select Overview.
15. The overview page for your app registration shows the client ID.
16. In the left navigation pane, select Certificates & secrets. From here, you can generate the client secret needed to set up the connection.

Get started with your connector

1. Store your DTS assets somewhere from which they may be accessed from the connector. For example, you may upload them to OneDrive and use the OneDrive connector to retrieve your files.
2. Depending on your scenario, you will want to start with either the Translate, Align, or Regenerate actions. In any case, you will need to provide a zip file with the resource or translation memory files. When translating or regenerating, you may use the Download Translation Result or Download Alignment Result operations to retrieve the results.
3. The input for Translation, Alignment, and Regeneration are the same as in the Web UI. The input for all other operations will be the output from these.

Known issues and limitations

• Only user interface requests are supported.
• The Align operation returns a URL for the alignment file, but the download alignment operation takes the filename as input. You will need to manipulate the URL to extract the filename before using the Align operation.

Common errors and remedies

• A request with status code 200 does not always indicate success. Please check the response body in case of unexpected results

  {
  "status": "InvalidSourceLanguage",
  "message": "The source language either does not match the product, or does not exist."
  }
  

Creating a connection

The connector supports the following authentication types:

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Actions

Align

Download Alignment Result

Download Translation Result

Regenerate

Retrieve

Translate

Definitions

binary