---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Tradução dinâmica - com escopo

# Tradução dinâmica - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 24 min. de leitura

A API DynamicTranslation fornece métodos que traduzem texto, em tempo real, para vários idiomas usando provedores de serviço de tradução.

Além disso, você pode usar esta API para detectar o idioma de uma cadeia de caracteres específica e verificar se os métodos DynamicTranslation estão habilitados para um serviço de tradução. Use esta API para criar uma experiência de localização perfeita para a interface do usuário, permitindo que uma interface atenda a vários países.

Atualmente, esta API oferece suporte a dois provedores de serviços de tradução: o Serviço Microsoft Azure Translator e o Serviço Google Cloud Translator. Você também pode configurar outros serviços de tradução em sua instância e usar a API DynamicTranslation para traduzir seu texto.

Ao usar esses métodos em um script do lado do servidor, use o identificador de namespace `sn_dt_api`. Antes de poder usar esta API, você deve ativar o plug-in DynamicTranslation (com.glide.dynamic_translation). Para obter informações sobre este plug-in e informações adicionais sobre Tradução dinâmica, consulte [Visão geral da tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

## DynamicTranslation - getDetectedLanguage(cadeia de caracteres texto, parâmetros de objeto) {#ariaid-title2}

Detecta o idioma do texto passado.
Se você aprovar um tradutor, o método usará esse serviço de tradução para detectar o idioma de origem. Caso contrário, a detecção será realizada pelo serviço de tradução padrão. Certifique-se de que as cadeias de caracteres de texto fornecidas contenham texto suficiente para habilitar a detecção de idioma apropriada.

Além do idioma detectado, a resposta contém um nível de confiança da detecção, junto com outras alternativas de idioma possíveis. Se um tradutor não for passado, o método também retornará o serviço de tradução padrão usado para detectar o idioma.
{#DynTran-getDetectedLanguage_S_O__table_rym_ftl_thb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| texto | Cadeia de caracteres | Texto a ser usado para detectar o idioma. |
| parâmetros | Objeto | Opcional. Objeto JSON que contém parâmetros de tradução adicionais. |
| parâmetros.tradutor | Cadeia de caracteres | Opcional. Serviço de tradução a ser usado para traduzir o texto (sem distinção entre maiúsculas e minúsculas). Valores válidos: * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguage_S_O__ul_jdd_zbl_thq} Nota: Para usar serviços de tradução personalizados, você deve primeiro configurar o serviço de tradução em sua instância. Para obter detalhes, consulte [Integração com um provedor de serviço de tradução](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: serviço de tradução configurado na tabela Configuração do tradutor \[sn_dt_translator_configuration\]. |
[Tabela 1. Parâmetros]

{#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}

| Tipo | Descrição |
|-|-|
| alternativas | Matriz de objetos que descreve outros idiomas que também podem ser correspondentes. Tipo de dados: matriz "alternatives": [ { "code": "String", "confidence": "String", "name": "String" } ] |
| alternativas.código | Código de idioma do idioma alternativo. Tipo de dados: cadeia de caracteres |
| alternativas.confiança | Valor flutuante que indica o nível de confiança do idioma alternativo. O valor está entre zero e um. Quanto menor o valor, menor o nível de confiança. Tipo de dados: cadeia de caracteres |
| alternatives.name | Código de idioma do idioma alternativo. Tipo de dados: cadeia de caracteres |
| detectadoIdioma | Descrição do idioma detectado. Tipo de dados: objeto "detectedLanguage": { "code": "String", "confidence": "String", "name": "String" } |
| detectadoIdioma.código | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| detectouIdioma.confiança | Valor flutuante que indica o nível de confiança do idioma alternativo. O valor está entre zero e um. Quanto menor o valor, menor o nível de confiança. Tipo de dados: cadeia de caracteres |
| detectedLanguage.name | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| tradutor | Serviço de tradução usado para detectar o idioma. Tipo de dados: cadeia de caracteres |
| Mensagens de erro | A seguir estão as mensagens de erro que o método pode retornar e as indicações sobre a causa raiz do erro. * O texto (campo "text") está ausente ou é inválido. (40000): o texto a ser traduzido está ausente ou não é uma cadeia de caracteres. * O plug-in Tradução dinâmica não está instalado. (40001): a API de tradução dinâmica foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar este plug-in, consulte [Visão geral da Tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O tradutor (campo "tradutor") é inválido. (40003): o parâmetro passado translator não é uma cadeia de caracteres. * \<translator\>O tradutor não está configurado. (40004): o serviço de tradução especificado não está configurado na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> O tradutor está inativo. (40005): o serviço de tradução especificado não está definido como Ativo na Configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Os parâmetros adicionais são inválidos. (40006): os parâmetros adicionais que foram passados não são um objeto. * O limite de tempo máximo foi excedido. (40009): a operação demorou mais do que o valor de tempo limite especificado na configuração de tradução. Padrão: 40 segundos * O tradutor padrão não está configurado para detecção. (40011): o serviço de tradução padrão não foi especificado para detecção de idioma na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\>O tradutor não está configurado para detecção. (40013): o serviço de tradução especificado não está configurado para detecção de idioma na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Ocorreu um erro desconhecido. (40051): erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria. * O texto (campo "text") excedeu o tamanho máximo. (40052): o texto que foi passado para tradução excede o tamanho máximo suportado pelo serviço de tradução correspondente. * A solicitação não foi autorizada porque as credenciais estão ausentes ou são inválidas (40055): as credenciais configuradas para o serviço de tradução em Conexões e credenciais não são válidas. Para obter informações sobre conexões e credenciais, consulte [Visão geral da tradução dinâmica](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} |
[Tabela 2. Retorna]

{#DynTran-getDetectedLanguage_S_O__table_sym_ftl_thb}  
Este exemplo mostra o código em um script do lado do servidor que detecta uma cadeia de caracteres em inglês usando o serviço de tradução da IBM.

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

Saída:

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

Este exemplo mostra um script de servidor que gera um erro quando um serviço de tradução inválido é passado.

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

Saída:

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

## DynamicTranslation - getDetectedLanguages (textos de matriz, parâmetros de objeto) {#ariaid-title3}

Detecta os idiomas das cadeias de caracteres de texto passadas.
Se você aprovar um tradutor, o método usará esse serviço de tradução para detectar o idioma de origem. Caso contrário, a detecção será realizada pelo serviço de tradução padrão. Certifique-se de que as cadeias de caracteres de texto fornecidas contenham texto suficiente para habilitar a detecção de idioma apropriada.

Além do idioma detectado, a resposta contém um nível de confiança da detecção, junto com outras alternativas de idioma possíveis. Se um tradutor não for passado, o método também retornará o serviço de tradução padrão usado para detectar o idioma.
{#DynTran-getDetectedLanguages_A_O__table_mnq_h3q_nnb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| textos | Matriz | Lista de cadeias de caracteres de texto a serem usadas para detectar o(s) idioma(s). |
| parâmetros | Objeto | Opcional. Objeto JSON que contém parâmetros de tradução adicionais. "parms": { "translator": "String" } |
| parâmetros.tradutor | Cadeia de caracteres | Serviço de tradução a ser usado para detectar o idioma de uma cadeia de caracteres. Os serviços de tradução são configurados no menu Configuração do tradutor e localizados na tabela Configuração do tradutor \[sn_dt_translator_configuration\]. Valores possíveis - não diferencia maiúsculas de minúsculas: * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguages_A_O__ul_gwz_cjr_nnb} Nota: Para usar serviços de tradução personalizados, você deve primeiro configurar o serviço de tradução em sua instância. Para obter detalhes, consulte [Integração com um provedor de serviço de tradução](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: serviço de tradução configurado na tabela Configuração do tradutor \[sn_dt_translator_configuration\]. |
[Tabela 3. Parâmetros]

{#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}

| Tipo | Descrição |
|-|-|
| detecções | Detecção de idioma de cadeias de caracteres de texto. Tipo de dados: objeto "detections": { "alternatives": [Array], "detectedLanguage": {Object}, "isError": Boolean ] |
| detecções.alternativas | Matriz de objetos que descreve outros idiomas que também podem ser correspondentes. Tipo de dados: matriz "alternatives": [ { "code": "String", "confidence": "String", "name": "String" } ] |
| detecções.alternativas.código | Código de idioma do idioma alternativo. Tipo de dados: cadeia de caracteres |
| detecções.alternativas.confiança | Valor flutuante que indica o nível de confiança do idioma alternativo. O valor está entre zero e um. Quanto menor o valor, menor o nível de confiança. Tipo de dados: cadeia de caracteres |
| detections.alternatives.name | Código de idioma do idioma alternativo. Tipo de dados: cadeia de caracteres |
| detecções.detectadoIdioma | Descrição do idioma detectado. Tipo de dados: objeto "detectedLanguage": { "code": "String", "confidence": "String", "name": "String" } |
| detecções.detectedLanguage.code | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| detecções.detectadoIdioma.confiança | Valor flutuante que indica o nível de confiança do idioma alternativo. O valor está entre zero e um. Quanto menor o valor, menor o nível de confiança. Tipo de dados: cadeia de caracteres |
| detections.detectedLanguage.name | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| detecções.éErro | Sinalizador que indica se a detecção de idioma para o texto resultou em um erro. Valores válidos: * verdadeiro: erro encontrado. * falso: a detecção de idioma foi bem-sucedida. {#DynTran-getDetectedLanguages_A_O__ul_alf_hmq_nnb} Tipo de dados: booliano |
| status | Status da resposta à chamada de método. Valores possíveis: * Erro * Parcial * Êxito {#DynTran-getDetectedLanguages_A_O__ul_slc_rmq_nnb} Tipo de dados: cadeia de caracteres |
| tradutor | Serviço de tradução usado para detectar o idioma. Tipo de dados: cadeia de caracteres |
| Mensagens de erro | A seguir estão as mensagens de erro que o método pode retornar e as indicações sobre a causa raiz do erro. * O texto (campo "text") está ausente ou é inválido. (40000): o texto a ser traduzido está ausente ou não é uma cadeia de caracteres. * O plug-in Tradução dinâmica não está instalado. (40001): a API de tradução dinâmica foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar este plug-in, consulte [Visão geral da Tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O tradutor (campo "tradutor") é inválido. (40003): o parâmetro passado translator não é uma cadeia de caracteres. * \<translator\>O tradutor não está configurado. (40004): o serviço de tradução especificado não está configurado na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> O tradutor está inativo. (40005): o serviço de tradução especificado não está definido como Ativo na Configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Os parâmetros adicionais são inválidos. (40006): os parâmetros adicionais que foram passados não são um objeto. * O limite de tempo máximo foi excedido. (40009): a operação demorou mais do que o valor de tempo limite especificado na configuração de tradução. Padrão: 40 segundos * Falha na solicitação com vários erros. (40010): ocorreram vários erros na chamada de detecção de idioma. Para obter mais informações, consulte a resposta de cada cadeia de caracteres de texto individual. * O tradutor padrão não está configurado para detecção. (40011): o serviço de tradução padrão não foi especificado para detecção de idioma na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\>O tradutor não está configurado para detecção. (40013): o serviço de tradução especificado não está configurado para detecção de idioma na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * A versão da configuração do tradutor é inválida. Migre para v3. (40014): a versão associada da configuração do tradutor para o serviço de tradução especificado não é compatível com o método de tradução de texto especificado. Para obter mais informações, consulte [Como migrar para a versão v3 de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Ocorreu um erro desconhecido. (40051): erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria. * O texto (campo "text") excedeu o tamanho máximo. (40052): o texto que foi passado para tradução excede o tamanho máximo suportado pelo serviço de tradução correspondente. * A solicitação não foi autorizada porque as credenciais estão ausentes ou são inválidas (40055): as credenciais configuradas para o serviço de tradução em Conexões e credenciais não são válidas. Para obter informações sobre conexões e credenciais, consulte [Visão geral da tradução dinâmica](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} |
[Tabela 4. Retorna]

{#DynTran-getDetectedLanguages_A_O__table_nnq_h3q_nnb}  
Este exemplo mostra o código em um script de servidor que detecta o inglês como o idioma das cadeias de caracteres passadas usando o serviço de tradução da Microsoft.

    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));

Saída

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

Este exemplo mostra o código em um script de servidor que retorna um status Parcial quando duas cadeias de caracteres de texto são passadas e uma delas é inválida.

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

Saída

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

Este exemplo mostra o código em um script de servidor que gera um erro quando um serviço de tradução inválido é passado.

    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));

Saída

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

## DynamicTranslation - getTranslation(String textToTranslate, parâmetros do objeto) {#ariaid-title4}

Traduz o texto passado para um ou mais idiomas.
O método usa serviços de tradução, como o Serviço Microsoft Azure Translator e o Serviço Google Cloud Translator, para executar a tradução. Se você não passar os parâmetros de tradução, o método usará o padrão do sistema.
{#DynTran-getTranslation_S_O__table_bzb_4zk_thb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| textoParaTraduzir | Cadeia de caracteres | Texto a ser traduzido. |
| parâmetros | Objeto | Opcional. Objeto JSON que contém parâmetros de tradução adicionais. "parms": { "additionalParameters": {Object}, "sourceLanguage": "String", "targetLanguages": [Array], "translator": "String" } |
| parâmetros.parâmetrosadicionais | Matriz | Opcional. Matriz de objetos JSON. Cada objeto contém pares de chave-valor que fornecem informações adicionais para executar a tradução. "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| parms.additionalParameters.parameterName | Cadeia de caracteres | Opcional. Nome da chave. Valores válidos: texttype: tipo de texto a ser traduzido. Somente para o Serviço Microsoft Azure Translator. |
| parms.additionalParameters.parameterValue | Cadeia de caracteres | Opcional. Valor da chave associada. Valores válidos: * simples: cadeia de caracteres de texto padrão * html: cadeia de caracteres de texto HTML {#DynTran-getTranslation_S_O__ul_jk3_hhb_xhb} Padrão: simples |
| parms.sourceLanguage | Cadeia de caracteres | Opcional. Código do idioma do texto de origem. Padrão: o serviço de tradução detecta o idioma de origem. |
| parms.targetLanguages | Matriz | Opcional. Lista de códigos de idioma a serem usados para traduzir o texto. O método retorna o texto traduzido para cada código de idioma. Padrão: idioma preferencial do usuário. |
| parâmetros.tradutor | Cadeia de caracteres | Opcional. Serviço de tradução a ser usado para traduzir o texto (sem distinção entre maiúsculas e minúsculas). Valores válidos: * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslation_S_O__ul_jdd_zbl_thq} Nota: Para usar serviços de tradução personalizados, você deve primeiro configurar o serviço de tradução em sua instância. Para obter detalhes, consulte [Integração com um provedor de serviço de tradução](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: serviço de tradução configurado na tabela Configuração do tradutor \[sn_dt_translator_configuration\]. |
[Tabela 5. Parâmetros]

{#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}

| Tipo | Descrição |
|-|-|
| detectadoIdioma | Descrição do idioma detectado. Tipo de dados: objeto "detectedLanguage": { "code": "String", "name": "String" } |
| detectadoIdioma.código | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| detectedLanguage.name | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| traduções | Matriz de objetos que descreve as traduções de idioma. Tipo de dados: matriz translations": [ { "targetLanguage": "String", "translatedText": "String" } ] |
| traduções.targetLanguage | Código do idioma para o qual o texto de origem foi traduzido. Tipo de dados: cadeia de caracteres |
| traduções.TextoTraduzido | Texto traduzido. Tipo de dados: cadeia de caracteres |
| tradutor | Serviço de tradução usado para detectar o idioma. Tipo de dados: cadeia de caracteres |
| Mensagens de erro | A seguir estão as mensagens de erro que o método pode retornar e as indicações sobre a causa raiz. * O texto (campo "text") está ausente ou é inválido. (40000): o texto a ser traduzido está ausente ou não é uma cadeia de caracteres. * O plug-in Tradução dinâmica não está instalado. (40001): a API de tradução dinâmica foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar este plug-in, consulte [Visão geral da Tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O tradutor padrão não está configurado para tradução. (40002): nenhum serviço de tradução está selecionado como o serviço de tradução padrão nas configurações do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O tradutor (campo "tradutor") é inválido. (40003): o parâmetro passado translator não é uma cadeia de caracteres. * \<translator\>O tradutor não está configurado. (40004): o serviço de tradução especificado não está configurado na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> O tradutor está inativo. (40005): o serviço de tradução especificado não está definido como Ativo na Configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Os parâmetros adicionais são inválidos. (40006): os parâmetros adicionais que foram passados não são um objeto. * Os idiomas de destino (campo "targetLanguages") são inválidos. (40007): o parâmetro targetLanguages é passado na chamada, mas não é válido por um dos seguintes motivos: * O valor não é uma matriz * A matriz está vazia * Uma ou várias entradas não são uma cadeia de caracteres {#DynTran-getTranslation_S_O__ul_zdj_4b4_b3b} * O idioma de origem (campo "sourceLanguage") é inválido. (40008): o parâmetro sourceLanguage é passado na chamada, mas o valor não é uma cadeia de caracteres. * O limite de tempo máximo foi excedido. (40009): a operação demorou mais do que o valor de tempo limite especificado na configuração de tradução. Padrão: 40 segundos * \<translator\>O tradutor não está configurado para tradução. (40012): o serviço de tradução especificado não está configurado para tradução de texto na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Ocorreu um erro desconhecido. (40051): erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria. * O texto (campo "text") excedeu o tamanho máximo. (40052): o texto que foi passado para tradução excede o tamanho máximo suportado pelo serviço de tradução correspondente. * O idioma de origem é inválido. (40053): o parâmetro passado sourceLanguage contém um código de idioma que não é compatível com o serviço de tradução correspondente. * O idioma de destino é inválido. (40054): um ou mais dos códigos de idioma passados no parâmetro targetLanguages não são compatíveis com o serviço de tradução correspondente. * A solicitação não foi autorizada porque as credenciais estão ausentes ou são inválidas (40055): as credenciais configuradas para o serviço de tradução em Conexões e credenciais não são válidas. Para obter informações sobre conexões e credenciais, consulte [Visão geral da tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O texto não pode ser traduzido para os idiomas de destino. (40056): o serviço de tradução especificado não pode traduzir o texto passado para os idiomas de destino especificados. {#DynTran-getTranslation_S_O__ul_ccq_ntm_b3b} |
[Tabela 6. Retorna]

{#DynTran-getTranslation_S_O__table_czb_4zk_thb}  
Este exemplo mostra um script de servidor traduzindo texto simples de inglês (detectado) para francês e italiano usando o serviço de tradução da Microsoft.

    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);
    }

Resposta:

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

Este exemplo mostra um script de servidor que gera um erro quando um idioma de destino inválido é passado.

    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);
    }

Resposta:

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

## DynamicTranslation - getTranslations (textos de matriz, parâmetros de objeto) {#ariaid-title5}

Traduz as cadeias de caracteres de texto passadas para um ou mais idiomas.
O método usa serviços de tradução, como o Serviço Microsoft Azure Translator e o Serviço Google Cloud Translator, para executar a tradução. Se você não passar os parâmetros de tradução, o método usará o padrão do sistema.
{#DynTran-getTranslations_A_O__table_bzb_4zk_thb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| textos | Matriz | Lista de textos a serem traduzidos. |
| parâmetros | Objeto | Opcional. Objeto JSON que contém parâmetros de tradução adicionais. "parms": { "additionalParameters": {Object}, "sourceLanguage": "String", "targetLanguages": [Array], "translator": "String" } |
| parâmetros.parâmetrosadicionais | Objeto | Opcional. Matriz de objetos JSON. Cada objeto contém pares de chave-valor que fornecem informações adicionais para executar a tradução. "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| parms.additionalParameters.parameterName | Cadeia de caracteres | Opcional. Nome da chave. Valores válidos: texttype: tipo de texto a ser traduzido. Somente para o Serviço Microsoft Azure Translator. |
| parms.additionalParameters.parameterValue | Cadeia de caracteres | Opcional. Valor da chave associada. Valores válidos: * simples: cadeia de caracteres de texto padrão * html: cadeia de caracteres de texto HTML {#DynTran-getTranslations_A_O__ul_jk3_hhb_xhb} Padrão: simples |
| parms.sourceLanguage | Cadeia de caracteres | Opcional. Código do idioma do texto de origem. Padrão: o serviço de tradução detecta o idioma de origem. |
| parms.targetLanguages | Matriz | Opcional. Lista de códigos de idioma a serem usados para traduzir o texto. O método retorna o texto traduzido para cada código de idioma. Padrão: idioma preferencial do usuário. |
| parâmetros.tradutor | Cadeia de caracteres | Opcional. Serviço de tradução a ser usado para traduzir o texto (sem distinção entre maiúsculas e minúsculas). Valores válidos: * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslations_A_O__ul_jdd_zbl_thq} Nota: Para usar serviços de tradução personalizados, você deve primeiro configurar o serviço de tradução em sua instância. Para obter detalhes, consulte [Integração com um provedor de serviço de tradução](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: serviço de tradução configurado na tabela Configuração do tradutor \[sn_dt_translator_configuration\]. |
[Tabela 7. Parâmetros]

{#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}

| Tipo | Descrição |
|-|-|
| status | Status da resposta à chamada de método. Valores possíveis: * Erro * Parcial * Êxito {#DynTran-getTranslations_A_O__ul_slc_rmq_nnb} Tipo de dados: cadeia de caracteres |
| traduções | Matriz de objetos que descreve as traduções de idioma. Tipo de dados: matriz translations": [ { "isError": Boolean; "detectedLanguage": {Object}, "textTranslations": [Array] } ] |
| traduções.éErro | Sinalizador que indica se a tradução do texto resultou em erro. Valores válidos: * verdadeiro: erro encontrado. * falso: a tradução de texto foi bem-sucedida. {#DynTran-getTranslations_A_O__ul_gf5_zvl_4nb} Tipo de dados: booliano |
| traduções.detectadoIdioma | Descrição do idioma detectado. Tipo de dados: objeto "detectedLanguage": { "code": "String", "name": "String" } |
| traduções.detectadoIdioma.código | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| translations.detectedLanguage.name | Código de idioma do idioma detectado. Tipo de dados: cadeia de caracteres |
| Traduções de texto | Matriz de objetos. Descrição do idioma usado para traduzir a cadeia de caracteres de texto. "textTranslation": { "targetLanguage": "String", "translatedText": "String" } |
| TraduçõesDeTexto.IdiomaDeDestino | Código do idioma para o qual o texto de origem foi traduzido. Tipo de dados: cadeia de caracteres |
| textoTraduções.Textotraduzido | Texto traduzido. Tipo de dados: cadeia de caracteres |
| tradutor | Serviço de tradução usado para traduzir o texto. Tipo de dados: cadeia de caracteres |
| Mensagens de erro | A seguir estão as mensagens de erro que o método pode retornar e as indicações sobre a causa raiz. * O texto (campo "text") está ausente ou é inválido. (40000): o texto a ser traduzido está ausente ou não é uma cadeia de caracteres. * O plug-in Tradução dinâmica não está instalado. (40001): a API de tradução dinâmica foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar este plug-in, consulte [Visão geral da Tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O tradutor padrão não está configurado para tradução. (40002): nenhum serviço de tradução está selecionado como o serviço de tradução padrão nas configurações do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O tradutor (campo "tradutor") é inválido. (40003): o parâmetro passado translator não é uma cadeia de caracteres. * \<translator\>O tradutor não está configurado. (40004): o serviço de tradução especificado não está configurado na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * \<translator\> O tradutor está inativo. (40005): o serviço de tradução especificado não está definido como Ativo na Configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Os parâmetros adicionais são inválidos. (40006): os parâmetros adicionais que foram passados não são um objeto. * Os idiomas de destino (campo "targetLanguages") são inválidos. (40007): o parâmetro targetLanguages é passado na chamada, mas não é válido por um dos seguintes motivos: * O valor não é uma matriz * A matriz está vazia * Uma ou várias entradas não são uma cadeia de caracteres {#DynTran-getTranslations_A_O__ul_zdj_4b4_b3b} * O idioma de origem (campo "sourceLanguage") é inválido. (40008): o parâmetro sourceLanguage é passado na chamada, mas o valor não é uma cadeia de caracteres. * O limite de tempo máximo foi excedido. (40009): a operação demorou mais do que o valor de tempo limite especificado na configuração de tradução. Padrão: 40 segundos * Falha na solicitação com vários erros. (40010): ocorreram vários erros na chamada de detecção de idioma. Para obter mais informações, consulte a resposta de cada cadeia de caracteres de texto individual. * \<translator\>O tradutor não está configurado para tradução. (40012): o serviço de tradução especificado não está configurado para tradução de texto na configuração do tradutor. Para obter informações sobre como criar/modificar uma configuração de tradutor, consulte [Criação de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * A versão da configuração do tradutor é inválida. Migre para v3. (40014): a versão associada da configuração do tradutor para o serviço de tradução especificado não é compatível com o método de tradução de texto especificado. Para obter mais informações, consulte [Como migrar para a versão v3 de uma configuração de tradutor](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * Ocorreu um erro desconhecido. (40051): erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria. * O texto (campo "text") excedeu o tamanho máximo. (40052): o texto que foi passado para tradução excede o tamanho máximo suportado pelo serviço de tradução correspondente. * O idioma de origem é inválido. (40053): o parâmetro passado sourceLanguage contém um código de idioma que não é compatível com o serviço de tradução correspondente. * O idioma de destino é inválido. (40054): um ou mais dos códigos de idioma passados no parâmetro targetLanguages não são compatíveis com o serviço de tradução correspondente. * A solicitação não foi autorizada porque as credenciais estão ausentes ou são inválidas (40055): as credenciais configuradas para o serviço de tradução em Conexões e credenciais não são válidas. Para obter informações sobre conexões e credenciais, consulte [Visão geral da tradução dinâmica](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). * O texto não pode ser traduzido para os idiomas de destino. (40056): o serviço de tradução especificado não pode traduzir o texto passado para os idiomas de destino especificados. {#DynTran-getTranslations_A_O__ul_ccq_ntm_b3b} |
[Tabela 8. Retorna]

{#DynTran-getTranslations_A_O__table_czb_4zk_thb}  
Este exemplo mostra o código em um script do lado do servidor que traduz uma lista de cadeias de caracteres de texto para francês e italiano usando o serviço de tradução da Microsoft.

    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);
    }

Resposta:

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

Este exemplo mostra um script de servidor que retorna um status Parcial quando uma das duas cadeias de caracteres de texto passadas é inválida.

    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);
    }

Resposta:

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

Este exemplo mostra um script de servidor que gera um erro quando um serviço de tradução inválido é passado.

    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);
    }

Resposta:

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

## DynamicTranslation - isEnabled (tradutor de cadeia de caracteres) {#ariaid-title6}

Determina se os vários métodos na API DynamicTranslation estão habilitados para um serviço de tradução.
Se você aprovar um serviço de tradução específico, o método verificará a ativação do método para esse serviço de tradução; caso contrário, o método verificará o serviço de tradução padrão.
{#DynTran-isEnabled_S__table_qx5_nwl_thb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tradutor | Cadeia de caracteres | Opcional. Serviço de tradução a ser usado para verificar se os métodos estão ativos. Os serviços de tradução são configurados no menu Configuração do tradutor. Valores possíveis - não diferencia maiúsculas de minúsculas: * Google * Microsoft * IBM * \<custom\> {#DynTran-isEnabled_S__ul_jdd_zbl_thb} Nota: Para usar serviços de tradução personalizados, você deve primeiro configurar o serviço de tradução em sua instância. Para obter detalhes, consulte [Integração com um provedor de serviço de tradução](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: serviço de tradução padrão. |
[Tabela 9. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| detecção em lote | Sinalizador que indica se o método getDetectedLanguages() está habilitado. Valores possíveis: * verdadeiro: habilitado * falso: desabilitado {#DynTran-isEnabled_S__ul_g5j_gqm_4nb} Tipo de dados: booliano |
| tradução em lote | Sinalizador que indica se o método getTranslations() está habilitado. Valores possíveis: * verdadeiro: habilitado * falso: desabilitado {#DynTran-isEnabled_S__ul_i5j_gqm_4nb} Tipo de dados: booliano |
| detecção | Sinalizador que indica se o método getDetectedLanguage() está habilitado. Valores possíveis: * verdadeiro: habilitado * falso: desabilitado {#DynTran-isEnabled_S__ul_xtt_dzx_nnb} Tipo de dados: booliano |
| tradução | Sinalizador que indica se o método getTranslation() está habilitado. Valores possíveis: * verdadeiro: habilitado * falso: desabilitado {#DynTran-isEnabled_S__ul_ahy_fzx_nnb} Tipo de dados: booliano |
| Mensagens de erro | A seguir estão as mensagens de erro que a API pode retornar e as indicações sobre a causa raiz. * O tradutor (campo "tradutor") é inválido. (40003): o parâmetro passado translator não é uma cadeia de caracteres. {#DynTran-isEnabled_S__ul_wp4_sfm_d3b} |
[Tabela 10. Retorna]

{#DynTran-isEnabled_S__table_rx5_nwl_thb}  
Este exemplo mostra um script de servidor que verifica se os métodos DynamicTranslation estão ativos para o tradutor da Microsoft.

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

Saída:

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

Este exemplo mostra um script de servidor que gera um erro quando um serviço de tradução inválido é passado.

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

Saída:

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