Compartilhar via


Serviço de Tradução Dinâmica (versão prévia)

Operações de conversão, alinhamento e regeneração alimentadas pelo Dynamics Translation Service.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Serviço de Tradução Dinâmica
URL https://lcs.dynamics.com
Email dtssup@microsoft.com
Metadados do conector
Publicador Microsoft Corporation
Site https://lcs.dynamics.com/
Política de privacidade https://privacy.microsoft.com/privacystatement
Categorias Conteúdo e arquivos

O conector do Serviço de Tradução do Dynamics 365 integra-se ao Power Platform, permitindo que os usuários acessem o DTS diretamente de um fluxo ou aplicativo. Esse conector chama a API DTS em nome de seu usuário, salvando-os de uma viagem para o site. Esse conector permite traduzir arquivos de interface do usuário (interface do usuário), regenerar solicitações de tradução e criar arquivos TM (memória de tradução). Aproveitando essas funcionalidades, você poderá automatizar seu fluxo de trabalho de tradução.

Pré-requisitos

Você precisará do seguinte para continuar:

  • Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado.
  • Uma conta com acesso ao Dynamics Lifecycle Services.

Como obter credenciais

Esse conector usa o OAuth por meio de um aplicativo de ID do Microsoft Entra para autenticação. Como o DTS reside no LCS, você precisa de permissões de API LCS em seu aplicativo. O procedimento a seguir orienta você pelo processo de registro do aplicativo para um aplicativo de ID do Microsoft Entra para uso com esse conector.

  1. Entre no portal do Azure como o usuário que será usado para se comunicar com a API do LCS.
  2. Em Serviços do Azure, selecione Registros de aplicativo.
  3. Na página Registros de aplicativo, selecione Novo registro.
  4. Na página Registrar um aplicativo , no campo Nome , insira um nome para o aplicativo.
  5. Em tipos de conta com suporte, selecione uma opção para especificar quais contas devem ter suporte.
  6. Selecione Registrar.
  7. Na página do novo registro de aplicativo, no painel de navegação esquerdo, em Gerenciar, selecione permissões de API.
  8. Na página de permissões de API , selecione Adicionar uma permissão.
  9. Nas APIs que minha organização usa a guia, localize e selecione a API de serviços do Dynamics Lifecycle .
  10. Marque a caixa de seleção para a permissão de API que tem o escopo user_impersonation e, em seguida, selecione Adicionar permissões.
  11. Selecione o botão para conceder consentimento do administrador para as permissões. Quando você for solicitado a confirmar a ação, selecione Sim.
  12. No painel de navegação esquerdo, em Gerenciar, selecione Autenticação.
  13. Na página Autenticação , em Configurações avançadas, defina a opção Permitir fluxos de cliente público comoSim.
  14. No painel de navegação esquerdo, selecione Visão geral.
  15. A página de visão geral do registro do aplicativo mostra a ID do cliente.
  16. No painel de navegação esquerdo, selecione Certificados > segredos. A partir daqui, você pode gerar o segredo do cliente necessário para configurar a conexão.

Introdução ao conector

  1. Armazene seus ativos DTS em algum lugar do qual eles possam ser acessados do conector. Por exemplo, você pode carregá-los no OneDrive e usar o conector do OneDrive para recuperar seus arquivos.
  2. Dependendo do seu cenário, você desejará começar com as ações Traduzir, Alinhar ou Regenerar. De qualquer forma, você precisará fornecer um arquivo zip com os arquivos de memória de tradução ou de recurso. Ao traduzir ou regenerar, você pode usar as operações Baixar Resultado da Tradução ou Baixar Resultado de Alinhamento para recuperar os resultados.
  3. A entrada para Tradução, Alinhamento e Regeneração é a mesma da interface do usuário da Web. A entrada para todas as outras operações será a saída dessas operações.

Problemas e limitações conhecidos

  • Há suporte apenas para solicitações de interface do usuário.
  • A operação Alinhar retorna uma URL para o arquivo de alinhamento, mas a operação de alinhamento de download usa o nome do arquivo como entrada. Você precisará manipular a URL para extrair o nome do arquivo antes de usar a operação Alinhar.

Erros e soluções comuns

  • Uma solicitação com o código de status 200 nem sempre indica êxito. Verifique o corpo da resposta em caso de resultados inesperados
    {
    "status": "InvalidSourceLanguage",
    "message": "The source language either does not match the product, or does not exist."
    }
    

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Align

Use a ferramenta Alinhar para criar um arquivo de memória de tradução de arquivos nativos traduzidos anteriormente.

Baixar resultado da tradução

Baixe a saída de uma solicitação de tradução.

Obter

Sondar o status de uma solicitação de tradução.

Regenerar

Regenerar uma tradução usando memórias de tradução atualizadas.

Resultado do alinhamento de download

Baixe o resultado do alinhamento.

Translate

Envie uma nova solicitação de tradução.

Align

Use a ferramenta Alinhar para criar um arquivo de memória de tradução de arquivos nativos traduzidos anteriormente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Produto
productType True string

Selecione o tipo de produto.

Versão do produto
productVersion True string

Selecione a versão do produto.

Idioma de origem
sourceLanguage True string

Idioma de origem da tradução.

Idioma de destino
targetLanguage True string

Idioma de destino de tradução.

Arquivo de origem
sourceFile True binary

Arquivo de recurso nativo.

Arquivo de destino
targetFile True binary

Arquivo de destino nativo.

Retornos

Nome Caminho Tipo Description
status
status string

Cadeia de caracteres que descreve o status da solicitação.

mensagem
message string

Cadeia de caracteres que descreve o status da solicitação.

Taxa de Alinhamento
alignmentRate float

Porcentagem de unidades de conversão de origem e de destino correspondentes.

URL de Arquivo Alinhado
alignedFile string

URL para recuperar a saída de alinhamento.

Baixar resultado da tradução

Baixe a saída de uma solicitação de tradução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Download
downloadType True string

O tipo de download.

ID de tradução
translationId True integer

A ID da tradução. Obtenha esse valor da saída da operação de tradução.

Retornos

Conteúdo de arquivo binário da saída de tradução.

Conteúdo do arquivo
binary

Obter

Sondar o status de uma solicitação de tradução.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de tradução
translationId True integer

ID da tradução que você está sondando.

Retornos

Nome Caminho Tipo Description
status
status string

Cadeia de caracteres que descreve o status da solicitação.

mensagem
message string

Cadeia de caracteres elaborando o status.

parentTranslationID
parentTranslationID integer

O projeto ao qual esta solicitação de tradução pertence.

requestName
requestName string

O nome da solicitação de tradução.

tipoDeProduto
productType integer

O produto para o qual os arquivos foram traduzidos.

productVersion
productVersion integer

A versão do produto para o qual os arquivos foram traduzidos.

translationType
translationType string

O tipo de tradução: documentação ou interface do usuário.

sourceLanguage
sourceLanguage string

Os arquivos de idioma foram traduzidos.

targetLanguage
targetLanguage string

Os arquivos de idioma foram traduzidos.

Regenerar

Regenerar uma tradução usando memórias de tradução atualizadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de tradução
translationId True integer

ID da tradução que você está regenerando.

Regenerar arquivo
regenerateFile True binary

Arquivo ZIP com arquivos de memória de tradução revisados.

Retornos

Nome Caminho Tipo Description
status
status string

Cadeia de caracteres que descreve o status da solicitação.

mensagem
message string

Cadeia de caracteres elaborando o status.

Resultado do alinhamento de download

Baixe o resultado do alinhamento.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do arquivo
filename True string

Nome de arquivo retornado na saída de alinhamento.

Retornos

Conteúdo do arquivo binário da saída de alinhamento.

Saída do arquivo
binary

Translate

Envie uma nova solicitação de tradução.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Produto
productType True string

Selecione o tipo de produto.

Versão do produto
productVersion True string

Selecione a versão do produto.

Idioma de origem
sourceLanguage True string

Idioma do qual traduzir.

Idioma de destino
targetLanguage True string

Idioma no qual traduzir.

Nome da solicitação
requestName True string

Nome da solicitação de tradução.

Tipo de tradução
translationType True string

O tipo de tradução. Atualmente, há suporte apenas para traduções de interface do usuário.

Arquivos de origem
sourceFile True binary

Arquivo zip que contém arquivos a serem convertidos.

Modelo de MT personalizado
trainMTWithTM boolean

Crie um sistema MT personalizado com base em arquivos de memória de tradução carregados.

Arquivos de memória de tradução
tmFile binary

Arquivo zip que contém arquivos de memória de tradução.

Retornos

Nome Caminho Tipo Description
status
status string

Cadeia de caracteres que descreve o status da solicitação.

mensagem
message string

Cadeia de caracteres elaborando o status.

translationId
translationId integer

A ID da solicitação de tradução, as operações de recuperação e download usadas.

Definições

binário

Esse é o tipo de dados básico 'binary'.