DynamicTranslation – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 19 Minuten Lesedauer
  • Die DynamicTranslation Die API bietet Methoden, die Text mithilfe von Übersetzungsservice Providern in Echtzeit in mehrere Sprachen übersetzen.

    Darüber hinaus können Sie diese API verwenden, um die Sprache einer bestimmten Zeichenfolge zu erkennen und zu überprüfen, ob der verwendet wird DynamicTranslation Methoden sind für einen Übersetzungsservice aktiviert. Verwenden Sie diese API, um eine nahtlose Lokalisierungs-Experience für Ihre Anwenderoberfläche zu erstellen, mit der eine Schnittstelle mehrere Länder bedienen kann.

    Derzeit unterstützt diese API zwei Übersetzungsservice Provider: Microsoft Azure Translator Service und Google Cloud Translator Service. Sie können auch andere Übersetzungsservices in Ihrer Instanz konfigurieren und dann verwenden DynamicTranslation API zum Übersetzen Ihres Texts.

    Wenn Sie diese Methoden in einem serverseitigen Skript verwenden, verwenden Sie sn_dt_api Namespace-Bezeichner. Bevor Sie diese API verwenden können, müssen Sie das Plugin DynamicTranslation (com.Glide.Dynamic_Translation) aktivieren. Für Informationen zu diesem Plugin und zusätzliche Informationen zu Dynamische Übersetzung, Siehe Dynamische Übersetzungsübersicht .

    DynamicTranslation – getDetectedLanguage(Zeichenfolgentext, Objektparameter)

    Erkennt die Sprache des übergebenen Texts.

    Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom standardmäßigen Übersetzungsservice durchgeführt. Stellen Sie sicher, dass die von Ihnen angegebenen Textzeichenfolgen genügend Formulierungen enthalten, um eine ordnungsgemäße Spracherkennung zu ermöglichen.

    Zusätzlich zur erkannten Sprache enthält die Antwort ein Konfidenzniveau der Erkennung zusammen mit anderen möglichen Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den Standardübersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    text Zeichenfolge Text, der zum Erkennen der Sprache verwendet werden soll.
    parms Objekt Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält.
    Parameter.Übersetzer Zeichenfolge Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung nicht beachten).

    Gültige Werte:

    • Google
    • Microsoft
    • IBM
    • <custom>
    Hinweis:
    Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider .

    Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist.

    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Alternativen Array von Objekten, die andere Sprachen beschreiben, die ebenfalls übereinstimmen können.

    Datentyp: Array

    "alternatives": [
      {
        "code": "String",
        "confidence": "String",
        "name": "String"
      }
    ]
    Alternativen.Code Sprachcode der alternativen Sprache.

    Datentyp: Zeichenfolge

    Alternativen.Konfidenz Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau.

    Datentyp: Zeichenfolge

    alternatives.name Sprachcode der alternativen Sprache.

    Datentyp: Zeichenfolge

    ErkannteSprache Beschreibung der erkannten Sprache.

    Datentyp: Objekt

    "detectedLanguage": {
      "code": "String",
      "confidence": "String",
      "name": "String"
    }
    ErkannteSprache.Code Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    ErkannteSprache.Konfidenz Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau.

    Datentyp: Zeichenfolge

    detectedLanguage.name Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    Übersetzer Übersetzungsservice, der zum Erkennen der Sprache verwendet wird.

    Datentyp: Zeichenfolge

    Fehlermeldungen Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, sowie Hinweise auf die Fehlerursache.
    • Text („Text“-Feld) fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt entweder oder keine Zeichenfolge.
    • Plugin „dynamische Übersetzung“ ist nicht installiert. (40001): Die Dynamische Übersetzung API wurde aufgerufen, ohne das Plugin „com.Glide.Dynamic_Translation“ zu aktivieren. Informationen zum Aktivieren dieses Plugins finden Sie unter Dynamische Übersetzungsübersicht .
    • Übersetzer (Feld „Übersetzer“) ist ungültig. (40003): Übergeben translatorParameter ist keine Zeichenfolge.
    • <translator>-Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • <translator>-Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist nicht auf festgelegt Aktiv In der Übersetzerkonfiguration. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Zusätzliche Parameter sind ungültig. (40006): Die zusätzlichen Parameter, die übergeben wurden, sind kein Objekt.
    • Maximale Zeitgrenze wurde überschritten. (40009): Der Vorgang dauerte länger als der in der Übersetzungskonfiguration angegebene Zeitüberschreitungswert. Standard: 40 Sekunden
    • Standardübersetzer ist nicht für Erkennung konfiguriert. (40011): Der standardmäßige Übersetzungsservice wurde in der Übersetzerkonfiguration nicht für die Spracherkennung angegeben. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • <translator>-Übersetzer ist nicht für Erkennung konfiguriert. (40013): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht für die Spracherkennung konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Unbekannter Fehler aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler nicht in eine andere Kategorie fällt.
    • Text („Text“-Feld) hat seine maximale Länge überschritten. (40052): Der zur Übersetzung übergebene Text überschreitet die vom entsprechenden Übersetzungsservice unterstützte maximale Länge.
    • Anforderung ist nicht autorisiert, da Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice in „Verbindungen und Anmeldeinformationen“ konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Dynamische Übersetzungsübersicht .

    Dieses Beispiel zeigt Code in einem serverseitigen Skript, das eine Zeichenfolge in Englisch mithilfe des Übersetzungsservice von IBM erkennt.

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'});
     gs.info(JSON.stringify(detectedResponse));
    

    Ausgabe:

    {
      detectedLanguage:
        { "code": "en", "confidence": "1", "name": "en" }
      alternatives: 
        [
          { "code": "vi", "confidence": "0.86", "name": "vi" },
          { "code": "id", "confidence": "0.86", "name": "id" }
        ]                  
     }

    Dieses Beispiel zeigt ein Serverskript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123});
     gs.info(JSON.stringify(detectedResponse));
    

    Ausgabe:

    {"code":"40003","message":"Translator (\"translator\" field) is invalid"}

    DynamicTranslation – getDetectedLanguages (Array-Texte, Objektparameter)

    Erkennt die Sprachen der übergebenen Textzeichenfolgen.

    Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom standardmäßigen Übersetzungsservice durchgeführt. Stellen Sie sicher, dass die von Ihnen angegebenen Textzeichenfolgen genügend Formulierungen enthalten, um eine ordnungsgemäße Spracherkennung zu ermöglichen.

    Zusätzlich zur erkannten Sprache enthält die Antwort ein Konfidenzniveau der Erkennung zusammen mit anderen möglichen Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den Standardübersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Texte Array Liste der Textzeichenfolgen, die zum Erkennen der Sprache(n) verwendet werden sollen.
    parms Objekt Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält.
    "parms": {
      "translator": "String"
    }
    Parameter.Übersetzer Zeichenfolge Übersetzungsservice, der zum Erkennen der Sprache einer Zeichenfolge verwendet werden soll. Übersetzungsservices werden unter konfiguriert Übersetzerkonfiguration Menü.

    Mögliche Werte – Groß-/Kleinschreibung wird nicht beachtet:

    • Google
    • Microsoft
    • IBM
    • <custom>
    Hinweis:
    Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider .

    Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist.

    Tabelle: Übersetzerkonfiguration [sn_dt_Translator_Configuration]

    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Erkennungen Spracherkennung von Textzeichenfolgen.

    Datentyp: Objekt

    "detections": {
      "alternatives": [Array],
      "detectedLanguage": {Object},
      "isError": Boolean
    }
    Erkennungen.Alternativen Array von Objekten, die andere Sprachen beschreiben, die ebenfalls übereinstimmen könnten.

    Datentyp: Array

    "alternatives": [
      {
        "code": "String",
        "confidence": "String",
        "name": "String"
      }
    ]
    Erkennungen.Alternativen.Code Sprachcode der alternativen Sprache.

    Datentyp: Zeichenfolge

    Erkennungen.Alternativen.Konfidenz Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau.

    Datentyp: Zeichenfolge

    detections.alternatives.name Sprachcode der alternativen Sprache.

    Datentyp: Zeichenfolge

    detections.detectedLanguage Beschreibung der erkannten Sprache.

    Datentyp: Objekt

    "detectedLanguage": {
      "code": "String",
      "confidence": "String",
      "name": "String"
    }
    detections.detectedLanguage.code Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    detections.detectedLanguage.confidence Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau.

    Datentyp: Zeichenfolge

    detections.detectedLanguage.name Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    Erkennungen.isFehler Kennzeichnung, die angibt, ob die Erkennung der Sprache für den Text zu einem Fehler geführt hat.
    Gültige Werte:
    • Wahr: Fehler aufgetreten.
    • Falsch: Spracherkennung war erfolgreich.

    Datentyp: Boolesch

    status Status der Antwort auf den Methodenaufruf.
    Mögliche Werte:
    • Fehler
    • Teilweise
    • Erfolg

    Datentyp: Zeichenfolge

    Übersetzer Übersetzungsservice, der zum Erkennen der Sprache verwendet wird.

    Datentyp: Zeichenfolge

    Fehlermeldungen Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, sowie Hinweise auf die Fehlerursache.
    • Text („Text“-Feld) fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt entweder oder keine Zeichenfolge.
    • Plugin „dynamische Übersetzung“ ist nicht installiert. (40001): Die Dynamische Übersetzung API wurde aufgerufen, ohne das Plugin „com.Glide.Dynamic_Translation“ zu aktivieren. Informationen zum Aktivieren dieses Plugins finden Sie unter Dynamische Übersetzungsübersicht .
    • Übersetzer (Feld „Übersetzer“) ist ungültig. (40003): Übergeben translatorParameter ist keine Zeichenfolge.
    • <translator>-Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • <translator>-Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist nicht auf festgelegt Aktiv In der Übersetzerkonfiguration. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Zusätzliche Parameter sind ungültig. (40006): Die zusätzlichen Parameter, die übergeben wurden, sind kein Objekt.
    • Maximale Zeitgrenze wurde überschritten. (40009): Der Vorgang dauerte länger als der in der Übersetzungskonfiguration angegebene Zeitüberschreitungswert. Standard: 40 Sekunden
    • Anforderung mit mehreren Fehlern fehlgeschlagen. (40010): Im Spracherkennungsaufruf sind mehrere Fehler aufgetreten. Weitere Informationen finden Sie in der Antwort für jede einzelne Textzeichenfolge.
    • Standardübersetzer ist nicht für Erkennung konfiguriert. (40011): Der standardmäßige Übersetzungsservice wurde in der Übersetzerkonfiguration nicht für die Spracherkennung angegeben. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • <translator>-Übersetzer ist nicht für Erkennung konfiguriert. (40013): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht für die Spracherkennung konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Übersetzungskonfigurationsversion ist ungültig. Migrieren Sie zu v3. (40014): Die zugehörige Version der Übersetzerkonfiguration für den angegebenen Übersetzungsservice unterstützt die angegebene Textübersetzungsmethode nicht. Weitere Informationen finden Sie unter Migrieren Sie zu Version v3 einer Übersetzerkonfiguration .
    • Unbekannter Fehler aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler nicht in eine andere Kategorie fällt.
    • Text („Text“-Feld) hat seine maximale Länge überschritten. (40052): Der zur Übersetzung übergebene Text überschreitet die vom entsprechenden Übersetzungsservice unterstützte maximale Länge.
    • Anforderung ist nicht autorisiert, da Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice in „Verbindungen und Anmeldeinformationen“ konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Dynamische Übersetzungsübersicht .

    Dieses Beispiel zeigt Code in einem Serverskript, das Englisch als Sprache der übergebenen Zeichenfolgen mit dem Microsoft-Übersetzungsservice erkennt.

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "Microsoft"});
    gs.info(JSON.stringify(detectedResponse));
    

    Ausgabe

    {
      "translator":"Microsoft",
      "status":"Success",
      "detections":[
        {
          "isError":false,
          "detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
          "alternatives":[
            {"name":"id", "code":"id", "confidence":"0.83"},
            {"name":"ms", "code":"ms", "confidence":"0.83"}
          ]
        },
        {
          "isError":false,
          "detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
          "alternatives":[
            {"name":"fr", "code":"fr", "confidence":"0.83"},
            {"name":"id", "code":"id", "confidence":"0.83"}
          ]
        }
      ]
    }

    Dieses Beispiel zeigt Code in einem Serverskript, das einen Teilstatus zurückgibt, wenn zwei Textzeichenfolgen übergeben werden und eine davon ungültig ist.

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguages(["First text string language to detect", ""], {"translator": "Microsoft"});
    gs.info(JSON.stringify(detectedResponse));

    Ausgabe

    {
      "translator":"Microsoft",
      "status":"Partial",
      "detections":[
        {
          "isError":false,
          "detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
          "alternatives":[
            {"name":"id", "code":"id", "confidence":"0.83"},
            {"name":"ms", "code":"ms", "confidence":"0.83"}
          ]
        },
        {
          "isError":true,
          "code":"40000",
          "message":"Text is missing or invalid"
        }
      ]
    }

    Dieses Beispiel zeigt Code in einem Serverskript, der einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "123"});
    gs.info(JSON.stringify(detectedResponse));

    Ausgabe

    {"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}

    DynamicTranslation – getTranslation(Zeichenfolge textToTranslate, Objektparameter)

    Übersetzt den übergebenen Text in eine oder mehrere Sprachen.

    Die Methode verwendet Übersetzungsservices wie Microsoft Azure Translator Service und Google Cloud Translator Service, um die Übersetzung durchzuführen. Wenn Sie Übersetzungsparameter nicht übergeben, verwendet die Methode den Systemstandard.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Textzu übersetzen Zeichenfolge Zu übersetzender Text.
    parms Objekt Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält.
    "parms": {
      "additionalParameters": {Object},
      "sourceLanguage": "String",
      "targetLanguages": [Array],
      "translator": "String"
    }
    Parameter.additionalParameter Array Optional. Array von JSON-Objekten. Jedes Objekt enthält Schlüssel-Wert-Paare, die zusätzliche Informationen für die Durchführung der Übersetzung bereitstellen.
    "additionalParameters": {
      "parameterName": "String",
      "parameterValue": "String"
    }
    Parameter.additionalParameter.parameterName Zeichenfolge Optional. Schlüsselname.

    Gültige Werte:

    Texttyp: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Service.

    Parameter.additionalParameter.parameterWert Zeichenfolge Optional. Wert des zugeordneten Schlüssels.

    Gültige Werte:

    • html: HTML-Textzeichenfolge
    • Nur: Standardtextzeichenfolge

    Standard: Nur

    Parms.sourceSprache Zeichenfolge Optional. Sprachcode des Quelltexts.

    Standard: Der Übersetzungsservice erkennt die Ausgangssprache.

    Parms.targetLanguages Array Optional. Liste der Sprachcodes, die zum Übersetzen des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück.

    Standard: Bevorzugte Sprache des Anwenders.

    Parameter.Übersetzer Zeichenfolge Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung nicht beachten).

    Gültige Werte:

    • Google
    • Microsoft
    • IBM
    • <custom>
    Hinweis:
    Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider .

    Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist.

    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    ErkannteSprache Beschreibung der erkannten Sprache.

    Datentyp: Objekt

    "detectedLanguage": {
      "code": "String",
      "name": "String"
    }
    ErkannteSprache.Code Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    detectedLanguage.name Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    Übersetzungen Liste, die die Sprachübersetzungen beschreibt.

    Datentyp: Array von Objekten

    translations": [
      {
        "targetLanguage": "String",
        "translatedText": "String"
      }
    ]
    Übersetzungen.Zielsprache Sprachcode, in den der Quelltext übersetzt wurde.

    Datentyp: Zeichenfolge

    Übersetzungen.übersetztText Übersetzter Text.

    Datentyp: Zeichenfolge

    Übersetzer Übersetzungsservice, der zum Erkennen der Sprache verwendet wird.

    Datentyp: Zeichenfolge

    Fehlermeldungen Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, und Hinweise auf die Ursache.
    • Text („Text“-Feld) fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt entweder oder keine Zeichenfolge.
    • Plugin „dynamische Übersetzung“ ist nicht installiert. (40001): Die Dynamische Übersetzung API wurde aufgerufen, ohne das Plugin „com.Glide.Dynamic_Translation“ zu aktivieren. Informationen zum Aktivieren dieses Plugins finden Sie unter Dynamische Übersetzungsübersicht .
    • Standardübersetzer ist nicht für die Übersetzung konfiguriert. (40002): In den Übersetzerkonfigurationen ist kein Übersetzungsservice als Standard-Übersetzungsservice ausgewählt. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Übersetzer (Feld „Übersetzer“) ist ungültig. (40003): Übergeben translatorParameter ist keine Zeichenfolge.
    • <translator>-Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • <translator>-Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist nicht auf festgelegt Aktiv In der Übersetzerkonfiguration. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Zusätzliche Parameter sind ungültig. (40006): Die zusätzlichen Parameter, die übergeben wurden, sind kein Objekt.
    • Zielsprachen (Feld „targetLanguages“) sind ungültig. (40007): Die targetLanguagesParameter wird im Aufruf übergeben, ist jedoch aus einem der folgenden Gründe nicht gültig:
      • Wert ist kein Array
      • Array ist leer
      • Mindestens einer der Einträge ist keine Zeichenfolge
    • Ausgangssprache (Feld „sourceLanguage“) ist ungültig. (40008): Die sourceLanguageParameter wird im Aufruf übergeben, der Wert ist jedoch keine Zeichenfolge.
    • Maximale Zeitgrenze wurde überschritten. (40009): Der Vorgang dauerte länger als der in der Übersetzungskonfiguration angegebene Zeitüberschreitungswert. Standard: 40 Sekunden
    • <translator>-Übersetzer ist nicht für die Übersetzung konfiguriert. (40012): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht für die Textübersetzung konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Unbekannter Fehler aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler nicht in eine andere Kategorie fällt.
    • Text („Text“-Feld) hat seine maximale Länge überschritten. (40052): Der zur Übersetzung übergebene Text überschreitet die vom entsprechenden Übersetzungsservice unterstützte maximale Länge.
    • Ausgangssprache ist ungültig. (40053): Übergeben sourceLanguageParameter enthält einen Sprachcode, der vom entsprechenden Übersetzungsservice nicht unterstützt wird.
    • Zielsprache ist ungültig. (40054): Mindestens einer der in übergebenen Sprachcodes targetLanguagesParameter wird vom entsprechenden Übersetzungsservice nicht unterstützt.
    • Anforderung ist nicht autorisiert, da Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice in „Verbindungen und Anmeldeinformationen“ konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Dynamische Übersetzungsübersicht .
    • Text kann nicht in Zielsprachen übersetzt werden. (40056): Der angegebene Übersetzungsservice kann den übergebenen Text nicht in die angegebenen Zielsprachen übersetzen.

    Dieses Beispiel zeigt ein Serverskript, das mit dem Übersetzungsservice von Microsoft nur-Text aus dem Englischen (erkannt) ins Französische und Italienische übersetzt.

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslation("Translate this text using platform from server", {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{
          "parameterName": "texttype",
          "parameterValue": "plain"
        }],
        "translator": "Microsoft"
      })));
    } catch (error) {
        gs.info(error.message);
    }

    Antwort:

    {"translations":[
        {
          "targetLanguage":"it",
          "translatedText":"Tradurre questo testo utilizzando la piattaforma dal server"
        },
        {
          "targetLanguage":"fr",
          "translatedText":"Traduire ce texte en utilisant la plate-forme à partir du serveur"
        }
      ],
      "translator":"Microsoft",
      "detectedLanguage":{"code":"en","name":"en"}
    }

    Dieses Beispiel zeigt ein Serverskript, das einen Fehler auslöst, wenn eine ungültige Zielsprache übergeben wird.

    try {
        gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslation("Translate this text using platform from server", {
            "targetLanguages": ["123"],
            "additionalParameters": [{
                "parameterName": "texttype",
                "parameterValue": "plain"
            }],
            "translator": "Microsoft"
        })));
    } catch (error) {
        gs.info(error.message);
    }

    Antwort:

    {"code":"40054","message":"Target language is invalid"}

    DynamicTranslation – getTranslations (Array-Texte, Objektparameter)

    Übersetzt die übergebenen Textzeichenfolgen in eine oder mehrere Sprachen.

    Die Methode verwendet Übersetzungsservices wie Microsoft Azure Translator Service und Google Cloud Translator Service, um die Übersetzung durchzuführen. Wenn Sie Übersetzungsparameter nicht übergeben, verwendet die Methode den Systemstandard.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Texte Array Liste der zu übersetzenden Textstiche.
    parms Objekt Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält.
    "parms": {
      "additionalParameters": {Object},
      "sourceLanguage": "String",
      "targetLanguages": [Array],
      "translator": "String"
    }
    Parameter.additionalParameter Objekt Optional. Array von JSON-Objekten. Jedes Objekt enthält Schlüssel-Wert-Paare, die zusätzliche Informationen für die Durchführung der Übersetzung bereitstellen.
    "additionalParameters": {
      "parameterName": "String",
      "parameterValue": "String"
    }
    Parameter.additionalParameter.parameterName Zeichenfolge Optional. Schlüsselname.

    Gültige Werte:

    Texttyp: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Service.

    Parameter.additionalParameter.parameterWert Zeichenfolge Optional. Wert des zugeordneten Schlüssels.

    Gültige Werte:

    • html: HTML-Textzeichenfolge
    • Nur: Standardtextzeichenfolge

    Standard: Nur

    Parms.sourceSprache Zeichenfolge Optional. Sprachcode des Quelltexts.

    Standard: Der Übersetzungsservice erkennt die Ausgangssprache.

    Parms.targetLanguages Array Optional. Liste der Sprachcodes, die zum Übersetzen des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück.

    Standard: Bevorzugte Sprache des Anwenders.

    Parameter.Übersetzer Zeichenfolge Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung nicht beachten).

    Gültige Werte:

    • Google
    • Microsoft
    • IBM
    • <custom>
    Hinweis:
    Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider .

    Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_Translator_Configuration] konfiguriert ist.

    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    status Status der Antwort auf den Methodenaufruf.
    Mögliche Werte:
    • Fehler
    • Teilweise
    • Erfolg

    Datentyp: Zeichenfolge

    Übersetzungen Liste, die die Sprachübersetzungen beschreibt.

    Datentyp: Array

    translations": [
      {
        "isError": Boolean;
        "detectedLanguage": {Object},
        "textTranslations": [Array]
      }
    ]
    Übersetzungen.isFehler Kennzeichnung, die angibt, ob die Übersetzung des Texts zu einem Fehler geführt hat.
    Gültige Werte:
    • Wahr: Fehler aufgetreten.
    • Falsch: Textübersetzung war erfolgreich.

    Datentyp: Boolesch

    translations.detectedLanguage Beschreibung der erkannten Sprache.

    Datentyp: Objekt

    "detectedLanguage": {
      "code": "String",
      "name": "String"
    }
    translations.detectedLanguage.code Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    translations.detectedLanguage.name Sprachcode der erkannten Sprache.

    Datentyp: Zeichenfolge

    Textübersetzungen Beschreibung der Sprache, die zum Übersetzen der Textzeichenfolge verwendet wird.

    Datentyp: Array von Objekten

    "textTranslation": {
      "targetLanguage": "String",
      "translatedText": "String"
    }
    Textübersetzungen.Zielsprache Sprachcode, in den der Quelltext übersetzt wurde.

    Datentyp: Zeichenfolge

    Textübersetzungen.übersetztText Übersetzter Text.

    Datentyp: Zeichenfolge

    Übersetzer Übersetzungsservice, der zum Übersetzen des Texts verwendet wird.

    Datentyp: Zeichenfolge

    Fehlermeldungen Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, und Hinweise auf die Ursache.
    • Text („Text“-Feld) fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt entweder oder keine Zeichenfolge.
    • Plugin „dynamische Übersetzung“ ist nicht installiert. (40001): Die Dynamische Übersetzung API wurde aufgerufen, ohne das Plugin „com.Glide.Dynamic_Translation“ zu aktivieren. Informationen zum Aktivieren dieses Plugins finden Sie unter Dynamische Übersetzungsübersicht .
    • Standardübersetzer ist nicht für die Übersetzung konfiguriert. (40002): In den Übersetzerkonfigurationen ist kein Übersetzungsservice als Standard-Übersetzungsservice ausgewählt. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Übersetzer (Feld „Übersetzer“) ist ungültig. (40003): Übergeben translatorParameter ist keine Zeichenfolge.
    • <translator>-Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • <translator>-Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist nicht auf festgelegt Aktiv In der Übersetzerkonfiguration. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Zusätzliche Parameter sind ungültig. (40006): Die zusätzlichen Parameter, die übergeben wurden, sind kein Objekt.
    • Zielsprachen (Feld „targetLanguages“) sind ungültig. (40007): Die targetLanguagesParameter wird im Aufruf übergeben, ist jedoch aus einem der folgenden Gründe nicht gültig:
      • Wert ist kein Array
      • Array ist leer
      • Mindestens einer der Einträge ist keine Zeichenfolge
    • Ausgangssprache (Feld „sourceLanguage“) ist ungültig. (40008): Die sourceLanguageParameter wird im Aufruf übergeben, der Wert ist jedoch keine Zeichenfolge.
    • Maximale Zeitgrenze wurde überschritten. (40009): Der Vorgang dauerte länger als der in der Übersetzungskonfiguration angegebene Zeitüberschreitungswert. Standard: 40 Sekunden
    • Anforderung mit mehreren Fehlern fehlgeschlagen. (40010): Im Spracherkennungsaufruf sind mehrere Fehler aufgetreten. Weitere Informationen finden Sie in der Antwort für jede einzelne Textzeichenfolge.
    • <translator>-Übersetzer ist nicht für die Übersetzung konfiguriert. (40012): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht für die Textübersetzung konfiguriert. Informationen zum Erstellen/Ändern einer Übersetzerkonfiguration finden Sie unter Erstellen Sie eine Übersetzerkonfiguration .
    • Übersetzungskonfigurationsversion ist ungültig. Migrieren Sie zu v3. (40014): Die zugehörige Version der Übersetzerkonfiguration für den angegebenen Übersetzungsservice unterstützt die angegebene Textübersetzungsmethode nicht. Weitere Informationen finden Sie unter Migrieren Sie zu Version v3 einer Übersetzerkonfiguration .
    • Unbekannter Fehler aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler nicht in eine andere Kategorie fällt.
    • Text („Text“-Feld) hat seine maximale Länge überschritten. (40052): Der zur Übersetzung übergebene Text überschreitet die vom entsprechenden Übersetzungsservice unterstützte maximale Länge.
    • Ausgangssprache ist ungültig. (40053): Übergeben sourceLanguageParameter enthält einen Sprachcode, der vom entsprechenden Übersetzungsservice nicht unterstützt wird.
    • Zielsprache ist ungültig. (40054): Mindestens einer der in übergebenen Sprachcodes targetLanguagesParameter wird vom entsprechenden Übersetzungsservice nicht unterstützt.
    • Anforderung ist nicht autorisiert, da Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice in „Verbindungen und Anmeldeinformationen“ konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Dynamische Übersetzungsübersicht .
    • Text kann nicht in Zielsprachen übersetzt werden. (40056): Der angegebene Übersetzungsservice kann den übergebenen Text nicht in die angegebenen Zielsprachen übersetzen.

    Dieses Beispiel zeigt Code in einem serverseitigen Skript, das eine Liste von Textzeichenfolgen mithilfe des Microsoft-Übersetzungsservice ins Französische und Italienische übersetzt.

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslations(["Translate first text using platform from server", "Translate second text using platform from server"], {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{"parameterName": "texttype", "parameterValue": "plain"}],
        "translator": "Microsoft"
      })));
    } catch (error) {
        gs.error(error.message);
    }

    Antwort:

    {
      "translations":[
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il primo testo utilizzando la piattaforma dal server"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le premier texte à l'aide de la plate-forme à partir du serveur"
            }
          ],
          "detectedLanguage": {"name":"en", "code":"en"}
        },
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il secondo testo utilizzando la piattaforma dal server"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le deuxième texte à l'aide de la plate-forme à partir du serveur"
            }
          ],
          "detectedLanguage": {"name":"en", "code":"en"}
        }
      ],
      "translator":"Microsoft",
      "status":"Success"
    }

    Dieses Beispiel zeigt ein Serverskript, das einen Teilstatus zurückgibt, wenn eine der beiden übergebenen Textzeichenfolgen ungültig ist.

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslations(["Translate first text using platform from server", ""], {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{"parameterName": "texttype", "parameterValue": "plain"}],
        "translator": "Microsoft"
      })));
    } catch (error) {
        gs.error(error.message);
    }

    Antwort:

    {
      "translations":[
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il primo testo utilizzando la piattaforma dal server"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le premier texte à l'aide de la plate-forme à partir du serveur"
            }
          ],
          "detectedLanguage":{"name":"en", "code":"en"}
        },
        {
          "isError":true,
          "code":"40000",
          "message":"Text is missing or invalid"
        }
      ],
      "translator":"Microsoft",
      "status":"Partial"
    }

    Dieses Beispiel zeigt ein Serverskript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslations(["Translate first text using platform from server", "Translate second text using platform from server"], {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{"parameterName": "texttype", "parameterValue": "plain"}],
        "translator": 123
      })));
    } catch (error) {
        gs.error(error.message);
    }

    Antwort:

    {"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}

    DynamicTranslation – isEnabled(Zeichenfolgenübersetzer)

    Bestimmt, ob die verschiedenen Methoden in der DynamicTranslation API ist für einen Übersetzungsservice aktiviert.

    Wenn Sie einen bestimmten Übersetzungsservice übergeben, überprüft die Methode die Methodenaktivierung für diesen Übersetzungsservice. Andernfalls überprüft die Methode den standardmäßigen Übersetzungsservice.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Übersetzer Zeichenfolge Optional. Übersetzungsservice, der verwendet werden soll, um zu überprüfen, ob die Methoden aktiv sind. Übersetzungsservices werden im Menü Übersetzerkonfiguration konfiguriert.

    Mögliche Werte – Groß-/Kleinschreibung wird nicht beachtet:

    • Google
    • Microsoft
    • IBM
    • <custom>
    Hinweis:
    Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsservice Provider .

    Standard: Standard-Übersetzungsservice.

    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    BatchDetection Kennzeichnung, die angibt, ob GetDetectedLanguages() Methode ist aktiviert.
    Mögliche Werte:
    • Falsch: Deaktiviert
    • Wahr: Aktiviert

    Datentyp: Boolesch

    BatchTranslation Kennzeichnung, die angibt, ob GetTranslations() Methode ist aktiviert.
    Mögliche Werte:
    • Falsch: Deaktiviert
    • Wahr: Aktiviert

    Datentyp: Boolesch

    Erkennung Kennzeichnung, die angibt, ob GetDetectedLanguage() Methode ist aktiviert.
    Mögliche Werte:
    • Falsch: Deaktiviert
    • Wahr: Aktiviert

    Datentyp: Boolesch

    Übersetzung Kennzeichnung, die angibt, ob GetTranslation() Methode ist aktiviert.
    Mögliche Werte:
    • Falsch: Deaktiviert
    • Wahr: Aktiviert

    Datentyp: Boolesch

    Fehlermeldungen Im Folgenden finden Sie Fehlermeldungen, die die API zurückgeben kann, und Hinweise auf die Ursache.
    • Übersetzer (Feld „Übersetzer“) ist ungültig. (40003): Übergeben translatorParameter ist keine Zeichenfolge.

    Dieses Beispiel zeigt ein Serverskript, das überprüft, ob der DynamicTranslation Methoden sind für den Microsoft Translator aktiv.

    try {
      var response = sn_dt_api.DynamicTranslation.isEnabled('Microsoft');
      gs.info(JSON.stringify(response));
    } catch(error) {
        gs.info(error.message);
    }

    Ausgabe:

    {"detection":true,"batchTranslation":true,"batchDetection":true,"translation":true}

    Dieses Beispiel zeigt ein Serverskript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.

    try {
      var response = sn_dt_api.DynamicTranslation.isEnabled(123);
      gs.info(JSON.stringify(response));
    } catch(error) {
        gs.info(error.message);
    }

    Ausgabe:

    {"code":"40003","message":"Translator (\"translator\" field) is invalid"}