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 アプリのアプリ登録プロセスについて説明します。
- LCS API との通信に使用されるユーザーとして、Azure portal にサインインします。
- Azure サービスで、アプリの登録 を選択します。
- アプリの登録 ページで、新しい登録 を選択します。
- アプリケーションの登録 ページの 名前 フィールドで、アプリ名を入力します。
- サポートされているアカウントの種類 で、サポートするアカウントを指定するオプションを選択します。
- 登録 を選択します。
- 新しいアプリ登録のページにある左ナビゲーション ウィンドウの 管理 で、アプリのアクセス許可 を選択します。
- API アクセス許可 ページで、アクセス許可の追加 を選択します。
- 組織が使用している API タブで、Dynamics Lifecycle services API を見つけて選択します。
- user_impersonation スコープを持つ API アクセス許可のチェックボックスを選択し、アクセス許可の追加 を選択します。
- アクセス許可に対する管理者の同意を付与するボタンを選択します。 アクションの確認を求められたら、はい を選択します。
- 左側のナビゲーション ウィンドウの 管理で、認証 を選択します。
- 認証 ページの 詳細設定 で、パブリック クライアント フローを許可する オプションを はい に設定します。
- 左側のナビゲーション ウィンドウで、概要を選択します。
- アプリの登録の概要ページには、クライアント ID が表示されます。
- 左側のナビゲーション ペインで 証明書とシークレット を選択します。 ここから、接続の設定に必要なクライアント シークレットを生成できます。
- DTS アセットをコネクタからアクセスできる場所に保存します。 たとえば、OneDrive にアップロードし、OneDrive コネクタを使用してファイルを取得することができます。
- シナリオに応じて、翻訳、整合、再生成のいずれかのアクションから開始します。 いずれの場合も、リソースまたは翻訳メモリ ファイルを含む zip ファイルを提供する必要があります。 翻訳または再生成する場合、「翻訳結果をダウンロード」、または「整合結果をダウンロード」の操作を使用して、結果を取得できます。
- 翻訳、整合、および再生成の入力は、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 |
翻訳要求の状態をポーリングします。 |
再生成 |
更新された翻訳メモリを使用して翻訳を再生成します。 |
整合結果をダウンロード |
整合結果をダウンロードします。 |
翻訳 |
新しい翻訳要求を送信します。 |
翻訳結果をダウンロード |
翻訳要求の出力をダウンロードします。 |
整合ツールを使用して、以前に翻訳されたネイティブ ファイルから翻訳メモリ ファイルを作成します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
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。 |
翻訳要求の状態をポーリングします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
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 |
言語ファイルの翻訳先。 |
更新された翻訳メモリを使用して翻訳を再生成します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Translation ID
|
translationId | True | integer |
再生成する翻訳の ID。 |
Regenerate File
|
regenerateFile | True | binary |
改訂された翻訳メモリ ファイルを含む ZIP ファイル。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
ステータス
|
status | string |
要求の状態を説明する文字列。 |
message
|
message | string |
状態を詳しく説明する文字列。 |
整合結果をダウンロードします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
File name
|
filename | True | string |
整合出力で返されたファイル名。 |
戻り値
整合出力からのバイナリ ファイル コンテンツ。
- File Output
- binary
新しい翻訳要求を送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
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。 |
翻訳要求の出力をダウンロードします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Download Type
|
downloadType | True | string |
ダウンロードの種類。 |
Translation ID
|
translationId | True | integer |
トランザクション ID。 この値は、翻訳操作の出力から取得します。 |
戻り値
翻訳出力からのバイナリ ファイル コンテンツ。
- ファイル内容
- binary
これは基本的なデータ型 'バイナリ' です。