Dynamics Translation Service (wersja zapoznawcza)
Operacje tłumaczenia, wyrównania i rewitalizacji obsługiwane przez usługę Dynamics Translation Service.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Dynamics Translation Service |
| adres URL | https://lcs.dynamics.com |
| dtssup@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft Corporation |
| Witryna internetowa | https://lcs.dynamics.com/ |
| Zasady ochrony prywatności | https://privacy.microsoft.com/privacystatement |
| Kategorie | Zawartość i pliki |
Łącznik usługi tłumaczenia usługi Dynamics 365 integruje się z platformą Power Platform, umożliwiając użytkownikom uzyskiwanie dostępu do usługi DTS bezpośrednio z przepływu lub aplikacji. Ten łącznik wywołuje interfejs API usługi DTS w imieniu użytkownika, zapisując im podróż do witryny internetowej. Ten łącznik umożliwia tłumaczenie plików interfejsu użytkownika(UI), ponowne generowanie żądań tłumaczenia i tworzenie plików pamięci tłumaczenia (TM). Korzystając z tych funkcji, możesz zautomatyzować przepływ pracy tłumaczenia.
Wymagania wstępne
Aby kontynuować, musisz wykonać następujące czynności:
- Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego.
- Konto z dostępem do usług Dynamics Lifecycle Services.
Jak uzyskać poświadczenia
Ten łącznik używa protokołu OAuth za pośrednictwem aplikacji Microsoft Entra ID do uwierzytelniania. Ponieważ usługa DTS znajduje się w usłudze LCS, potrzebujesz uprawnień interfejsu API LCS w aplikacji. Poniższa procedura przeprowadzi Cię przez proces rejestracji aplikacji dla aplikacji Microsoft Entra ID do użycia z tym łącznikiem.
- Zaloguj się do witryny Azure Portal jako użytkownik, który będzie używany do komunikowania się z interfejsem API LCS.
- W obszarze Usługi Azure wybierz pozycję Rejestracje aplikacji.
- Na stronie Rejestracje aplikacji wybierz pozycję Nowa rejestracja.
- Na stronie Rejestrowanie aplikacji w polu Nazwa wprowadź nazwę aplikacji.
- W obszarze Obsługiwane typy kont wybierz opcję, aby określić, które konta powinny być obsługiwane.
- Wybierz pozycję Zarejestruj.
- Na stronie rejestracji nowej aplikacji w okienku nawigacji po lewej stronie w obszarze Zarządzanie wybierz pozycję Uprawnienia interfejsu API.
- Na stronie Uprawnienia interfejsu API wybierz pozycję Dodaj uprawnienie.
- Na karcie Interfejsy API używane przez moją organizację znajdź i wybierz interfejs API usług Dynamics Lifecycle .
- Zaznacz pole wyboru uprawnienia interfejsu API, które ma zakres user_impersonation , a następnie wybierz pozycję Dodaj uprawnienia.
- Wybierz przycisk, aby udzielić zgody administratora dla uprawnień. Po wyświetleniu monitu o potwierdzenie akcji wybierz pozycję Tak.
- W okienku nawigacji po lewej stronie w obszarze Zarządzanie wybierz pozycję Uwierzytelnianie.
- Na stronie Uwierzytelnianie w obszarze Ustawienia zaawansowane ustaw opcję Zezwalaj na przepływy klientów publicznych na Wartość Tak.
- W okienku nawigacji po lewej stronie wybierz pozycję Przegląd.
- Na stronie przeglądu rejestracji aplikacji jest wyświetlany identyfikator klienta.
- W okienku nawigacji po lewej stronie wybierz pozycję Certyfikaty i wpisy tajne. W tym miejscu możesz wygenerować klucz tajny klienta wymagany do skonfigurowania połączenia.
Wprowadzenie do łącznika
- Przechowuj zasoby usługi DTS w dowolnym miejscu, z którego mogą być uzyskiwane dostęp z łącznika. Możesz na przykład przekazać je do usługi OneDrive i użyć łącznika usługi OneDrive do pobrania plików.
- W zależności od scenariusza należy rozpocząć od akcji Translate, Align lub Regenerate. W każdym razie należy podać plik zip z plikami pamięci zasobów lub tłumaczenia. Podczas tłumaczenia lub ponownego generowania można użyć operacji Pobierz wynik tłumaczenia lub Pobierz wynik wyrównania, aby pobrać wyniki.
- Dane wejściowe tłumaczenia, wyrównania i rewitalizacji są takie same jak w internetowym interfejsie użytkownika. Dane wejściowe dla wszystkich innych operacji będą danymi wyjściowymi tych operacji.
Znane problemy i ograniczenia
- Obsługiwane są tylko żądania interfejsu użytkownika.
- Operacja Align zwraca adres URL pliku wyrównania, ale operacja wyrównania pobierania przyjmuje nazwę pliku jako dane wejściowe. Aby wyodrębnić nazwę pliku przed użyciem operacji Wyrównaj, musisz manipulować adresem URL.
Typowe błędy i środki zaradcze
- Żądanie z kodem stanu 200 nie zawsze wskazuje powodzenie. Sprawdź treść odpowiedzi w przypadku nieoczekiwanych wyników
{ "status": "InvalidSourceLanguage", "message": "The source language either does not match the product, or does not exist." }
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Align |
Użyj narzędzia Wyrównaj, aby utworzyć plik pamięci tłumaczenia z wcześniej przetłumaczonych plików natywnych. |
| Odzyskaj |
Sonduj stan żądania tłumaczenia. |
| Pobierz wynik tłumaczenia |
Pobierz dane wyjściowe żądania tłumaczenia. |
| Pobierz wynik wyrównania |
Pobierz wynik wyrównania. |
| Ponownie wygeneruj |
Wygeneruj ponownie tłumaczenie przy użyciu zaktualizowanych pamięci tłumaczenia. |
| Translate |
Prześlij nowe żądanie tłumaczenia. |
Align
Użyj narzędzia Wyrównaj, aby utworzyć plik pamięci tłumaczenia z wcześniej przetłumaczonych plików natywnych.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typ produktu
|
productType | True | string |
Wybierz typ produktu. |
|
Wersja produktu
|
productVersion | True | string |
Wybierz wersję produktu. |
|
Język źródłowy
|
sourceLanguage | True | string |
Język źródłowy tłumaczenia. |
|
Język docelowy
|
targetLanguage | True | string |
Język docelowy tłumaczenia. |
|
Plik źródłowy
|
sourceFile | True | binary |
Plik zasobu natywnego. |
|
Plik docelowy
|
targetFile | True | binary |
Natywny plik docelowy. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | string |
Ciąg opisujący stan żądania. |
|
komunikat
|
message | string |
Ciąg opisujący stan żądania. |
|
Częstotliwość wyrównania
|
alignmentRate | float |
Procent dopasowanego źródła tłumaczenia i docelowych jednostek tłumaczenia. |
|
Wyrównany adres URL pliku
|
alignedFile | string |
Adres URL umożliwiający pobranie danych wyjściowych wyrównania. |
Odzyskaj
Sonduj stan żądania tłumaczenia.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator tłumaczenia
|
translationId | True | integer |
Identyfikator tłumaczeń, które sondujesz. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | string |
Ciąg opisujący stan żądania. |
|
komunikat
|
message | string |
Ciąg opracowując stan. |
|
parentTranslationID
|
parentTranslationID | integer |
Projekt, do którego należy to żądanie tłumaczenia. |
|
requestName
|
requestName | string |
Nazwa żądania tłumaczenia. |
|
productType
|
productType | integer |
Produkt, dla którego przetłumaczono pliki. |
|
productVersion
|
productVersion | integer |
Wersja produktu, dla którego zostały przetłumaczone pliki. |
|
translationType
|
translationType | string |
Typ tłumaczenia: dokumentacja lub interfejs użytkownika. |
|
sourceLanguage
|
sourceLanguage | string |
Pliki językowe zostały przetłumaczone. |
|
targetLanguage
|
targetLanguage | string |
Pliki językowe zostały przetłumaczone na. |
Pobierz wynik tłumaczenia
Pobierz dane wyjściowe żądania tłumaczenia.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typ pobierania
|
downloadType | True | string |
Typ pobierania. |
|
Identyfikator tłumaczenia
|
translationId | True | integer |
Identyfikator tłumaczenia. Pobierz tę wartość z danych wyjściowych operacji tłumaczenia. |
Zwraca
Zawartość pliku binarnego z danych wyjściowych tłumaczenia.
- Zawartość pliku
- binary
Pobierz wynik wyrównania
Pobierz wynik wyrównania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa pliku
|
filename | True | string |
Nazwa pliku zwrócona w danych wyjściowych wyrównania. |
Zwraca
Zawartość pliku binarnego z danych wyjściowych wyrównania.
- Dane wyjściowe pliku
- binary
Ponownie wygeneruj
Wygeneruj ponownie tłumaczenie przy użyciu zaktualizowanych pamięci tłumaczenia.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator tłumaczenia
|
translationId | True | integer |
Identyfikator tłumaczeń, które generujesz ponownie. |
|
Ponowne generowanie pliku
|
regenerateFile | True | binary |
Plik ZIP ze zmienionymi plikami pamięci tłumaczenia. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | string |
Ciąg opisujący stan żądania. |
|
komunikat
|
message | string |
Ciąg opracowując stan. |
Translate
Prześlij nowe żądanie tłumaczenia.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typ produktu
|
productType | True | string |
Wybierz typ produktu. |
|
Wersja produktu
|
productVersion | True | string |
Wybierz wersję produktu. |
|
Język źródłowy
|
sourceLanguage | True | string |
Język do tłumaczenia. |
|
Język docelowy
|
targetLanguage | True | string |
Język do tłumaczenia. |
|
Nazwa żądania
|
requestName | True | string |
Nazwa żądania tłumaczenia. |
|
Typ tłumaczenia
|
translationType | True | string |
Typ tłumaczenia. Obecnie obsługiwane są tylko tłumaczenia interfejsu użytkownika. |
|
Pliki źródłowe
|
sourceFile | True | binary |
Plik zip zawierający pliki do tłumaczenia. |
|
Niestandardowy model MT
|
trainMTWithTM | boolean |
Utwórz niestandardowy system MT na podstawie przekazanych plików pamięci tłumaczenia. |
|
|
Pliki pamięci tłumaczenia
|
tmFile | binary |
Plik zip zawierający pliki pamięci tłumaczenia. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | string |
Ciąg opisujący stan żądania. |
|
komunikat
|
message | string |
Ciąg opracowując stan. |
|
translationId
|
translationId | integer |
Identyfikator żądania tłumaczenia, używane operacje pobierania i pobierania. |
Definicje
binarny
Jest to podstawowy typ danych "binary".