Integração com um provedor de serviço de tradução

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Integre com qualquer provedor de serviço de tradução de sua escolha para traduzir o texto gerado dinamicamente.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Crie subfluxos para detectar o idioma do texto de entrada e traduza o texto de entrada usando Integration Hub subfluxos, ações e conexões e credenciais.
      Para mais informações, consulte Flow Designer.
      1. Certifique-se de que o mapeamento de mensagens de erro seja feito para mapear códigos de erro do provedor de serviços de tradução para os códigos de erro e mensagens de erro padronizadas compatíveis com ServiceNow.
        Tabela 1. Códigos de erro padrão e mensagem
        Código de erro Mensagem de erro
        40050 Código de erro para preencher mensagens de erro do provedor de serviço do tradutor em vez de mensagens de erro padronizadas.
        40051 Ocorreu um erro desconhecido.
        40052 O texto (campo "text") excedeu o tamanho máximo.
        40053 O idioma de origem é inválido.
        40054 O idioma de destino é inválido.
        40055 A solicitação não foi autorizada porque as credenciais estão ausentes ou são inválidas.
        40056 O texto não pode ser traduzido para os idiomas de destino.
      2. Certifique-se de que as entradas e os campos de saída estejam no seguinte formato para subfluxos.
        Nota:
        Ao criar subfluxos, você pode consultar os subfluxos que estão disponíveis por padrão, se necessário. Por exemplo, Detectar idioma [detect_language_v3] e Traduzir texto para vários idiomas [translate_text_to_multiple_languages_v3].
        Tabela 2. Detectar subfluxo
        Nome do campo Descrição Tipo
        Entradas
        textos Textos de entrada cujo idioma deve ser detectado.

        Na versão Xanadu, a versão v3 oferece suporte à detecção em massa - detecção de vários textos de entrada em uma única cadeia de caracteres.

        		 Array.String
        Saídas
        detecções Informações sobre o código e a confiança dos idiomas detectados pelo tradutor e suas respectivas alternativas, códigos de erro e mensagens de erro.
        • Código: código do idioma detectado conforme especificado pelo provedor de serviços de tradução.
        • Confiança: valor que indica a confiança no resultado. O valor está entre zero e um. Um valor baixo indica uma confiança baixa.
        Por exemplo, texto em francês com confiança de 0,93 
        { 'code' : 'fr',  'confidence' : '0.93'  }

        Para obter mais informações, consulte a seção getDetectedLanguages de DynamicTranslation - Scoped.

        		 Matriz.Objeto. Cada elemento do objeto é um valor de cadeia de caracteres.
        status Status da solicitação. Escolha
        Tabela 3. Traduzir subfluxo
        Nome do campo Descrição Tipo
        Entradas
        textos Textos a serem traduzidos.

        Na versão Xanadu, a versão v3 oferece suporte à tradução em massa- tradução de vários textos de entrada em uma única cadeia de caracteres.

        		 Array.String
        idiomas_destino Matriz de códigos de idioma para os quais o texto precisa ser traduzido.
        Por exemplo, 
        ['fr','it']
        		 Cadeia de caracteres da matriz. Cada elemento da matriz é um valor de cadeia de caracteres.
        source_language Código do idioma do texto de origem.
        Por exemplo, 
        en
        		 Cadeia de caracteres
        additional_parameters Matriz de parâmetros adicionais.
        Por exemplo, 
        [{'parameter_name': 'textType', 'parameter_value': 'html'}]
        		 Matriz.Objeto. Cada elemento da matriz é um objeto com valores de cadeia de caracteres.
        Saídas
        traduções Textos traduzidos nos idiomas de destino especificados. Cada elemento da matriz é um objeto que contém o idioma de destino e o texto traduzido.
        Por exemplo, 
        [ 
{'target_language':'fr', 'translated_text':'Bonjour'}, 
{'target_language':'it', 'translated_text':'ciao'} 
]

        Para obter mais informações, consulte a seção getTranslations de DynamicTranslation - Scoped.

        		 Matriz.Objeto. Cada elemento da matriz é um objeto com valores de cadeia de caracteres.
        status Status da solicitação. Escolha
        Nota:
        Certifique-se de que o campo Executar como esteja definido como Usuário que inicia a sessão nas propriedades de fluxo.
    2. Crie uma configuração de tradutor e ative-a.
      Para obter mais informações, consulte Criar uma configuração de tradutor.