DynamicTranslation - Cliente

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 27 min. de leitura
  • A API DynamicTranslation 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 clientes baseados em angular Portal de serviços.

    Além disso, você pode usar essa 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 três provedores de serviços de tradução: Microsoft Azure Translator Service, IBM Watson Translator Service e Google Cloud Translator Service. Você também pode configurar outros serviços de tradução em sua instância e usar a API DynamicTranslation para traduzir seu texto.

    Para usar esta API, você deve ativar o plug-in Dynamic Translation. Para obter informações sobre este plug-in e informações adicionais sobre o Dynamic Translation, consulte Visão geral do Dynamic Translation. Além disso, para usar esta API em um widget Portal de serviços, 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 clientes Portal de serviços é DynamicTranslation, enquanto o nome da classe a ser usada em clientes padrão é DynamicTranslation.

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

    Detecta o idioma do texto passado.

    Se você passar em 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 aprovado, 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.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 - sem distinção entre maiúsculas e 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 Integrar com um provedor de serviços de tradução.

    Padrão: serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

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

    Tipo de dados: matriz

    "alternatives": [
      {
        "code": "String",
        "confidence": "String",
        "name": "String"
      }
    ]
    alternativas.código 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. Quanto 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

    detectadoIdioma Descrição do idioma detectado.

    Tipo de dados: objeto

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

    Tipo de dados: cadeia de caracteres

    detectouLanguage.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 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 "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 Dynamic Translation não está instalado. (40001): a API Dynamic Translation foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar esse plug-in, consulte Visão geral da tradução dinâmica.
    • O tradutor (campo "translator") é inválido. (40003): O passado no parâmetro 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 Criar uma configuração de tradutor.
    • <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 Criar 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 máximo de tempo 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 Criar uma configuração de tradutor.
    • <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 Criar 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 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.

    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 client script de widget Portal de serviços. Observe que o nome da classe é DynamicTranslation e 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 script do cliente de widget Portal de serviços 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 dos passados nas cadeias de caracteres de texto.

    Se você passar em 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 aprovado, o método também retornará o serviço de tradução padrão usado para detectar o idioma.

    Ao chamar este método de um client script do portal, use o nome de classe DynamicTranslation; como DynamicTranslation.getTranslations(). Ao chamá-lo de um client script de plataforma, use o nome de 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.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 - sem distinção entre maiúsculas e 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 Integrar com um provedor de serviços de tradução.

    Padrão: serviço de tradução configurado na tabela 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. Retorna
    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 uma correspondência.

    Tipo de dados: matriz

    "alternatives": [
      {
        "code": "String",
        "confidence": "String",
        "name": "String"
      }
    ]
    detecções.alternativas.código 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. Quanto 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

    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 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 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.
    • false: a detecção de idioma foi bem-sucedida.

    Tipo de dados: booliano

    status Status da resposta à chamada de 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 as mensagens de erro que o método pode retornar e as 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 Dynamic Translation não está instalado. (40001): a API Dynamic Translation foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar esse plug-in, consulte Visão geral da tradução dinâmica.
    • O tradutor (campo "translator") é inválido. (40003): O passado no parâmetro 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 Criar uma configuração de tradutor.
    • <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 Criar 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 máximo de tempo 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 Criar uma configuração de tradutor.
    • <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 Criar uma configuração de tradutor.
    • A versão da configuração do tradutor é inválida. Migre para o 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 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.

    Este exemplo mostra o código de um script do cliente do portal que detecta o inglês como o idioma das cadeias de caracteres passadas 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 de 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, altere DynamicTranslation.getDetectedLanguages para 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 script do cliente 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, altere DynamicTranslation.getDetectedLanguages para 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", "Object parms")

    Traduz o texto passado para um ou mais idiomas.

    O método usa serviços de tradução, como Microsoft Azure Translator Service, IBM Watson Translator Service e Google Cloud Translator Service, 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.additionalParameters 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

    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.

    parms.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>
    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 Integrar com um provedor de serviços de tradução.

    Padrão: serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

    Tabela 6. Retorna
    Tipo Descrição
    detectadoIdioma Descrição do idioma detectado.

    Tipo de dados: objeto

    "detectedLanguage": {
      "code": "String",
      "name": "String"
    }
    DetectouLanguage.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 Matriz de objetos que descreve as traduções do idioma.

    Tipo de dados: matriz

    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.traduzidoTexto 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 "texto") está ausente ou é inválido. (40000): o texto a ser traduzido está ausente ou não é uma cadeia de caracteres.
    • O plug-in Dynamic Translation não está instalado. (40001): a API Dynamic Translation foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar esse 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 é 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 Criar uma configuração de tradutor.
    • O tradutor (campo "translator") é inválido. (40003): O passado no parâmetro 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 Criar uma configuração de tradutor.
    • <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 Criar 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 parâmetro targetLanguages é aprovado 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 parâmetro sourceLanguage é aprovado na chamada, mas o valor não é uma cadeia de caracteres.
    • O limite máximo de tempo 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 Criar 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 passado no parâmetro 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 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.
    • 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.

    Este exemplo mostra a tradução de conteúdo de texto sem formatação do inglês (detectado) para o francês e o 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 o francês e o italiano usando o serviço de tradução da Microsoft em um client script de widget Portal de serviços. Observe que o nome da classe é DynamicTranslation e 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 script do cliente de widget Portal de serviços 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 em um ou mais idiomas.

    O método usa serviços de tradução, como Microsoft Azure Translator Service, IBM Watson Translator Service e Google Cloud Translator Service, 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 de um client script do portal, use o nome de classe DynamicTranslation; como DynamicTranslation.getTranslations(). Ao chamá-lo de um client script de plataforma, use o nome de classe DynamicTranslation; como DynamicTranslation.getTranslations().

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    textos Matriz Lista de cadeias de caracteres 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.additionalParameters 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

    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.

    parms.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>
    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 Integrar com um provedor de serviços de tradução.

    Padrão: serviço de tradução configurado na tabela Configuração do tradutor [sn_dt_translator_configuration].

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

    Tipo de dados: cadeia de caracteres

    traduções Matriz de objetos que descreve as traduções do idioma.

    Tipo de dados: matriz

    translations": [
      {
        "isError": Boolean;
        "detectedLanguage": {Object},
        "textTranslations": [Array]
      }
    ]
    Translations.isError Sinalizador que indica se a tradução do texto resultou em um erro.
    Valores válidos:
    • verdadeiro: erro encontrado.
    • falso: a tradução do texto foi bem-sucedida.

    Tipo de dados: booliano

    traduções.idiomadetectado Descrição do idioma detectado.

    Tipo de dados: objeto

    "detectedLanguage": {
      "code": "String",
      "name": "String"
    }
    traduções.detectadoIdioma.código 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

    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"
    }
    textTranslations.targetLanguage Código do idioma para o qual o texto de origem foi traduzido.

    Tipo de dados: cadeia de caracteres

    textTranslations.translatedText 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 "texto") está ausente ou é inválido. (40000): o texto a ser traduzido está ausente ou não é uma cadeia de caracteres.
    • O plug-in Dynamic Translation não está instalado. (40001): a API Dynamic Translation foi invocada sem ativar o plug-in com.glide.dynamic_translation. Para obter informações sobre como ativar esse 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 é 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 Criar uma configuração de tradutor.
    • O tradutor (campo "translator") é inválido. (40003): O passado no parâmetro 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 Criar uma configuração de tradutor.
    • <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 Criar 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 parâmetro targetLanguages é aprovado 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 parâmetro sourceLanguage é aprovado na chamada, mas o valor não é uma cadeia de caracteres.
    • O limite máximo de tempo 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 Criar uma configuração de tradutor.
    • A versão da configuração do tradutor é inválida. Migre para o 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 passado no parâmetro 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 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.
    • 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.

    Este exemplo mostra o código em um script do cliente do 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 script do cliente da plataforma, altere DynamicTranslation.getTranslations para 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 script do cliente 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 script do cliente da plataforma, altere DynamicTranslation.getTranslations para 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(cadeia de caracteres "tradutor")

    Determina se os vários métodos na API DynamicTranslation estão habilitados para um serviço de tradução.

    Se você passar em 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 de um client script do portal, use o nome de classe DynamicTranslation; como DynamicTranslation.isEnabled(). Ao chamá-lo de um client script de plataforma, use o nome de 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 - sem distinção entre maiúsculas e 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 Integrar com um provedor de serviços de tradução.

    Padrão: serviço de tradução padrão.

    Tabela 10. Retorna
    Tipo Descrição
    detecção em lote Sinalizador que indica se o método getDetectedLanguages() está habilitado.
    Valores possíveis:
    • verdadeiro: habilitado
    • falso: desabilitado

    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

    Tipo de dados: booliano

    detecção Sinalizador que indica se o método getDetectedLanguage() está habilitado.
    Valores possíveis:
    • verdadeiro: habilitado
    • falso: desabilitado

    Tipo de dados: booliano

    tradução Sinalizador que indica se o método getTranslation() está habilitado.
    Valores possíveis:
    • verdadeiro: habilitado
    • falso: desabilitado

    Tipo de dados: booliano

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

    Este exemplo mostra um client script que verifica se os métodos DynamicTranslation 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, altere DynamicTranslation.getTranslations para 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, altere DynamicTranslation.getTranslations para 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"}