dox42

O conector dox42 fornece uma conexão com a API REST dox42 muito extensa e permite que você gere automaticamente documentos em um fluxo com dados de todas as fontes, como D365, SharePoint ou outros.

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

dox42 fornece uma API REST poderosa e muito extensa. Usando dox42 você pode gerar automaticamente documentos com dados de todas as fontes, como D365, SharePoint, SAP ou outros. dox42 usa o Microsoft Entra ID para autenticação. Devolva o seu documento em qualquer formato, armazene-o no SharePoint, envie-o por e-mail, assine eletronicamente, anexe-o como uma nota a uma entidade, etc... Tudo isso é possível automaticamente com Dox42.

Pré-requisitos

Você precisará do seguinte para prosseguir:

• Um plano Microsoft Power Apps ou Power Automate
• Microsoft Entra ID
• Conhecimento HTTP
• uma licença dox42 (dox42 Online ou dox42 Server + dox42 Word/Excel/PowerPoint Add-ins)
• Aplicação dox42 Server Designer (Versão 1.0.1.4 ou posterior)
• SharePoint Online

Como obter credenciais

Registar uma aplicação Microsoft Entra ID para o seu conector premium

Primeiro, precisamos registrar dox42 como um aplicativo no Microsoft Entra ID. Isso permitirá que o conector se identifique com o ID do Microsoft Entra para que ele possa pedir permissões para acessar seus dados em nome do usuário final. Você pode ler mais sobre isso aqui

Este aplicativo Microsoft Entra ID deve ser registrado no Portal do Azure (https://portal.azure.com), seguindo as etapas descritas no capítulo 6 da documentação dox42 Microsoft Entra ID: https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf. Não se esqueça de adicionar o seguinte como URI de resposta da Web ao seu aplicativo: https://global.consent.azure-apim.net/redirect

Neste ponto, temos um aplicativo Microsoft Entra ID válido que pode ser usado para obter permissões de usuários finais e acessar a geração de documentos dox42. O próximo passo para nós é modificar o conector premium.

Gere Tokens de Acesso e ID externamente ou em seus fluxos

• Método 1

  • Usando o Postman ou qualquer outra ferramenta de teste de API, você pode gerar tokens de acesso e tokens de ID do Microsoft Entra
  • Você pode então colar essa chave de acesso no respetivo campo "Token de acesso ao portador" do conector dox42

• Método 2 (recomendado)

  • Em seus fluxos, use o conector premium HTTP para gerar tokens de acesso ou ID
  • Com "Compose" você pode salvar o token em uma variável que pode ser usada no campo dox42 Connector "Bearer Access Token"

• Para ambos os métodos, você pode consultar estes artigos:

  • https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
  • https://docs.microsoft.com/en-us/azure/databricks/dev-tools/api/latest/aad/app-aad-token

Recommendations

É altamente recomendável usar a funcionalidade "Secure Inputs/Output" em seus fluxos para que nenhuma informação confidencial seja visível como texto não criptografado. Além disso, o Azure Key Vault pode ser usado para armazenar segredos, senhas e assim por diante e se integra facilmente em seus fluxos.

Introdução ao conector

• Para chamar a geração de documentos dox42, insira uma cadeia de caracteres de consulta gerada no aplicativo dox42 Server Designer ao projetar seu Flow. Para obter mais informações, siga nossa documentação do conector personalizado dox42: https://www.dox42.com/Download/dox42_dox42Connector.pdf

• Um exemplo para essa cadeia de caracteres de consulta é:

  Operation=GenerateDocument&DocTemplate=c%3A%5Cdox42Server%5Ctemplates%5CHelloWorldTest%5CHelloWorld.docx&InputParam.name=World&ReturnAction.Format=txt&
  

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Ações

Chamada de Serviço dox42