Udostępnij przez


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
Email 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.

  1. Zaloguj się do witryny Azure Portal jako użytkownik, który będzie używany do komunikowania się z interfejsem API LCS.
  2. W obszarze Usługi Azure wybierz pozycję Rejestracje aplikacji.
  3. Na stronie Rejestracje aplikacji wybierz pozycję Nowa rejestracja.
  4. Na stronie Rejestrowanie aplikacji w polu Nazwa wprowadź nazwę aplikacji.
  5. W obszarze Obsługiwane typy kont wybierz opcję, aby określić, które konta powinny być obsługiwane.
  6. Wybierz pozycję Zarejestruj.
  7. Na stronie rejestracji nowej aplikacji w okienku nawigacji po lewej stronie w obszarze Zarządzanie wybierz pozycję Uprawnienia interfejsu API.
  8. Na stronie Uprawnienia interfejsu API wybierz pozycję Dodaj uprawnienie.
  9. Na karcie Interfejsy API używane przez moją organizację znajdź i wybierz interfejs API usług Dynamics Lifecycle .
  10. Zaznacz pole wyboru uprawnienia interfejsu API, które ma zakres user_impersonation , a następnie wybierz pozycję Dodaj uprawnienia.
  11. Wybierz przycisk, aby udzielić zgody administratora dla uprawnień. Po wyświetleniu monitu o potwierdzenie akcji wybierz pozycję Tak.
  12. W okienku nawigacji po lewej stronie w obszarze Zarządzanie wybierz pozycję Uwierzytelnianie.
  13. Na stronie Uwierzytelnianie w obszarze Ustawienia zaawansowane ustaw opcję Zezwalaj na przepływy klientów publicznych na Wartość Tak.
  14. W okienku nawigacji po lewej stronie wybierz pozycję Przegląd.
  15. Na stronie przeglądu rejestracji aplikacji jest wyświetlany identyfikator klienta.
  16. 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

  1. 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.
  2. 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.
  3. 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".