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 |
| 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.
- Entre no portal do Azure como o usuário que será usado para se comunicar com a API do LCS.
- Em Serviços do Azure, selecione Registros de aplicativo.
- Na página Registros de aplicativo, selecione Novo registro.
- Na página Registrar um aplicativo , no campo Nome , insira um nome para o aplicativo.
- Em tipos de conta com suporte, selecione uma opção para especificar quais contas devem ter suporte.
- Selecione Registrar.
- Na página do novo registro de aplicativo, no painel de navegação esquerdo, em Gerenciar, selecione permissões de API.
- Na página de permissões de API , selecione Adicionar uma permissão.
- Nas APIs que minha organização usa a guia, localize e selecione a API de serviços do Dynamics Lifecycle .
- 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.
- Selecione o botão para conceder consentimento do administrador para as permissões. Quando você for solicitado a confirmar a ação, selecione Sim.
- No painel de navegação esquerdo, em Gerenciar, selecione Autenticação.
- Na página Autenticação , em Configurações avançadas, defina a opção Permitir fluxos de cliente público comoSim.
- No painel de navegação esquerdo, selecione Visão geral.
- A página de visão geral do registro do aplicativo mostra a ID do cliente.
- 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
- 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.
- 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.
- 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'.