Dynamics Translation Service (プレビュー)

  • リファレンス

Dynamics Translation Service を利用した翻訳、整合、および再生成の操作。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Dynamics Translation Service
[URL] https://lcs.dynamics.com
メール dtssup@microsoft.com
Connector Metadata
発行者 Microsoft Corporation
Web サイト https://lcs.dynamics.com/
プライバシー ポリシー https://privacy.microsoft.com/privacystatement
カテゴリー コンテンツとファイル

Dynamics 365 Translation Service コネクタは、Power Platform と統合され、ユーザーはフローまたはアプリから DTS に直接アクセスできます。 このコネクタは、ユーザーに代わって DTS API を呼び出し、Web サイトにアクセスする手間を省きます。 このコネクタを使用すると、ユーザー インターフェイス (UI) ファイルの翻訳、翻訳要求の再生成、および翻訳メモリ (TM) ファイルの作成が可能になります。 これらの機能を活用することで、翻訳ワークフローを自動化できます。

前提条件

続行するには、次のものが必要です。

  • カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン。
  • Dynamics Lifecycle Services にアクセスできるアカウント。

資格情報の入手方法

このコネクタは、認証に Microsoft Entra ID アプリ経由の OAuth を使用します。 DTS は LCS に存在するため、アプリケーションに LCS API アクセス許可が必要です。 次の手順では、このコネクタで使用する Microsoft Entra ID アプリのアプリ登録プロセスについて説明します。

  1. LCS API との通信に使用されるユーザーとして、Azure portal にサインインします。
  2. Azure サービスで、アプリの登録 を選択します。
  3. アプリの登録 ページで、新しい登録 を選択します。
  4. アプリケーションの登録 ページの 名前 フィールドで、アプリ名を入力します。
  5. サポートされているアカウントの種類 で、サポートするアカウントを指定するオプションを選択します。
  6. 登録 を選択します。
  7. 新しいアプリ登録のページにある左ナビゲーション ウィンドウの 管理 で、アプリのアクセス許可 を選択します。
  8. API アクセス許可 ページで、アクセス許可の追加 を選択します。
  9. 組織が使用している API タブで、Dynamics Lifecycle services API を見つけて選択します。
  10. user_impersonation スコープを持つ API アクセス許可のチェックボックスを選択し、アクセス許可の追加 を選択します。
  11. アクセス許可に対する管理者の同意を付与するボタンを選択します。 アクションの確認を求められたら、はい を選択します。
  12. 左側のナビゲーション ウィンドウの 管理で、認証 を選択します。
  13. 認証 ページの 詳細設定 で、パブリック クライアント フローを許可する オプションを はい に設定します。
  14. 左側のナビゲーション ウィンドウで、概要を選択します。
  15. アプリの登録の概要ページには、クライアント ID が表示されます。
  16. 左側のナビゲーション ペインで 証明書とシークレット を選択します。 ここから、接続の設定に必要なクライアント シークレットを生成できます。

コネクタの使用を開始する

  1. DTS アセットをコネクタからアクセスできる場所に保存します。 たとえば、OneDrive にアップロードし、OneDrive コネクタを使用してファイルを取得することができます。
  2. シナリオに応じて、翻訳、整合、再生成のいずれかのアクションから開始します。 いずれの場合も、リソースまたは翻訳メモリ ファイルを含む zip ファイルを提供する必要があります。 翻訳または再生成する場合、「翻訳結果をダウンロード」、または「整合結果をダウンロード」の操作を使用して、結果を取得できます。
  3. 翻訳、整合、および再生成の入力は、Web UI と同じです。 他のすべての操作の入力は、これらからの出力になります。

既知の問題と制限事項

  • ユーザー インターフェイス要求のみがサポートされます。
  • 整合操作は整合ファイルの URL を返しますが、整合のダウンロード操作はファイル名を入力として受け取ります。 整合操作を使用する前に、URL を操作してファイル名を抽出する必要があります。

一般的なエラーと解決策

  • 状態コード 200 の要求は、必ずしも成功を示すわけではありません。 予期しない結果が発生した場合は、応答本文を確認してください 
    {
"status": "InvalidSourceLanguage",
"message": "The source language either does not match the product, or does not exist."
}

接続を作成する

このコネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

Align

整合ツールを使用して、以前に翻訳されたネイティブ ファイルから翻訳メモリ ファイルを作成します。
Retrieve

翻訳要求の状態をポーリングします。
再生成

更新された翻訳メモリを使用して翻訳を再生成します。
整合結果をダウンロード

整合結果をダウンロードします。
翻訳

新しい翻訳要求を送信します。
翻訳結果をダウンロード

翻訳要求の出力をダウンロードします。

Align

操作 ID:
Align

整合ツールを使用して、以前に翻訳されたネイティブ ファイルから翻訳メモリ ファイルを作成します。

パラメーター

名前 キー 必須 型 説明
Product Type
 productType True string

製品タイプを選択します。
製品バージョン
 productVersion True string

製品バージョンを選択します。
ソース言語
 sourceLanguage True string

翻訳のソース言語。
ターゲット言語
 targetLanguage True string

翻訳のターゲット言語。
ソース ファイル
 sourceFile True binary

ネイティブ リソース ファイル。
Target File
 targetFile True binary

ネイティブ ターゲット ファイル。

戻り値

名前 パス 型 説明
ステータス
 status string

要求の状態を説明する文字列。
message
 message string

要求の状態を説明する文字列。
Alignment Rate
 alignmentRate float

翻訳ソースとターゲットの翻訳単位が一致した割合。
Aligned File URL
 alignedFile string

整合出力を取得するためのURL。

Retrieve

操作 ID:
Retrieve

翻訳要求の状態をポーリングします。

パラメーター

名前 キー 必須 型 説明
Translation ID
 translationId True integer

ポーリングする翻訳の ID。

戻り値

名前 パス 型 説明
ステータス
 status string

要求の状態を説明する文字列。
message
 message string

状態を詳しく説明する文字列。
parentTranslationID
 parentTranslationID integer

この翻訳要求が属するプロジェクト。
requestName
 requestName string

翻訳要求の名前。
productType
 productType integer

ファイルが翻訳された製品。
productVersion
 productVersion integer

ファイルが翻訳された製品のバージョン。
translationType
 translationType string

翻訳の種類: ドキュメントまたはユーザー インターフェイスのいずれか。
sourceLanguage
 sourceLanguage string

言語ファイルの翻訳元。
targetLanguage
 targetLanguage string

言語ファイルの翻訳先。

再生成

操作 ID:
Regenerate

更新された翻訳メモリを使用して翻訳を再生成します。

パラメーター

名前 キー 必須 型 説明
Translation ID
 translationId True integer

再生成する翻訳の ID。
Regenerate File
 regenerateFile True binary

改訂された翻訳メモリ ファイルを含む ZIP ファイル。

戻り値

名前 パス 型 説明
ステータス
 status string

要求の状態を説明する文字列。
message
 message string

状態を詳しく説明する文字列。

整合結果をダウンロード

操作 ID:
AlignDownload

整合結果をダウンロードします。

パラメーター

名前 キー 必須 型 説明
File name
 filename True string

整合出力で返されたファイル名。

戻り値

整合出力からのバイナリ ファイル コンテンツ。

File Output
binary

翻訳

操作 ID:
Translate

新しい翻訳要求を送信します。

パラメーター

名前 キー 必須 型 説明
Product Type
 productType True string

製品タイプを選択します。
製品バージョン
 productVersion True string

製品バージョンを選択します。
ソース言語
 sourceLanguage True string

翻訳元の言語。
ターゲット言語
 targetLanguage True string

翻訳先の言語。
要求名
 requestName True string

翻訳要求の名前。
Translation Type
 translationType True string

翻訳の種類。 現在、UI 翻訳のみがサポートされています。
Source Files
 sourceFile True binary

翻訳するファイルを含む ZIP ファイル。
Custom MT Model
 trainMTWithTM boolean

アップロードされた翻訳メモリ ファイルに基づいてカスタム MT システムを作成します。
Translation Memory files
 tmFile binary

翻訳メモリ ファイルを含む ZIP ファイル。

戻り値

名前 パス 型 説明
ステータス
 status string

要求の状態を説明する文字列。
message
 message string

状態を詳しく説明する文字列。
translationId
 translationId integer

検索やダウンロードの操作に使用される、翻訳要求 ID。

翻訳結果をダウンロード

操作 ID:
Download

翻訳要求の出力をダウンロードします。

パラメーター

名前 キー 必須 型 説明
Download Type
 downloadType True string

ダウンロードの種類。
Translation ID
 translationId True integer

トランザクション ID。 この値は、翻訳操作の出力から取得します。

戻り値

翻訳出力からのバイナリ ファイル コンテンツ。

ファイル内容
binary

定義

binary

これは基本的なデータ型 'バイナリ' です。