dox42

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

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

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

Pré-requisitos

Você precisará do seguinte para continuar:

• Um plano do Microsoft Power Apps ou do Power Automate
• Microsoft Entra ID
• Conhecimento de HTTP
• uma licença dox42 (dox42 Online ou dox42 Server + dox42 Word/Excel/Suplementos do PowerPoint)
• aplicativo dox42 Server Designer (versão 1.0.1.4 ou posterior)
• SharePoint online

Como obter credenciais

Registrar um aplicativo de ID do Microsoft Entra para seu conector premium

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

Este aplicativo da ID do Microsoft Entra deve ser registrado no Portal do Azure (https://portal.azure.com), seguindo as etapas descritas no capítulo 6 da Documentação da ID do Microsoft Entra dox42: 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 válido da ID do Microsoft Entra que pode ser usado para obter permissões de usuários finais e acessar a geração de documentos dox42. A próxima etapa para nós é modificar o conector Premium.

Gerar 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 ID
  • Em seguida, você pode colar a chave de acesso no respectivo campo "Token de Acesso do Portador" do Conector do dox42

• Método 2 (recomendado)

  • Em seus fluxos, use o conector HTTP Premium para gerar tokens de acesso ou ID
  • Com "Redigir", você pode salvar o token em uma variável que pode ser usada no campo "Token de Acesso do Portador" do conector do dox42

• 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 "Entradas Seguras/Saída" em seus fluxos para que nenhuma informação confidencial fique visível como texto claro. Além disso, o Azure Key Vault pode ser usado para armazenar segredos, senhas e assim por diante e integra-se 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 do 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&
  

Criando uma conexão

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

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

Ações

Chamada de serviço dox42