Integrieren Sie mit einem Übersetzungsdienstanbieter

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Integrieren Sie einen beliebigen Übersetzungsdienstanbieter Ihrer Wahl, um den dynamisch generierten Text zu übersetzen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Erstellen Sie Subflows, um die Sprache des Eingabetexts zu erkennen, und übersetzen Sie den Eingabetext mithilfe von IntegrationHub Subflows, Aktionen sowie Verbindungen und Anmeldeinformationen.
      Weitere Informationen finden Sie unter Flow Designer.
      1. Stellen Sie sicher, dass die Zuordnung für Fehlermeldungen erfolgt, um Fehlercodes vom Übersetzungsdienstanbieter den von ServiceNowunterstützten Fehlercodes und standardisierten Fehlermeldungen zuzuordnen.
        Tabelle : 1. Standardfehlercodes und -meldung
        Fehlercode Fehlermeldung
        40050 Fehlercode zum Ausfüllen von Fehlermeldungen des Übersetzungsdienstanbieters anstelle von standardisierten Fehlermeldungen.
        40051 Unbekannter Fehler ist aufgetreten.
        40052 Text (Feld „Text“) hat seine maximale Länge überschritten.
        40053 Ausgangssprache ist ungültig.
        40054 Zielsprache ist ungültig.
        40055 Die Anforderung ist nicht autorisiert, da die Anmeldeinformationen fehlen oder ungültig sind.
        40056 Text kann nicht in Zielsprachen übersetzt werden.
      2. Stellen Sie sicher, dass die Ein- und Ausgabefelder für Subflows das folgende Format aufweisen.
        Hinweis:
        Beim Erstellen von Subflows können Sie bei Bedarf auf die standardmäßig verfügbaren Subflows verweisen. Beispiele: Sprache erkennen [detect_language_v3] und Text in mehrere Sprachen übersetzen [translate_text_to_multiple_languages_v3].
        Tabelle : 2. Erkennen Sie den Subflow
        Feldname Beschreibung Typ
        Eingaben
        Texte Eingabetexte, deren Sprache erkannt werden soll.

        Im Release Washington DC unterstützt Version v3 die Massenerkennung – Erkennung mehrerer Texte, die in eine einzelne Zeichenfolge eingegeben werden.

        Array.Zeichenfolge
        Ausgaben
        Erkennungen Informationen über den Code und die Konfidenz der vom Übersetzer erkannten Sprachen und ihre jeweiligen Alternativen, Fehlercodes und Fehlermeldungen.
        • Code: Sprachcode der erkannten Sprache, wie vom Übersetzungsdienstanbieter angegeben.
        • Konfidenz: Wert, der die Konfidenz in das Ergebnis angibt. Der Wert liegt zwischen null und eins. Ein niedriger Wert zeigt eine geringe Konfidenz an.
        Beispiel: Französischer Text mit einer Konfidenz von 0,93
        { 'code' : 'fr',  'confidence' : '0.93'  }

        Weitere Informationen finden Sie im Abschnitt getDetectedLanguages von DynamicTranslation - Scoped.

        Array.Objekt Jedes Element des Objekts ist ein Zeichenfolgenwert.
        status Status der Anforderung. Auswahl
        Tabelle : 3. Übersetzen Sie den Subflow
        Feldname Beschreibung Typ
        Eingaben
        Texte Zu übersetzende Texte.

        Im Release Washington DC unterstützt Version v3 die Massenübersetzung – die Übersetzung mehrerer Texte, die in eine einzelne Zeichenfolge eingegeben werden.

        Array.Zeichenfolge
        target_languages Array von Sprachcodes, in die der Text übersetzt werden muss.
        Beispiel:
        ['fr','it']
        Array-Zeichenfolge. Jedes Element des Arrays ist ein Zeichenfolgenwert.
        source_language Sprachcode des Quelltexts.
        Beispiel:
        en
        Zeichenfolge
        additional_parameters Array mit zusätzlichen Parametern.
        Beispiel:
        [{'parameter_name': 'textType', 'parameter_value': 'html'}]
        Array.Objekt Jedes Element des Arrays ist ein Objekt mit Zeichenfolgenwerten.
        Ausgaben
        Übersetzungen Übersetzte Texte in den angegebenen Zielsprachen. Jedes Element des Arrays ist ein Objekt, das die Zielsprache und den übersetzten Text enthält.
        Beispiel:
        [ 
        {'target_language':'fr', 'translated_text':'Bonjour'}, 
        {'target_language':'it', 'translated_text':'ciao'} 
        ]
        

        Weitere Informationen finden Sie im Abschnitt getTranslations von DynamicTranslation – Scoped.

        Array.Objekt Jedes Element des Arrays ist ein Objekt mit Zeichenfolgenwerten.
        status Status der Anforderung. Auswahl
        Hinweis:
        Stellen Sie sicher, dass das Feld Ausführen als in den Flow-Eigenschaften auf Benutzer, der die Sitzung initiiert festgelegt ist.
    2. Erstellen Sie eine Übersetzerkonfiguration, und aktivieren Sie sie.
      Weitere Informationen finden Sie unter Erstellen Sie eine Übersetzerkonfiguration.