DynamicTranslation - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 27 min. de leitura
  • . DynamicTranslation A API fornece métodos que traduzem texto, em tempo real, em vários idiomas usando provedores de serviço de tradução. Esta API está disponível para clientes padrão e baseados em angular Portal de serviços clientes.

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

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

    Para usar esta API, você deve ativar o plug-in Tradução dinâmica. 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 . Para usar esta API em um Portal de serviços Widget, você deve injetar o serviço dynamicTranslation na função de script do cliente do widget.

    Nota:
    O nome da classe a ser usada em Portal de serviços os clientes são DynamicTranslation , enquanto o nome da classe a ser usada em clientes padrão é DynamicTranslation .

    DynamicTranslation - getDetectedLanguage(texto de cadeia de caracteres, parâmetros de objeto)

    Detecta o idioma do texto passado.

    Se você passar 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 que você fornece 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.

    Tabela 1. Parâmetros
    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.
    "parms": {
      "translator": "String"
    }
    parms.translator 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 em Configuração do tradutor menu.

    Valores possíveis - não diferencia maiúsculas de minúsculas:

    • Google
    • Microsoft
    • IBM
    • <custom>
    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 Integre com um provedor de serviços de tradução .

    Serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

    Configuração do tradutor [sn_dt_translator_configuration]

    Tabela 2. Retornos
    Tipo Descrição
    alternativas Matriz de objetos que descrevem outros idiomas que também podem ser uma correspondência.

    Tipo de dados: Matriz

    "alternatives": [
      {
        "code": "String",
        "confidence": "String",
        "name": "String"
      }
    ]
    alternatives.code Código 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. Menor o valor, menor o nível de confiança.

    Tipo de dados: Cadeia de caracteres

    alternatives.name Código do idioma alternativo.

    Tipo de dados: Cadeia de caracteres

    DetectedLanguage Descrição do idioma detectado.

    Tipo de dados: Objeto

    "detectedLanguage": {
      "code": "String",
      "confidence": "String",
      "name": "String"
    }
    DetectedLanguage.code Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    DetectedLanguage.confidence Valor flutuante que indica o nível de confiança do idioma alternativo. O valor está entre zero e um. Menor o valor, menor o nível de confiança.

    Tipo de dados: Cadeia de caracteres

    detectedLanguage.name Código 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 mensagens de erro que o método pode retornar e indicações sobre a causa raiz do erro.
    • O texto (campo "texto") está ausente ou é inválido. (40000): O texto para detectar o idioma está ausente ou não é uma cadeia de caracteres.
    • O plug-in Tradução dinâmica não está instalado. (40001): O. Tradução dinâmica A API 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 .
    • O tradutor (campo "tradutor") é inválido. (40003): O aprovado translatoro parâmetro não é uma cadeia de caracteres.
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • Parâmetros adicionais 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 levou mais tempo do que o valor de tempo limite definido 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 Crie uma configuração de tradutor .
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • Ocorreu um erro desconhecido. (40051): Erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria.
    • O texto (campo "texto") excedeu o tamanho máximo. (40052): O texto que foi passado para detecções de idioma excede o tamanho máximo compatível com o serviço de tradução correspondente.
    • A solicitação não está autorizada porque as credenciais estão ausentes ou 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 .

    Este exemplo mostra o código que detecta uma cadeia de caracteres em inglês usando o serviço de tradução da IBM em um client script padrão.

    var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );

    Saída:

    detectedResponse {
      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 client script que gera um erro quando um serviço de tradução inválido é passado.

    var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
    Saída:
    {"code":"40003","message":"Translator (\"translator\" field) is invalid"}

    Este exemplo mostra o código que detecta uma cadeia de caracteres em inglês usando o serviço de tradução da IBM em um Portal de serviços client script de widget. Observe que o nome da classe é DynamicTranslation não DynamicTranslation .

    var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
    Saída:
    detectedResponse {
      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 Portal de serviços script de cliente de widget que gera um erro quando um serviço de tradução inválido é passado.

    var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
    Saída:
    {"code":"40003","message":"Translator (\"translator\" field) is invalid"}

    DynamicTranslation - getDetectedLanguages(textos de matriz, parâmetros de objeto)

    Detecta os idiomas das passadas em cadeias de caracteres de texto.

    Se você passar 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 que você fornece 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.

    Ao chamar este método a partir de um client script do portal, use o nome da classe DynamicTranslation , como DynamicTranslation.getTranslations() . Ao chamá-lo de um client script da plataforma, use o nome da classe DynamicTranslation , como DynamicTranslation.getTranslations() .

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    parâmetros Objeto Opcional. Objeto JSON que contém parâmetros de tradução adicionais.
    "parms": {
      "translator": "String"
    }
    parms.translator 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 em Configuração do tradutor menu.

    Valores possíveis - não diferencia maiúsculas de minúsculas:

    • Google
    • Microsoft
    • IBM
    • <custom>
    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 Integre com um provedor de serviços de tradução .

    Serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

    Configuração do tradutor [sn_dt_translator_configuration]

    textos Matriz Lista de cadeias de caracteres de texto a serem usadas para detectar o(s) idioma(s).
    Tabela 4. Retornos
    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 descrevem outros idiomas que também podem ser uma correspondência.

    Tipo de dados: Matriz

    "alternatives": [
      {
        "code": "String",
        "confidence": "String",
        "name": "String"
      }
    ]
    detections.alternatives.code Código 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. Menor o valor, menor o nível de confiança.

    Tipo de dados: Cadeia de caracteres

    detections.alternatives.name Código do idioma alternativo.

    Tipo de dados: Cadeia de caracteres

    detections.detectedLanguage Descrição do idioma detectado.

    Tipo de dados: Objeto

    "detectedLanguage": {
      "code": "String",
      "confidence": "String",
      "name": "String"
    }
    detections.detectedLanguage.code Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    detections.detectedLanguage.confidence Valor flutuante que indica o nível de confiança do idioma alternativo. O valor está entre zero e um. Menor o valor, menor o nível de confiança.

    Tipo de dados: Cadeia de caracteres

    detections.detectedLanguage.name Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    Detecções.éErro Sinalizador que indica se a detecção do idioma do texto resultou em um erro.
    Valores válidos:
    • Verdadeiro: Erro encontrado.
    • Falso: A detecção de idioma foi bem-sucedida.

    Tipo de dados: Booliano

    status Status da resposta à chamada do método.
    Valores possíveis:
    • Erro
    • Parcial
    • Êxito

    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 mensagens de erro que o método pode retornar e indicações sobre a causa raiz do erro.
    • O texto (campo "texto") está ausente ou é inválido. (40000): O texto para detectar o idioma está ausente ou não é uma cadeia de caracteres.
    • O plug-in Tradução dinâmica não está instalado. (40001): O. Tradução dinâmica A API 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 .
    • O tradutor (campo "tradutor") é inválido. (40003): O aprovado translatoro parâmetro não é uma cadeia de caracteres.
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • Parâmetros adicionais 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 levou mais tempo do que o valor de tempo limite definido 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 Crie uma configuração de tradutor .
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • A versão da configuração do tradutor é inválida. Migrar 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 Migrar para a versão v3 de uma configuração de tradutor .
    • Ocorreu um erro desconhecido. (40051): Erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria.
    • O texto (campo "texto") excedeu o tamanho máximo. (40052): O texto que foi passado para detecções de idioma excede o tamanho máximo compatível com o serviço de tradução correspondente.
    • A solicitação não está autorizada porque as credenciais estão ausentes ou 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 .

    Este exemplo mostra o código de um client script do portal que detecta o inglês como o idioma das cadeias de caracteres transmitidas usando o serviço de tradução da Microsoft.

    var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "Microsoft"}).then(function(res) {console.log(res);}, function(res) {console.log(res);});
    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 client script do portal que retorna um status Parcial quando duas cadeias de caracteres de texto são passadas e uma delas é inválida. Para usar este exemplo de código em um client script de plataforma, mude DynamicTranslation.getDetectedLanguages . DynamicTranslation.getDetectedLanguages .

    var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", ""], {"translator": "Microsoft"}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
    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 de um client script do portal que gera um erro quando um serviço de tradução inválido é passado. Para usar este exemplo de código para um client script de plataforma, mude DynamicTranslation.getDetectedLanguages . DynamicTranslation.getDetectedLanguages .

    var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "123"}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
    gs.info(JSON.stringify(detectedResponse));

    Saída

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

    DynamicTranslation - getTranslation (cadeia de caracteres textToTranslate, parâmetros de objeto)

    Traduz o texto passado em um ou mais idiomas.

    O método usa serviços de tradução, como o Serviço do Microsoft Azure Translator e o Serviço do Google Cloud Translator, para executar a tradução. Se você não passar parâmetros de tradução, o método usará o padrão do sistema.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    TextToTranslate 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"
    }
    Parms.Parâmetros adicionais 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.Parâmetros adicionais.ParameterName Cadeia de caracteres Opcional. Nome da chave.

    Valores válidos:

    Textype: Tipo de texto a ser traduzido. Microsoft Azure Translator Service somente.

    Parms.Parâmetros.adicionais.ParameterValue Cadeia de caracteres Opcional. Valor da chave associada.

    Valores válidos:

    • html: Cadeia de caracteres de texto HTML
    • Simples: Cadeia de caracteres de texto padrão

    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 texto traduzido para cada código de idioma.

    Padrão: Idioma preferencial do usuário.

    parms.translator Cadeia de caracteres Opcional. Serviço de tradução a ser usado para traduzir o texto (não diferencia maiúsculas de minúsculas).

    Valores válidos:

    • Google
    • Microsoft
    • IBM
    • <custom>
    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 Integre com um provedor de serviços de tradução .

    Serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

    Tabela 6. Retornos
    Tipo Descrição
    DetectedLanguage Descrição do idioma detectado.

    Tipo de dados: Objeto

    "detectedLanguage": {
      "code": "String",
      "name": "String"
    }
    DetectedLanguage.code Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    detectedLanguage.name Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    traduções Lista que descrevem as traduções de idioma.

    Tipo de dados: Matriz de objetos

    translations": [
      {
        "targetLanguage": "String",
        "translatedText": "String"
      }
    ]
    Translations.targetLanguage Código do idioma para o qual o texto de origem foi traduzido.

    Tipo de dados: Cadeia de caracteres

    Traduções.Texto traduzido 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 mensagens de erro que o método pode retornar e indicações sobre sua causa raiz.
    • O texto (campo "texto") 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): O. Tradução dinâmica A API 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 .
    • O tradutor padrão não está configurado para tradução. (40002): Nenhum serviço de tradução foi 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 Crie uma configuração de tradutor .
    • O tradutor (campo "tradutor") é inválido. (40003): O aprovado translatoro parâmetro não é uma cadeia de caracteres.
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • Parâmetros adicionais 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. targetLanguageso parâmetro foi 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 das entradas não é uma cadeia de caracteres
    • O idioma de origem (campo "sourceLanguage") é inválido. (40008): O. sourceLanguageO parâmetro é passado na chamada, mas o valor não é uma cadeia de caracteres.
    • O limite de tempo máximo foi excedido. (40009): A operação levou mais tempo do que o valor de tempo limite definido especificado na Configuração de tradução. Padrão: 40 segundos
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • Ocorreu um erro desconhecido. (40051): Erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria.
    • O texto (campo "texto") excedeu o tamanho máximo. (40052): O texto que foi passado para traduzir excede o tamanho máximo compatível com o serviço de tradução correspondente.
    • O idioma de origem é inválido. (40053): O aprovado sourceLanguageo parâmetro 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 targetLanguageso parâmetro não é compatível com o serviço de tradução correspondente.
    • A solicitação não está autorizada porque as credenciais estão ausentes ou 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 .
    • 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 nos idiomas de destino especificados.

    Este exemplo mostra a tradução de conteúdo de texto sem formatação do inglês (detectado) para francês e italiano usando o serviço de tradução da Microsoft em um client script padrão.

    DynamicTranslation.getTranslation("Translate this text using platform from client", {
      "targetLanguages": ["fr", "it"],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": "Microsoft"
     }).then(function(res){console.log(res);}, function(res){console.log(res);});
    

    Resposta:

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

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

    DynamicTranslation.getTranslation("Translate this text using platform from client", {
      "targetLanguages": ["123"],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": "Microsoft"
     }).then(function(res){console.log(res);}, function(res){console.log(res);});
    

    Resposta:

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

    Este exemplo mostra a tradução de conteúdo de texto sem formatação do inglês (detectado) para francês e italiano usando o serviço de tradução da Microsoft em um Portal de serviços client script de widget. Observe que o nome da classe é DynamicTranslation não DynamicTranslation .

    dynamicTranslation.getTranslation("Translate this text using platform from client", {
      "targetLanguages": ["fr", "it"],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": "Microsoft"
     }).then(function(res){console.log(res);}, function(res){console.log(res);});
    

    Resposta:

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

    Este exemplo mostra um Portal de serviços script de cliente de widget que gera um erro quando um idioma de destino inválido é passado

    dynamicTranslation.getTranslation("Translate this text using platform from client", {
      "targetLanguages": [123],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": "Microsoft"
     }).then(function(res){console.log(res);}, function(res){console.log(res);});
    

    Resposta:

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

    DynamicTranslation - getTranslations (textos de matriz, parâmetros de objeto)

    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 do Microsoft Azure Translator e o Serviço do Google Cloud Translator, para executar a tradução. Se você não passar parâmetros de tradução, o método usará o padrão do sistema.

    Ao chamar este método a partir de um client script do portal, use o nome da classe DynamicTranslation , como DynamicTranslation.getTranslations() . Ao chamá-lo de um client script da plataforma, use o nome da classe DynamicTranslation , como DynamicTranslation.getTranslations() .

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    textos Matriz Lista de marcações de texto a serem traduzidas.
    parâmetros Objeto Opcional. Objeto JSON que contém parâmetros de tradução adicionais.
    "parms": {
      "additionalParameters": {Object},
      "sourceLanguage": "String",
      "targetLanguages": [Array],
      "translator": "String"
    }
    Parms.Parâmetros adicionais 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.Parâmetros adicionais.ParameterName Cadeia de caracteres Opcional. Nome da chave.

    Valores válidos:

    Textype: Tipo de texto a ser traduzido. Microsoft Azure Translator Service somente.

    Parms.Parâmetros.adicionais.ParameterValue Cadeia de caracteres Opcional. Valor da chave associada.

    Valores válidos:

    • html: Cadeia de caracteres de texto HTML
    • Simples: Cadeia de caracteres de texto padrão

    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 texto traduzido para cada código de idioma.

    Padrão: Idioma preferencial do usuário.

    parms.translator Cadeia de caracteres Opcional. Serviço de tradução a ser usado para traduzir o texto (não diferencia maiúsculas de minúsculas).

    Valores válidos:

    • Google
    • Microsoft
    • IBM
    • <custom>
    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 Integre com um provedor de serviços de tradução .

    Serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

    Tabela 8. Retornos
    Tipo Descrição
    status Status da resposta à chamada do método.
    Valores possíveis:
    • Erro
    • Parcial
    • Êxito

    Tipo de dados: Cadeia de caracteres

    traduções Lista que descrevem 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 um erro.
    Valores válidos:
    • Verdadeiro: Erro encontrado.
    • Tradução de texto bem-sucedida.

    Tipo de dados: Booliano

    translations.detectedLanguage Descrição do idioma detectado.

    Tipo de dados: Objeto

    "detectedLanguage": {
      "code": "String",
      "name": "String"
    }
    translations.detectedLanguage.code Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    translations.detectedLanguage.name Código do idioma detectado.

    Tipo de dados: Cadeia de caracteres

    TextTransações Descrição do idioma usado para traduzir a cadeia de caracteres de texto.

    Tipo de dados: Matriz de objetos

    "textTranslation": {
      "targetLanguage": "String",
      "translatedText": "String"
    }
    TextTranslations.targetLanguage Código do idioma para o qual o texto de origem foi traduzido.

    Tipo de dados: Cadeia de caracteres

    TextTranslations.Texto traduzido 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 mensagens de erro que o método pode retornar e indicações sobre sua causa raiz.
    • O texto (campo "texto") 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): O. Tradução dinâmica A API 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 .
    • O tradutor padrão não está configurado para tradução. (40002): Nenhum serviço de tradução foi 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 Crie uma configuração de tradutor .
    • O tradutor (campo "tradutor") é inválido. (40003): O aprovado translatoro parâmetro não é uma cadeia de caracteres.
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • o tradutor do <translator> 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 Crie uma configuração de tradutor .
    • Parâmetros adicionais 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. targetLanguageso parâmetro foi 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 das entradas não é uma cadeia de caracteres
    • O idioma de origem (campo "sourceLanguage") é inválido. (40008): O. sourceLanguageO parâmetro é passado na chamada, mas o valor não é uma cadeia de caracteres.
    • O limite de tempo máximo foi excedido. (40009): A operação levou mais tempo do que o valor de tempo limite definido 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 do <translator> 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 Crie uma configuração de tradutor .
    • A versão da configuração do tradutor é inválida. Migrar 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 Migrar para a versão v3 de uma configuração de tradutor .
    • Ocorreu um erro desconhecido. (40051): Erro padrão gerado quando o erro não se enquadra em nenhuma outra categoria.
    • O texto (campo "texto") excedeu o tamanho máximo. (40052): O texto que foi passado para traduzir excede o tamanho máximo compatível com o serviço de tradução correspondente.
    • O idioma de origem é inválido. (40053): O aprovado sourceLanguageo parâmetro 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 targetLanguageso parâmetro não é compatível com o serviço de tradução correspondente.
    • A solicitação não está autorizada porque as credenciais estão ausentes ou 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 .
    • 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 nos idiomas de destino especificados.

    Este exemplo mostra o código em um client script de portal que traduz uma lista de cadeias de caracteres de texto para francês e italiano usando o serviço de tradução da Microsoft.

    dynamicTranslation.getTranslations(["Translate first text using portal from client", "Translate second text using portal from client"], {
      "targetLanguages": ["fr", "it"],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": "Microsoft"
     }).then(function(res){console.log(res);}, function(res){console.log(res);});

    Resposta:

    {
      "translations":[
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Tradurre il primo testo utilizzando il portale dal client"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le premier texte à l'aide du portail à partir du client"
            }
          ],
          "detectedLanguage": {"name":"en", "code":"en"}
        },
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il secondo testo utilizzando il portale dal client"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le deuxième texte à l'aide du portail à partir du client"
            }
          ],
          "detectedLanguage": {"name":"en", "code":"en"}
        }
      ],
      "translator":"Microsoft",
      "status":"Success"
    }

    Este exemplo mostra um client script de portal que retorna um status Parcial quando uma das duas cadeias de caracteres de texto passadas é inválida. Para usar este exemplo de código para um client script de plataforma, mude DynamicTranslation.getTranslations . DynamicTranslation.getTranslations .

    dynamicTranslation.getTranslations(["Translate first text using portal from client", ""], {
      "targetLanguages": ["fr", "it"],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": "Microsoft"
     }).then(function(res){console.log(res);}, function(res){console.log(res);});

    Resposta:

    {
      "translations":[
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Tradurre il primo testo utilizzando il portale dal client"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le premier texte à l'aide du portail à partir du client"
            }
          ],
          "detectedLanguage":{"name":"en", "code":"en"}
        },
        {
          "isError":true,
          "code":"40000",
          "message":"Text is missing or invalid"
        }
      ],
     "translator":"Microsoft",
     "status":"Partial"
    }

    Este exemplo mostra um client script de portal que gera um erro quando um serviço de tradução inválido é passado. Para usar este exemplo de código para um client script de plataforma, mude DynamicTranslation.getTranslations . DynamicTranslation.getTranslations .

    dynamicTranslation.getTranslations(["Translate first text using portal from client", "Translate second text using portal from client"], {
      "targetLanguages": ["fr", "it"],
      "additionalParameters": [{
        "parameterName": "texttype",
        "parameterValue": "plain"
      }],
      "translator": 123
     }).then(function(res){console.log(res);}, function(res){console.log(res);});

    Resposta:

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

    DynamicTranslation - isEnabled(tradutor de cadeia de caracteres)

    Determina se os vários métodos em DynamicTranslation As APIs estão habilitadas para um serviço de tradução.

    Se você passar 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.

    Ao chamar este método a partir de um client script do portal, use o nome da classe DynamicTranslation , como DynamicTranslation.isEnabled() . Ao chamá-lo de um client script da plataforma, use o nome da classe DynamicTranslation , como DynamicTranslation.isEnabled() .

    Tabela 9. Parâmetros
    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>
    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 Integre com um provedor de serviços de tradução .

    Serviço de tradução padrão.

    Tabela 10. Retornos
    Tipo Descrição
    Detecção de lote Sinalizador que indica se GetDetectedLanguages() o método está habilitado.
    Valores possíveis:
    • Falso: Desabilitado
    • Verdadeiro: Habilitado

    Tipo de dados: Booliano

    BatchTranslation Sinalizador que indica se GetTranslations() o método está habilitado.
    Valores possíveis:
    • Falso: Desabilitado
    • Verdadeiro: Habilitado

    Tipo de dados: Booliano

    detecção Sinalizador que indica se GetDetectedLanguage() o método está habilitado.
    Valores possíveis:
    • Falso: Desabilitado
    • Verdadeiro: Habilitado

    Tipo de dados: Booliano

    tradução Sinalizador que indica se GetTranslation() o método está habilitado.
    Valores possíveis:
    • Falso: Desabilitado
    • Verdadeiro: Habilitado

    Tipo de dados: Booliano

    Mensagens de erro A seguir estão mensagens de erro que a API pode retornar e indicações sobre sua causa raiz.
    • O tradutor (campo "tradutor") é inválido. (40003): O aprovado translatoro parâmetro não é uma cadeia de caracteres.

    Este exemplo mostra um client script que verifica se o DynamicTranslation Os métodos estão habilitados para o serviço de tradução da Microsoft. Para usar este exemplo de código para um client script de plataforma, mude DynamicTranslation.getTranslations . DynamicTranslation.getTranslations .

    DynamicTranslation.isEnabled('Microsoft').then(function(res){console.log(res);}, function(res){console.log(res);});

    Saída:

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

    Este exemplo mostra um client script que gera um erro quando um serviço de tradução inválido é passado. Para usar este exemplo de código para um client script de plataforma, mude DynamicTranslation.getTranslations . DynamicTranslation.getTranslations .

    DynamicTranslation.isEnabled(123).then(function(res){console.log(res);}, function(res){console.log(res);});

    Saída:

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