---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DynamicTranslation -- Bereichsbezogen

# DynamicTranslation -- Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 19 Minuten Lesedauer

Die DynamicTranslation- API bietet Methoden, die Text mithilfe von Übersetzungsdienstanbietern 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 die DynamicTranslation- Methoden für einen Übersetzungsservice aktiviert sind. Verwenden Sie diese API, um eine nahtlose Lokalisierungs-Experience für Ihre Anwenderoberfläche zu schaffen, sodass eine Schnittstelle mehrere Länder bedienen kann.

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

Wenn Sie diese Methoden in einem serverseitigen Skript verwenden, verwenden Sie den Namespace-Bezeichner `sn_dt_api`. Bevor Sie diese API verwenden können, müssen Sie das Plugin „DynamicTranslation" (com.glide.dynamic_translation) aktivieren. Informationen zu diesem Plugin sowie zusätzliche Informationen zu Dynamische Übersetzungfinden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

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

Erkennt die Sprache des übergebenen Textes.
Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom Standardü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 |
|-|-|-|
| text | Zeichenfolge | Zur Erkennung der Sprache zu verwendender Text. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.translator | Zeichenfolge | Optional. Übersetzungsservice für die Übersetzung des Texts (Groß-/Kleinschreibung nicht relevant). Gültige Werte: * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguage_S_O__ul_jdd_zbl_thq} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie [unter Mit einem Übersetzungsserviceanbieter integrieren](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Standard: In der Übersetzerkonfigurationstabelle \[sn_dt_translator_configuration\] konfigurierter Übersetzungsservice. |
[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" } ] |
| alternatives.code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| alternatives.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 |
| 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 zur Fehlerursache. * Text (Feld „Text") fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt oder ist keine Zeichenfolge. * Plugin für dynamische Übersetzung ist nicht installiert. (40001): Die Dynamische Übersetzungs -API wurde aufgerufen, ohne das Plugin „com.glide.dynamic_translation" zu aktivieren. Informationen zur Aktivierung dieses Plugins finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Übersetzer (Feld „Übersetzer") ist ungültig. (40003): Der in Parameter translator übergebene Parameter ist keine Zeichenfolge. * \<translator\>Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> -Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht auf „ Aktiv " festgelegt. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Zusätzliche Parameter sind ungültig. (40006): Die zusätzlichen Parameter, die übergeben wurden, sind kein Objekt. * Die zulässige Zeit wurde überschritten. (40009): Der Vorgang dauerte länger als der in der Übersetzungskonfiguration angegebene Zeitüberschreitungswert. Standard: 40 Sekunden * Der Standardübersetzer ist nicht für Erkennung konfiguriert. (40011): Der Standardübersetzungsservice wurde für die Spracherkennung in der Übersetzerkonfiguration nicht angegeben. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-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 von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Unbekannter Fehler ist aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler in keiner anderen Kategorie liegt. * Text (Feld „Text") hat die maximale Länge überschritten. (40052): Der zur Übersetzung übergebene Text überschreitet die vom entsprechenden Übersetzungsservice unterstützte maximale Länge. * Die Anforderung ist nicht autorisiert, da die Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice unter „Verbindungen und Anmeldeinformationen" konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). {#DynTran-getDetectedLanguage_S_O__ul_ccq_ntm_b3b} |
[Tabelle : 2. Ergebnisse]

{#DynTran-getDetectedLanguage_S_O__table_sym_ftl_thb}  
Dieses Beispiel zeigt Code in einem serverseitigen Skript, das mithilfe des IBM Übersetzungsservice eine Zeichenfolge in Englisch 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 Standardü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. |
| parms | 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 wird. Übersetzungsservices werden im Menü „ Übersetzerkonfiguration" konfiguriert und befinden sich in der Tabelle „Übersetzerkonfiguration" \[sn_dt_translator_configuration\]. Mögliche Werte, Groß-/Kleinschreibung nicht relevant: * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguages_A_O__ul_gwz_cjr_nnb} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie [unter Mit einem Übersetzungsserviceanbieter integrieren](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Standard: In der Übersetzerkonfigurationstabelle \[sn_dt_translator_configuration\] konfigurierter Übersetzungsservice. |
[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 ] |
| discoverys.alternatives | Array von Objekten, die andere Sprachen beschreiben, die möglicherweise ebenfalls übereinstimmen. Datentyp: Array "alternatives": [ { "code": "String", "confidence": "String", "name": "String" } ] |
| discoverys.alternatives.code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| discoverys.alternatives.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.alternatives.name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| discoverys.detectedLanguage | Beschreibung der erkannten Sprache. Datentyp: Objekt "detectedLanguage": { "code": "String", "confidence": "String", "name": "String" } |
| discoverys.detectedLanguage.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| discoverys.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 |
| discoverys.isError | Kennzeichnung, die angibt, ob die Erkennung der Sprache für den Text zu einem Fehler geführt hat. Gültige Werte: * true: Fehler aufgetreten. * „falsch": Spracherkennung war erfolgreich. {#DynTran-getDetectedLanguages_A_O__ul_alf_hmq_nnb} Datentyp: Boolesch |
| 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, sowie Hinweise zur Fehlerursache. * Text (Feld „Text") fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt oder ist keine Zeichenfolge. * Plugin für dynamische Übersetzung ist nicht installiert. (40001): Die Dynamische Übersetzungs -API wurde aufgerufen, ohne das Plugin „com.glide.dynamic_translation" zu aktivieren. Informationen zur Aktivierung dieses Plugins finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Übersetzer (Feld „Übersetzer") ist ungültig. (40003): Der in Parameter translator übergebene Parameter ist keine Zeichenfolge. * \<translator\>Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> -Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht auf „ Aktiv " festgelegt. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Zusätzliche Parameter sind ungültig. (40006): Die zusätzlichen Parameter, die übergeben wurden, sind kein Objekt. * Die zulässige Zeit 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): Beim Spracherkennungsaufruf sind mehrere Fehler aufgetreten. Weitere Informationen finden Sie in der Antwort für jede einzelne Textzeichenfolge. * Der Standardübersetzer ist nicht für Erkennung konfiguriert. (40011): Der Standardübersetzungsservice wurde für die Spracherkennung in der Übersetzerkonfiguration nicht angegeben. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-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 von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Übersetzerkonfigurationsversion ist ungültig. Migrieren Sie zu v3. (40014): Die zugeordnete Version der Übersetzerkonfiguration für den angegebenen Übersetzungsservice unterstützt die angegebene Textübersetzungsmethode nicht. Weitere Informationen finden Sie [unter Zu Version v3 einer Übersetzerkonfiguration migrieren](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Unbekannter Fehler ist aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler in keiner anderen Kategorie liegt. * Text (Feld „Text") hat die maximale Länge überschritten. (40052): Der zur Übersetzung übergebene Text überschreitet die vom entsprechenden Übersetzungsservice unterstützte maximale Länge. * Die Anforderung ist nicht autorisiert, da die Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice unter „Verbindungen und Anmeldeinformationen" konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). {#DynTran-getDetectedLanguages_A_O__ul_ccq_ntm_b3b} |
[Tabelle : 4. Ergebnisse]

{#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 Teilweise-Status 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, das 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(String textToTranslate, Object pars) {#ariaid-title4}

Ü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 keine Übersetzungsparameter übergeben, verwendet die Methode den Systemstandard.
{#DynTran-getTranslation_S_O__table_bzb_4zk_thb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| textToTranslate | Zeichenfolge | Zu übersetzender Text. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. "parms": { "additionalParameters": {Object}, "sourceLanguage": "String", "targetLanguages": [Array], "translator": "String" } |
| parms.additionalParameters | 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 bieten. "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| parms.zusätzlicheParameter.parameterName | Zeichenfolge | Optional. Schlüsselname Gültige Werte: texttype: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Dienst. |
| parms.zusätzlicheParameter.parameterWert | Zeichenfolge | Optional. Wert des zugeordneten Schlüssels. Gültige Werte: * Klartext: Standardzeichenfolge * html: HTML-Textzeichenfolge {#DynTran-getTranslation_S_O__ul_jk3_hhb_xhb} Standard: Klartext |
| parms.sourceLanguage | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die für die Übersetzung 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 für die Übersetzung des Texts (Groß-/Kleinschreibung nicht relevant). Gültige Werte: * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslation_S_O__ul_jdd_zbl_thq} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie [unter Mit einem Übersetzungsserviceanbieter integrieren](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Standard: In der Übersetzerkonfigurationstabelle \[sn_dt_translator_configuration\] konfigurierter Übersetzungsservice. |
[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" } |
| erkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| translations | Array von Objekten, die die Sprachübersetzungen beschreiben. Datentyp: Array translations": [ { "targetLanguage": "String", "translatedText": "String" } ] |
| „translations.targetLanguage" | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| Übersetzungen.translatedText | Ü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ückgibt, sowie Hinweise zu ihrer Ursache. * Text (Feld „Text") fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt oder ist keine Zeichenfolge. * Plugin für dynamische Übersetzung ist nicht installiert. (40001): Die Dynamische Übersetzungs -API wurde aufgerufen, ohne das Plugin „com.glide.dynamic_translation" zu aktivieren. Informationen zur Aktivierung dieses Plugins finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Der Standardübersetzer ist nicht für Übersetzung konfiguriert. (40002): In den Übersetzerkonfigurationen ist kein Übersetzungsservice als Standardübersetzungsservice ausgewählt. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Übersetzer (Feld „Übersetzer") ist ungültig. (40003): Der in Parameter translator übergebene Parameter ist keine Zeichenfolge. * \<translator\>Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> -Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht auf „ Aktiv " festgelegt. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-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): Der Parameter targetLanguages wird im Aufruf übergeben, ist jedoch aus einem der folgenden Gründe nicht gültig: * Der 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): Der Parameter sourceLanguage wird im Aufruf übergeben, der Wert ist jedoch keine Zeichenfolge. * Die zulässige Zeit 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 Übersetzung konfiguriert. (40012): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht für die Textübersetzung konfiguriert. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Unbekannter Fehler ist aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler in keiner anderen Kategorie liegt. * Text (Feld „Text") hat die 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): Der im Parameter sourceLanguage übergebene Code enthält einen Sprachcode, der vom entsprechenden Übersetzungsservice nicht unterstützt wird. * Zielsprache ist ungültig. (40054): Mindestens einer der im Parameter targetLanguages übergebenen Sprachcodes wird vom entsprechenden Übersetzungsservice nicht unterstützt. * Die Anforderung ist nicht autorisiert, da die Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice unter „Verbindungen und Anmeldeinformationen" konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-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. Ergebnisse]

{#DynTran-getTranslation_S_O__table_czb_4zk_thb}  
Dieses Beispiel zeigt ein Serverskript, das mithilfe des Übersetzungsservice von Microsoft Klartext 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) {#ariaid-title5}

Ü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 keine Übersetzungsparameter ü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 Textzeichenfolgen. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. "parms": { "additionalParameters": {Object}, "sourceLanguage": "String", "targetLanguages": [Array], "translator": "String" } |
| parms.additionalParameters | 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 bieten. "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| parms.zusätzlicheParameter.parameterName | Zeichenfolge | Optional. Schlüsselname Gültige Werte: texttype: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Dienst. |
| parms.zusätzlicheParameter.parameterWert | Zeichenfolge | Optional. Wert des zugeordneten Schlüssels. Gültige Werte: * Klartext: Standardzeichenfolge * html: HTML-Textzeichenfolge {#DynTran-getTranslations_A_O__ul_jk3_hhb_xhb} Standard: Klartext |
| parms.sourceLanguage | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die für die Übersetzung 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 für die Übersetzung des Texts (Groß-/Kleinschreibung nicht relevant). Gültige Werte: * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslations_A_O__ul_jdd_zbl_thq} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie [unter Mit einem Übersetzungsserviceanbieter integrieren](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Standard: In der Übersetzerkonfigurationstabelle \[sn_dt_translator_configuration\] konfigurierter Übersetzungsservice. |
[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 | Array von Objekten, die die Sprachübersetzungen beschreiben. Datentyp: Array translations": [ { "isError": Boolean; "detectedLanguage": {Object}, "textTranslations": [Array] } ] |
| Übersetzungen.isError | Kennzeichnung, die angibt, ob bei der Übersetzung des Texts ein Fehler aufgetreten ist. Gültige Werte: * true: Fehler aufgetreten. * „falsch": Textübersetzung war erfolgreich. {#DynTran-getTranslations_A_O__ul_gf5_zvl_4nb} Datentyp: Boolesch |
| Übersetzungen.erkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt "detectedLanguage": { "code": "String", "name": "String" } |
| Übersetzungen.erkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| translations.detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| textTranslations | Array von Objekten. Beschreibung der Sprache, die zum Übersetzen der Textzeichenfolge verwendet wird. "textTranslation": { "targetLanguage": "String", "translatedText": "String" } |
| textÜbersetzungen.Zielsprache | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| textÜbersetzungen.übersetzterText | Übersetzter Text. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der für die Übersetzung des Texts verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die -Methode zurückgibt, sowie Hinweise zu ihrer Ursache. * Text (Feld „Text") fehlt oder ist ungültig. (40000): Der zu übersetzende Text fehlt oder ist keine Zeichenfolge. * Plugin für dynamische Übersetzung ist nicht installiert. (40001): Die Dynamische Übersetzungs -API wurde aufgerufen, ohne das Plugin „com.glide.dynamic_translation" zu aktivieren. Informationen zur Aktivierung dieses Plugins finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Der Standardübersetzer ist nicht für Übersetzung konfiguriert. (40002): In den Übersetzerkonfigurationen ist kein Übersetzungsservice als Standardübersetzungsservice ausgewählt. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Übersetzer (Feld „Übersetzer") ist ungültig. (40003): Der in Parameter translator übergebene Parameter ist keine Zeichenfolge. * \<translator\>Übersetzer ist nicht konfiguriert. (40004): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht konfiguriert. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> -Übersetzer ist inaktiv. (40005): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht auf „ Aktiv " festgelegt. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-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): Der Parameter targetLanguages wird im Aufruf übergeben, ist jedoch aus einem der folgenden Gründe nicht gültig: * Der 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): Der Parameter sourceLanguage wird im Aufruf übergeben, der Wert ist jedoch keine Zeichenfolge. * Die zulässige Zeit 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): Beim Spracherkennungsaufruf sind mehrere Fehler aufgetreten. Weitere Informationen finden Sie in der Antwort für jede einzelne Textzeichenfolge. * \<translator\>Übersetzer ist nicht für Übersetzung konfiguriert. (40012): Der angegebene Übersetzungsservice ist in der Übersetzerkonfiguration nicht für die Textübersetzung konfiguriert. Informationen zum Erstellen/Ändern von Übersetzerkonfigurationen finden [Sie unter Übersetzerkonfiguration erstellen](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Übersetzerkonfigurationsversion ist ungültig. Migrieren Sie zu v3. (40014): Die zugeordnete Version der Übersetzerkonfiguration für den angegebenen Übersetzungsservice unterstützt die angegebene Textübersetzungsmethode nicht. Weitere Informationen finden Sie [unter Zu Version v3 einer Übersetzerkonfiguration migrieren](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Unbekannter Fehler ist aufgetreten. (40051): Standardfehler, der ausgelöst wird, wenn der Fehler in keiner anderen Kategorie liegt. * Text (Feld „Text") hat die 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): Der im Parameter sourceLanguage übergebene Code enthält einen Sprachcode, der vom entsprechenden Übersetzungsservice nicht unterstützt wird. * Zielsprache ist ungültig. (40054): Mindestens einer der im Parameter targetLanguages übergebenen Sprachcodes wird vom entsprechenden Übersetzungsservice nicht unterstützt. * Die Anforderung ist nicht autorisiert, da die Anmeldeinformationen fehlen oder ungültig sind (40055): Die für den Übersetzungsservice unter „Verbindungen und Anmeldeinformationen" konfigurierten Anmeldeinformationen sind ungültig. Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter [Übersicht über dynamische Übersetzung](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-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. Ergebnisse]

{#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 Teilweise-Status zurückgibt, wenn eine der beiden übergebenen Zeichenfolgen 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(String Translator) {#ariaid-title6}

Bestimmt, ob die verschiedenen Methoden in der DynamicTranslation- API für einen Übersetzungsservice aktiviert sind.
Wenn Sie einen bestimmten Übersetzungsservice übergeben, prüft die Methode die -Methodenaktivierung für diesen Übersetzungsservice. Andernfalls überprüft die Methode den Standardübersetzungsservice.
{#DynTran-isEnabled_S__table_qx5_nwl_thb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Übersetzer | Zeichenfolge | Optional. Übersetzungsservice, mit dem überprüft werden kann, ob die Methoden aktiv sind. Übersetzungsservices werden im Menü Übersetzerkonfiguration konfiguriert. Mögliche Werte, Groß-/Kleinschreibung nicht relevant: * Google * Microsoft * IBM * \<custom\> {#DynTran-isEnabled_S__ul_jdd_zbl_thb} Hinweis: Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie [unter Mit einem Übersetzungsserviceanbieter integrieren](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-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 die Methode „getDetectedLanguages() " aktiviert ist. Mögliche Werte: * true: Aktiviert * false: Deaktiviert {#DynTran-isEnabled_S__ul_g5j_gqm_4nb} Datentyp: Boolesch |
| batchTranslation | Kennzeichnung, die angibt, ob die Methode „getTranslations() " aktiviert ist. Mögliche Werte: * true: Aktiviert * false: Deaktiviert {#DynTran-isEnabled_S__ul_i5j_gqm_4nb} Datentyp: Boolesch |
| Erkennung | Kennzeichnung, die angibt, ob die Methode „getDetectedLanguage() " aktiviert ist. Mögliche Werte: * true: Aktiviert * false: Deaktiviert {#DynTran-isEnabled_S__ul_xtt_dzx_nnb} Datentyp: Boolesch |
| Übersetzung | Kennzeichnung, die angibt, ob die Methode „getTranslation() " aktiviert ist. Mögliche Werte: * true: Aktiviert * false: Deaktiviert {#DynTran-isEnabled_S__ul_ahy_fzx_nnb} Datentyp: Boolesch |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die API zurückgibt, sowie Hinweise zu ihrer Ursache. * Übersetzer (Feld „Übersetzer") ist ungültig. (40003): Der in Parameter translator übergebene Parameter ist keine Zeichenfolge. {#DynTran-isEnabled_S__ul_wp4_sfm_d3b} |
[Tabelle : 10. Ergebnisse]

{#DynTran-isEnabled_S__table_rx5_nwl_thb}  
Dieses Beispiel zeigt ein Serverskript, das überprüft, ob die DynamicTranslation- Methoden für den Microsoft Translator aktiv sind.

    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"}