---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Dynamische Übersetzung -- Umfang

# Dynamische Übersetzung -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 19 Minuten Lesedauer

Die Dynamische Übersetzung 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 Dynamische Übersetzung Methoden sind für einen Übersetzungsservice aktiviert. Verwenden Sie diese API, um eine nahtlose Lokalisierungs-Experience für Ihre Anwenderoberfläche zu erstellen, sodass eine Schnittstelle mehrere Länder bedienen kann.

Derzeit unterstützt diese API zwei Übersetzungsservice Provider: Microsoft Azure Übersetzerservice und Google Cloud Übersetzerservice. Sie können auch andere Übersetzungsservices in Ihrer Instanz konfigurieren und dann verwenden Dynamische Übersetzung 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## DynamicTranslation -- getDetectedLanguage (Zeichenfolgentext, Objektparameter) {#ariaid-title2}

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 sowie andere mögliche Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den standardmäßigen Übersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.
{#DynTran-getDetectedLanguage_S_O__table_rym_ftl_thb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Text, der zum Erkennen der Sprache verwendet werden soll. |
| Parameter | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| Parms.Translator | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung wird nicht beachtet). Gültige Werte: * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguage_S_O__ul_jdd_zbl_thq} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter [Integration in einen Übersetzungsservice Provider](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration" \[sn_dt_translator_configuration\] konfiguriert ist. |
[Tabelle : 1. Parameter]

{#DynTran-getDetectedLanguage_S_O__table_rym_ftl_thb} {#DynTran-getDetectedLanguage_S_O__table_sym_ftl_thb__entry__2}{#DynTran-getDetectedLanguage_S_O__detections_alternatives-entry-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_alternatives_code-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_alternatives_conf-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_alternatives_name-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage_code-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage_confidence-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage_name-row-dynTran}{#DynTran-getDetectedLanguage_S_O__translator-row-dynTran}

| 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" } |
| DetectedLanguage.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, und 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Ü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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * \<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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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 festgelegte 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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * \<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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). {#DynTran-getDetectedLanguage_S_O__ul_ccq_ntm_b3b} |
[Tabelle : 2. Rückgaben]

{#DynTran-getDetectedLanguage_S_O__table_sym_ftl_thb}  
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) {#ariaid-title3}

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 sowie andere mögliche Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den standardmäßigen Übersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.
{#DynTran-getDetectedLanguages_A_O__table_mnq_h3q_nnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Texte | Array | Liste der Textzeichenfolgen, die zum Erkennen der Sprache(n) verwendet werden sollen. |
| Parameter | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. "parms": { "translator": "String" } |
| Parms.Translator | 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\> {#DynTran-getDetectedLanguages_A_O__ul_gwz_cjr_nnb} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter [Integration in einen Übersetzungsservice Provider](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration" \[sn_dt_translator_configuration\] konfiguriert ist. Tabelle: Übersetzerkonfiguration \[sn_dt_translator_configuration\] |
[Tabelle : 3. Parameter]

{#DynTran-getDetectedLanguages_A_O__table_mnq_h3q_nnb} {#DynTran-getDetectedLanguages_A_O__table_nnq_h3q_nnb__entry__2}{#DynTran-getDetectedLanguages_A_O__detections-entry-dynTran}{#DynTran-getDetectedLanguages_A_O__status-entry-dynTran}{#DynTran-getDetectedLanguages_A_O__translator-entry-dynTran}

| 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. {#DynTran-getDetectedLanguages_A_O__ul_alf_hmq_nnb} Datentyp: Boolescher Wert |
| Status | Status der Antwort auf den Methodenaufruf. Mögliche Werte: * Fehler * Teilweise * Erfolg {#DynTran-getDetectedLanguages_A_O__ul_slc_rmq_nnb} 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 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Ü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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * \<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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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 festgelegte 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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * \<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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Ü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](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). {#DynTran-getDetectedLanguages_A_O__ul_ccq_ntm_b3b} |
[Tabelle : 4. Rückgaben]

{#DynTran-getDetectedLanguages_A_O__table_nnq_h3q_nnb}  
Dieses Beispiel zeigt Code in einem Serverskript, das Englisch als Sprache der übergebenen Zeichenfolgen mithilfe des 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) {#ariaid-title4}

Übersetzt den übergebenen Text in eine oder mehrere Sprachen.
Die Methode verwendet Übersetzungsservices wie Microsoft Azure Übersetzerservice und Google Cloud Übersetzerservice, um die Übersetzung durchzuführen. Wenn Sie Übersetzungsparameter nicht übergeben, verwendet die Methode den Systemstandard.
{#DynTran-getTranslation_S_O__table_bzb_4zk_thb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Text-zu-Übersetzung | Zeichenfolge | Zu übersetzender Text. |
| Parameter | 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 zum Durchführen der Übersetzung bereitstellen. "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| Parms.additionalParameters.parameterName | Zeichenfolge | Optional. Schlüsselname. Gültige Werte: Texttyp: Typ des zu übersetzenden Texts. Nur für Microsoft Azure-Übersetzerservice. |
| Parms.additionalParameters.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: Vom Anwender bevorzugte Sprache. |
| Parms.Translator | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung wird nicht beachtet). Gültige Werte: * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslation_S_O__ul_jdd_zbl_thq} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter [Integration in einen Übersetzungsservice Provider](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration" \[sn_dt_translator_configuration\] konfiguriert ist. |
[Tabelle : 5. Parameter]

{#DynTran-getTranslation_S_O__table_bzb_4zk_thb} {#DynTran-getTranslation_S_O__table_czb_4zk_thb__entry__2}{#DynTran-getTranslation_S_O__detections_detectedLanguage-row-dynTran}{#DynTran-getTranslation_S_O__detections_detectedLanguage_code-row-dynTran}{#DynTran-getTranslation_S_O__detections_detectedLanguage_name-row-dynTran}{#DynTran-getTranslation_S_O__translations-trans-entry-dynTrans}{#DynTran-getTranslation_S_O__trans_trg_lang-trans-entry-dynTrans}{#DynTran-getTranslation_S_O__trans_transText-trans-entry-dynTrans}{#DynTran-getTranslation_S_O__translator-row-dynTran}

| Typ | Beschreibung |
|-|-|
| ErkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt "detectedLanguage": { "code": "String", "name": "String" } |
| DetectedLanguage.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| translations | 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Ü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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * \<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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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 {#DynTran-getTranslation_S_O__ul_zdj_4b4_b3b} * 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 festgelegte 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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Text kann nicht in Zielsprachen übersetzt werden. (40056): Der angegebene Übersetzungsservice kann den übergebenen Text nicht in die angegebenen Zielsprachen übersetzen. {#DynTran-getTranslation_S_O__ul_ccq_ntm_b3b} |
[Tabelle : 6. Rückgaben]

{#DynTran-getTranslation_S_O__table_czb_4zk_thb}  
Dieses Beispiel zeigt ein Serverskript, das nur-Text aus dem Englischen (erkannt) ins Französische und Italienische mithilfe des Übersetzungsservice von Microsoft ü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) {#ariaid-title5}

Übersetzt die übergebenen Textzeichenfolgen in eine oder mehrere Sprachen.
Die Methode verwendet Übersetzungsservices wie Microsoft Azure Übersetzerservice und Google Cloud Übersetzerservice, um die Übersetzung durchzuführen. Wenn Sie Übersetzungsparameter nicht übergeben, verwendet die Methode den Systemstandard.
{#DynTran-getTranslations_A_O__table_bzb_4zk_thb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Texte | Array | Liste der zu übersetzenden Textstiche. |
| Parameter | 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 zum Durchführen der Übersetzung bereitstellen. "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| Parms.additionalParameters.parameterName | Zeichenfolge | Optional. Schlüsselname. Gültige Werte: Texttyp: Typ des zu übersetzenden Texts. Nur für Microsoft Azure-Übersetzerservice. |
| Parms.additionalParameters.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: Vom Anwender bevorzugte Sprache. |
| Parms.Translator | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung wird nicht beachtet). Gültige Werte: * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslations_A_O__ul_jdd_zbl_thq} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter [Integration in einen Übersetzungsservice Provider](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration" \[sn_dt_translator_configuration\] konfiguriert ist. |
[Tabelle : 7. Parameter]

{#DynTran-getTranslations_A_O__table_bzb_4zk_thb} {#DynTran-getTranslations_A_O__table_czb_4zk_thb__entry__2}{#DynTran-getTranslations_A_O__status-entry-dynTran}{#DynTran-getTranslations_A_O__detections_detectedLanguage-row-dynTran}{#DynTran-getTranslations_A_O__detections_detectedLanguage_code-row-dynTran}{#DynTran-getTranslations_A_O__detections_detectedLanguage_name-row-dynTran}{#DynTran-getTranslations_A_O__translator-row-dynTran}

| Typ | Beschreibung |
|-|-|
| Status | Status der Antwort auf den Methodenaufruf. Mögliche Werte: * Fehler * Teilweise * Erfolg {#DynTran-getTranslations_A_O__ul_slc_rmq_nnb} Datentyp: Zeichenfolge |
| translations | 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. {#DynTran-getTranslations_A_O__ul_gf5_zvl_4nb} Datentyp: Boolescher Wert |
| 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 |
| Texttranslationen | Beschreibung der Sprache, die zum Übersetzen der Textzeichenfolge verwendet wird. Datentyp: Array von Objekten "textTranslation": { "targetLanguage": "String", "translatedText": "String" } |
| TextTranslations.targetlanguage | 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Ü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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * \<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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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 {#DynTran-getTranslations_A_O__ul_zdj_4b4_b3b} * 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 festgelegte 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](https://www.servicenow.com/docs/access?context=create-custom-translator&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Ü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](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * 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](https://www.servicenow.com/docs/access?context=dynamic-translation&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). * Text kann nicht in Zielsprachen übersetzt werden. (40056): Der angegebene Übersetzungsservice kann den übergebenen Text nicht in die angegebenen Zielsprachen übersetzen. {#DynTran-getTranslations_A_O__ul_ccq_ntm_b3b} |
[Tabelle : 8. Rückgaben]

{#DynTran-getTranslations_A_O__table_czb_4zk_thb}  
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) {#ariaid-title6}

Bestimmt, ob die verschiedenen Methoden in Dynamische Übersetzung API sind 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.
{#DynTran-isEnabled_S__table_qx5_nwl_thb__entry__3}

| 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\> {#DynTran-isEnabled_S__ul_jdd_zbl_thb} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie zuerst den Übersetzungsservice in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter [Integration in einen Übersetzungsservice Provider](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Standard: Standard-Übersetzungsservice. |
[Tabelle : 9. Parameter]

{#DynTran-isEnabled_S__table_qx5_nwl_thb} {#DynTran-isEnabled_S__table_rx5_nwl_thb__entry__2}

| Typ | Beschreibung |
|-|-|
| BatchDetection | Kennzeichnung, die angibt, ob GetDetectedLanguages() Methode ist aktiviert. Mögliche Werte: * Falsch: Deaktiviert * Wahr: Aktiviert Datentyp: Boolescher Wert |
| BatchÜbersetzung | Kennzeichnung, die angibt, ob GetTranslations() Methode ist aktiviert. Mögliche Werte: * Falsch: Deaktiviert * Wahr: Aktiviert {#DynTran-isEnabled_S__ul_i5j_gqm_4nb} Datentyp: Boolescher Wert |
| Erkennung | Kennzeichnung, die angibt, ob GetDetectedLanguage() Methode ist aktiviert. Mögliche Werte: * Falsch: Deaktiviert * Wahr: Aktiviert {#DynTran-isEnabled_S__ul_xtt_dzx_nnb} Datentyp: Boolescher Wert |
| Übersetzung | Kennzeichnung, die angibt, ob GetTranslation() Methode ist aktiviert. Mögliche Werte: * Falsch: Deaktiviert * Wahr: Aktiviert {#DynTran-isEnabled_S__ul_ahy_fzx_nnb} Datentyp: Boolescher Wert |
| 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. {#DynTran-isEnabled_S__ul_wp4_sfm_d3b} |
[Tabelle : 10. Rückgaben]

{#DynTran-isEnabled_S__table_rx5_nwl_thb}  
Dieses Beispiel zeigt ein Serverskript, das überprüft, ob der Dynamische Übersetzung Methoden sind für den Microsoft-Übersetzer 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"}


