Dynamics Translation Service (preview)
Vertaal-, uitlijnings- en regeneratiebewerkingen mogelijk gemaakt door Dynamics Translation Service.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Dynamics Translation Service |
| URL | https://lcs.dynamics.com |
| E-mailen | dtssup@microsoft.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft Corporation |
| Webpagina | https://lcs.dynamics.com/ |
| Privacybeleid | https://privacy.microsoft.com/privacystatement |
| Categorieën | Inhoud en bestanden |
De Dynamics 365 Translation Service-connector kan worden geïntegreerd met Power Platform, zodat gebruikers rechtstreeks vanuit een stroom of app toegang hebben tot DTS. Deze connector roept de DTS-API namens de gebruiker aan en slaat deze een reis naar de website op. Met deze connector kunt u gebruikersinterfacebestanden (UI)-bestanden vertalen, vertaalaanvragen opnieuw genereren en TM-bestanden (Translation Memory) maken. Door gebruik te maken van deze functies, kunt u uw vertaalwerkstroom automatiseren.
Vereiste voorwaarden
U hebt het volgende nodig om door te gaan:
- Een Microsoft Power Apps- of Power Automate-abonnement met aangepaste connectorfunctie.
- Een account met toegang tot Dynamics Lifecycle Services.
Referenties ophalen
Deze connector maakt gebruik van OAuth via een Microsoft Entra ID-app voor verificatie. Omdat DTS zich in LCS bevindt, hebt u LCS API-machtigingen in uw toepassing nodig. In de volgende procedure wordt u begeleid bij het registratieproces van de app voor een Microsoft Entra ID-app voor gebruik met deze connector.
- Meld u aan bij Azure Portal als de gebruiker die wordt gebruikt om te communiceren met de LCS-API.
- Selecteer onder Azure-services de optie App-registraties.
- Selecteer op de pagina App-registratiesNieuwe registratie.
- Voer op de pagina Een toepassing registreren in het veld Naam een naam in voor de app.
- Selecteer onder Ondersteunde accounttypen een optie om op te geven welke accounts moeten worden ondersteund.
- Selecteer Registreren.
- Selecteer api-machtigingen in het linkernavigatiedeelvenster onder Beheren op de pagina voor de registratie van uw nieuwe app.
- Selecteer Een machtiging toevoegen op de pagina API-machtigingen.
- Zoek en selecteer op het tabblad API's die mijn organisatie gebruikt de API voor Dynamics Lifecycle Services .
- Schakel het selectievakje in voor de API-machtiging met het user_impersonation bereik en selecteer vervolgens Machtigingen toevoegen.
- Selecteer de knop om beheerderstoestemming te verlenen voor de machtigingen. Wanneer u wordt gevraagd de actie te bevestigen, selecteert u Ja.
- Selecteer Verificatie in het linkernavigatiedeelvenster onder Beheren.
- Stel op de pagina Verificatie onder Geavanceerde instellingen de optie Openbare clientstromen toestaan in op Ja.
- Selecteer Overzicht in het linkernavigatiedeelvenster.
- Op de overzichtspagina voor uw app-registratie wordt de client-id weergegeven.
- Selecteer Certificaten en geheimen in het linkernavigatiedeelvenster. Hier kunt u het clientgeheim genereren dat nodig is om de verbinding in te stellen.
Aan de slag met uw connector
- Sla uw DTS-assets ergens op waar ze toegankelijk zijn via de connector. U kunt ze bijvoorbeeld uploaden naar OneDrive en de OneDrive-connector gebruiken om uw bestanden op te halen.
- Afhankelijk van uw scenario wilt u beginnen met de acties Vertalen, Uitlijnen of Opnieuw genereren. In elk geval moet u een zip-bestand opgeven met de bron- of vertaalgeheugenbestanden. Bij het vertalen of opnieuw genereren kunt u de bewerkingen Vertaalresultaat downloaden of Uitlijningsresultaat downloaden gebruiken om de resultaten op te halen.
- De invoer voor vertaling, uitlijning en regeneratie is hetzelfde als in de webgebruikersinterface. De invoer voor alle andere bewerkingen is de uitvoer van deze bewerkingen.
Bekende problemen en beperkingen
- Alleen aanvragen van gebruikersinterfaces worden ondersteund.
- De bewerking Uitlijnen retourneert een URL voor het uitlijningsbestand, maar de downloaduitlijningsbewerking neemt de bestandsnaam als invoer. U moet de URL bewerken om de bestandsnaam te extraheren voordat u de bewerking Uitlijnen gebruikt.
Veelvoorkomende fouten en oplossingen
- Een aanvraag met statuscode 200 duidt niet altijd op succes. Controleer de hoofdtekst van het antwoord in het geval van onverwachte resultaten
{ "status": "InvalidSourceLanguage", "message": "The source language either does not match the product, or does not exist." }
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Align |
Gebruik het hulpmiddel Uitlijnen om een vertaalgeheugenbestand te maken van eerder vertaalde systeemeigen bestanden. |
| Ophalen |
De status van een vertaalaanvraag peilen. |
| Opnieuw genereren |
Genereer een vertaling opnieuw met bijgewerkte vertaalgeheugens. |
| Translate |
Dien een nieuwe vertaalaanvraag in. |
| Uitlijningsresultaat downloaden |
Download het uitlijningsresultaat. |
| Vertaalresultaat downloaden |
Download de uitvoer van een vertaalaanvraag. |
Align
Gebruik het hulpmiddel Uitlijnen om een vertaalgeheugenbestand te maken van eerder vertaalde systeemeigen bestanden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Producttype
|
productType | True | string |
Selecteer het producttype. |
|
Productversie
|
productVersion | True | string |
Selecteer de productversie. |
|
Brontaal
|
sourceLanguage | True | string |
Vertaalbrontaal. |
|
Doeltaal
|
targetLanguage | True | string |
Doeltaal voor vertaling. |
|
Bronbestand
|
sourceFile | True | binary |
Systeemeigen bronbestand. |
|
Doelbestand
|
targetFile | True | binary |
Systeemeigen doelbestand. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
Tekenreeks die de status van de aanvraag beschrijft. |
|
message
|
message | string |
Tekenreeks die de status van de aanvraag beschrijft. |
|
Uitlijningsfrequentie
|
alignmentRate | float |
Percentage overeenkomende vertaalbronnen en doelomzettingseenheden. |
|
Uitgelijnde bestands-URL
|
alignedFile | string |
URL voor het ophalen van de uitvoer van de uitlijning. |
Ophalen
De status van een vertaalaanvraag peilen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertalings-id
|
translationId | True | integer |
Id van vertaling die u peilt. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
Tekenreeks die de status van de aanvraag beschrijft. |
|
message
|
message | string |
Tekenreeks die de status aangeeft. |
|
parentTranslationID
|
parentTranslationID | integer |
Het project waartoe deze vertaalaanvraag behoort. |
|
requestName
|
requestName | string |
De naam van de vertaalaanvraag. |
|
productType
|
productType | integer |
Het product waarvoor de bestanden zijn vertaald. |
|
productVersion
|
productVersion | integer |
De versie van het product waarvoor de bestanden zijn vertaald. |
|
translationType
|
translationType | string |
Het vertaaltype: documentie of gebruikersinterface. |
|
sourceLanguage
|
sourceLanguage | string |
De taalbestanden zijn vertaald uit. |
|
targetLanguage
|
targetLanguage | string |
De taalbestanden zijn vertaald in. |
Opnieuw genereren
Genereer een vertaling opnieuw met bijgewerkte vertaalgeheugens.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertalings-id
|
translationId | True | integer |
Id van vertaling die u opnieuw wilt genereren. |
|
Bestand opnieuw genereren
|
regenerateFile | True | binary |
ZIP-bestand met herziene vertaalgeheugenbestanden. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
Tekenreeks die de status van de aanvraag beschrijft. |
|
message
|
message | string |
Tekenreeks die de status aangeeft. |
Translate
Dien een nieuwe vertaalaanvraag in.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Producttype
|
productType | True | string |
Selecteer het producttype. |
|
Productversie
|
productVersion | True | string |
Selecteer de productversie. |
|
Brontaal
|
sourceLanguage | True | string |
Taal waaruit moet worden vertaald. |
|
Doeltaal
|
targetLanguage | True | string |
Taal om in te vertalen. |
|
Aanvraagnaam
|
requestName | True | string |
Naam voor de vertaalaanvraag. |
|
Vertaaltype
|
translationType | True | string |
Het vertaaltype. Momenteel worden alleen ui-vertalingen ondersteund. |
|
Bronbestanden
|
sourceFile | True | binary |
Zip-bestand met bestanden om te vertalen. |
|
Aangepast MT-model
|
trainMTWithTM | boolean |
Maak een aangepast MT-systeem op basis van geüploade vertaalgeheugenbestanden. |
|
|
Vertaalgeheugenbestanden
|
tmFile | binary |
Zip-bestand met vertaalgeheugenbestanden. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
Tekenreeks die de status van de aanvraag beschrijft. |
|
message
|
message | string |
Tekenreeks die de status aangeeft. |
|
translationId
|
translationId | integer |
De aanvraag-id van de vertaling, de gebruikte ophaal- en downloadbewerkingen. |
Uitlijningsresultaat downloaden
Download het uitlijningsresultaat.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Bestandsnaam
|
filename | True | string |
Bestandsnaam die wordt geretourneerd in de uitvoer van de uitlijning. |
Retouren
Binaire bestandsinhoud uit de uitvoer van uitlijning.
- Bestandsuitvoer
- binary
Vertaalresultaat downloaden
Download de uitvoer van een vertaalaanvraag.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Downloadtype
|
downloadType | True | string |
Het downloadtype. |
|
Vertalings-id
|
translationId | True | integer |
De vertaal-id. Haal deze waarde op uit de uitvoer van de vertaalbewerking. |
Retouren
Binaire bestandsinhoud van vertaaluitvoer.
- Bestandsinhoud
- binary
Definities
binair
Dit is het basisgegevenstype 'binair'.