Tradução dinâmica - Cliente

Versão de lançamento: Xanadu

Atualizado 1 de ago. de 2024

27 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. Esta API está disponível para clientes padrão e clientes baseados em Angular Portal de serviços.

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.

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. 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 client script 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ê 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.

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" }`
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> 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. 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 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 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): 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. 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. <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. 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. <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. 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 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 script de cliente 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 de 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 das cadeias de caracteres de texto passadas.

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" }`
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> 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. 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 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. 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 "text") 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): 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. 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. <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. 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. <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. 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. 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 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 client script 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 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, 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 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, 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(String textToTranslate, parâmetros do objeto)

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.

Tabela 5. Parâmetros
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	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.
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> 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. 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" }`
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. 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. 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. <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. 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 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. 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. 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 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 script de cliente 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 de 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 para um ou mais idiomas.

Tabela 7. Parâmetros
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 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> 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. 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 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. 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. 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. 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. <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. 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 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. 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. 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. 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 client script 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 do 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, 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 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, 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 (tradutor de cadeia de caracteres)

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.

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 - 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 Integração com um provedor de serviço 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 indicações sobre a causa raiz. O tradutor (campo "tradutor") é inválido. (40003): o parâmetro passado 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"}