Dynamics Translation Service (Vorschau)
Übersetzungs-, Ausrichtungs- und Regenerationsvorgänge, die von Dynamics Translation Service unterstützt werden.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Dynamics Translation Service |
| URL | https://lcs.dynamics.com |
| dtssup@microsoft.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft Corporation |
| Webseite | https://lcs.dynamics.com/ |
| Datenschutzrichtlinie | https://privacy.microsoft.com/privacystatement |
| Kategorien | Inhalt und Dateien |
Der Dynamics 365 Translation Service-Connector ist in die Power Platform integriert, sodass Benutzer direkt über einen Flow oder eine App auf DTS zugreifen können. Dieser Connector ruft die DTS-API im Namen des Benutzers auf und speichert sie eine Reise zur Website. Dieser Connector ermöglicht das Übersetzen von Benutzeroberflächendateien, das Generieren von Übersetzungsanforderungen und das Erstellen von TM-Dateien (Translation Memory). Durch die Nutzung dieser Funktionen können Sie Ihren Übersetzungsworkflow automatisieren.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature.
- Ein Konto mit Zugriff auf Dynamics Lifecycle Services.
So erhalten Sie Anmeldeinformationen
Dieser Connector verwendet OAuth über eine Microsoft Entra ID-App für die Authentifizierung. Da SICH DTS in LCS befindet, benötigen Sie LCS-API-Berechtigungen in Ihrer Anwendung. Das folgende Verfahren führt Sie durch den App-Registrierungsprozess für eine Microsoft Entra ID-App für die Verwendung mit diesem Connector.
- Melden Sie sich beim Azure-Portal als Benutzer an, der für die Kommunikation mit der LCS-API verwendet wird.
- Wählen Sie unter Azure-Dienste die Option App-Registrierungen aus.
- Wählen Sie im Menüband auf der Seite App-Registrierungen die Option Neue Registrierung aus.
- Geben Sie auf der Seite " Anwendung registrieren " im Feld "Name " einen Namen für die App ein.
- Wählen Sie unter "Unterstützte Kontotypen" eine Option aus, um anzugeben, welche Konten unterstützt werden sollen.
- Wählen Sie Registrieren aus.
- Wählen Sie auf der Seite für Ihre neue App-Registrierung im linken Navigationsbereich unter "Verwalten" API-Berechtigungen aus.
- Wählen Sie auf der Seite "API-Berechtigungen" die Option "Berechtigung hinzufügen" aus.
- Suchen Und wählen Sie auf den APIs, die meine Organisation verwendet , die Dynamics Lifecycle-Dienste-API aus.
- Aktivieren Sie das Kontrollkästchen für die API-Berechtigung, die über den user_impersonation Bereich verfügt, und wählen Sie dann "Berechtigungen hinzufügen" aus.
- Wählen Sie die Schaltfläche aus, um der Administratorzustimmung für die Berechtigungen zu erteilen. Wenn Sie aufgefordert werden, die Aktion zu bestätigen, wählen Sie "Ja" aus.
- Wählen Sie im linken Navigationsbereich unter "Verwalten" die Option "Authentifizierung" aus.
- Legen Sie auf der Seite " Authentifizierung " unter "Erweiterte Einstellungen" die Option " Öffentliche Clientflüsse zulassen " auf "Ja" fest.
- Wählen Sie im linken Navigationsbereich die Option "Übersicht" aus.
- Auf der Übersichtsseite für Ihre App-Registrierung wird die Client-ID angezeigt.
- Wählen Sie im linken Navigationsbereich Zertifikate und Geheime Schlüssel aus. Von hier aus können Sie den geheimen Clientschlüssel generieren, der zum Einrichten der Verbindung erforderlich ist.
Erste Schritte mit Ihrem Connector
- Speichern Sie Ihre DTS-Ressourcen an einer beliebigen Stelle, von der aus über den Connector zugegriffen werden kann. Sie können sie beispielsweise auf OneDrive hochladen und den OneDrive-Connector verwenden, um Ihre Dateien abzurufen.
- Je nach Szenario möchten Sie entweder mit den Aktionen "Übersetzen", "Ausrichten" oder "Neu generieren" beginnen. In jedem Fall müssen Sie eine ZIP-Datei mit den Ressourcen- oder Übersetzungsspeicherdateien bereitstellen. Beim Übersetzen oder Erneuten Generieren können Sie die Ergebnisse mithilfe der Downloadübersetzungsergebnis- oder Downloadausrichtungsergebnis-Vorgänge abrufen.
- Die Eingabe für Übersetzung, Ausrichtung und Regeneration ist identisch mit der Web-UI. Die Eingabe für alle anderen Vorgänge ist die Ausgabe dieser Vorgänge.
Bekannte Probleme und Einschränkungen
- Es werden nur Benutzeroberflächenanforderungen unterstützt.
- Der Align-Vorgang gibt eine URL für die Ausrichtungsdatei zurück, aber der Downloadausrichtungsvorgang verwendet den Dateinamen als Eingabe. Sie müssen die URL bearbeiten, um den Dateinamen zu extrahieren, bevor Sie den Align-Vorgang verwenden.
Häufige Fehler und Abhilfemaßnahmen
- Eine Anforderung mit Statuscode 200 weist nicht immer auf Erfolg hin. Überprüfen Sie den Antworttext bei unerwarteten Ergebnissen.
{ "status": "InvalidSourceLanguage", "message": "The source language either does not match the product, or does not exist." }
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Align |
Verwenden Sie das Tool "Ausrichten", um eine Übersetzungsspeicherdatei aus zuvor übersetzten nativen Dateien zu erstellen. |
| Downloadausrichtungsergebnis |
Laden Sie das Ausrichtungsergebnis herunter. |
| Gerätehandle |
Abrufen des Status einer Übersetzungsanforderung. |
| Neu generieren |
Generieren Sie eine Übersetzung mithilfe aktualisierter Übersetzungserinnerungen neu. |
| Translate |
Senden Sie eine neue Übersetzungsanforderung. |
| Übersetzungsergebnis herunterladen |
Laden Sie die Ausgabe einer Übersetzungsanforderung herunter. |
Align
Verwenden Sie das Tool "Ausrichten", um eine Übersetzungsspeicherdatei aus zuvor übersetzten nativen Dateien zu erstellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Produkttyp
|
productType | True | string |
Wählen Sie den Produkttyp aus. |
|
Produktversion
|
productVersion | True | string |
Wählen Sie die Produktversion aus. |
|
Ausgangssprache
|
sourceLanguage | True | string |
Übersetzungsquellensprache. |
|
Zielsprache
|
targetLanguage | True | string |
Übersetzungszielsprache. |
|
Quelldatei
|
sourceFile | True | binary |
Native Ressourcendatei. |
|
Zieldatei
|
targetFile | True | binary |
Native Zieldatei. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | string |
Zeichenfolge, die den Status der Anforderung beschreibt. |
|
message
|
message | string |
Zeichenfolge, die den Status der Anforderung beschreibt. |
|
Ausrichtungsrate
|
alignmentRate | float |
Prozentsatz der übereinstimmenen Übersetzungsquellen und Zielübersetzungseinheiten. |
|
Ausgerichtete Datei-URL
|
alignedFile | string |
URL zum Abrufen der Ausrichtungsausgabe. |
Downloadausrichtungsergebnis
Laden Sie das Ausrichtungsergebnis herunter.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dateiname
|
filename | True | string |
Der in der Ausrichtungsausgabe zurückgegebene Dateiname. |
Gibt zurück
Binärdateiinhalt aus Ausrichtungsausgabe.
- Dateiausgabe
- binary
Gerätehandle
Abrufen des Status einer Übersetzungsanforderung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Übersetzungs-ID
|
translationId | True | integer |
ID der Übersetzung, die Sie abfragen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | string |
Zeichenfolge, die den Status der Anforderung beschreibt. |
|
message
|
message | string |
Zeichenfolgen, die für den Status ausgearbeitet werden. |
|
parentTranslationID
|
parentTranslationID | integer |
Das Projekt, zu dem diese Übersetzungsanforderung gehört. |
|
requestName
|
requestName | string |
Der Name der Übersetzungsanforderung. |
|
Produkttyp
|
productType | integer |
Das Produkt, für das die Dateien übersetzt wurden. |
|
productVersion
|
productVersion | integer |
Die Version des Produkts, für das die Dateien übersetzt wurden. |
|
translationType
|
translationType | string |
Der Übersetzungstyp: Dokumention oder Benutzeroberfläche. |
|
sourceLanguage
|
sourceLanguage | string |
Die Sprachdateien wurden übersetzt. |
|
targetLanguage
|
targetLanguage | string |
Die Sprachdateien wurden übersetzt. |
Neu generieren
Generieren Sie eine Übersetzung mithilfe aktualisierter Übersetzungserinnerungen neu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Übersetzungs-ID
|
translationId | True | integer |
ID der Übersetzung, die Sie neu generieren. |
|
Datei neu generieren
|
regenerateFile | True | binary |
ZIP-Datei mit überarbeiteter Übersetzungsspeicherdatei(n). |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | string |
Zeichenfolge, die den Status der Anforderung beschreibt. |
|
message
|
message | string |
Zeichenfolgen, die für den Status ausgearbeitet werden. |
Translate
Senden Sie eine neue Übersetzungsanforderung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Produkttyp
|
productType | True | string |
Wählen Sie den Produkttyp aus. |
|
Produktversion
|
productVersion | True | string |
Wählen Sie die Produktversion aus. |
|
Ausgangssprache
|
sourceLanguage | True | string |
Sprache, aus der übersetzt werden soll. |
|
Zielsprache
|
targetLanguage | True | string |
Sprache, in die übersetzt werden soll. |
|
Anforderungsname
|
requestName | True | string |
Name für die Übersetzungsanforderung. |
|
Übersetzungstyp
|
translationType | True | string |
Der Übersetzungstyp. Derzeit werden nur UI-Übersetzungen unterstützt. |
|
Quelldateien
|
sourceFile | True | binary |
Zip-Datei mit zu übersetzenden Dateien. |
|
Benutzerdefiniertes MT-Modell
|
trainMTWithTM | boolean |
Erstellen Sie ein benutzerdefiniertes MT-System basierend auf hochgeladenen Übersetzungsspeicherdateien. |
|
|
Übersetzungsspeicherdateien
|
tmFile | binary |
Zip-Datei mit Übersetzungsspeicherdateien. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | string |
Zeichenfolge, die den Status der Anforderung beschreibt. |
|
message
|
message | string |
Zeichenfolgen, die für den Status ausgearbeitet werden. |
|
translationId
|
translationId | integer |
Die Übersetzungsanforderungs-ID, die Abruf- und Downloadvorgänge verwendet. |
Übersetzungsergebnis herunterladen
Laden Sie die Ausgabe einer Übersetzungsanforderung herunter.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Downloadtyp
|
downloadType | True | string |
Der Downloadtyp. |
|
Übersetzungs-ID
|
translationId | True | integer |
Die Übersetzungs-ID. Rufen Sie diesen Wert aus der Ausgabe des Übersetzungsvorgangs ab. |
Gibt zurück
Binäre Dateiinhalte aus der Übersetzungsausgabe.
- Inhalt der Datei
- binary
Definitionen
binär
Dies ist der grundlegende Datentyp "binary".