dox42

Le connecteur dox42 fournit une connexion à l’API REST dox42 très étendue et vous permet de générer automatiquement des documents dans un flux avec des données provenant de toutes les sources, comme D365, SharePoint ou d’autres.

Ce connecteur est disponible dans les produits et régions suivants :

dox42 fournit une API REST puissante et très étendue. À l’aide de dox42, vous pouvez générer automatiquement des documents avec des données provenant de toutes les sources, comme D365, SharePoint, SAP ou d’autres. dox42 utilise l’ID Microsoft Entra pour l’authentification. Retournez votre document dans n’importe quel format, stockez-le sur SharePoint, envoyez-le par e-mail, signez-le électroniquement, joignez-le en tant que note à une entité, etc. tout cela est possible automatiquement avec dox42.

Prerequisites

Vous devez procéder comme suit :

• Un plan Microsoft Power Apps ou Power Automate
• Microsoft Entra ID (système d'identification de Microsoft)
• Connaissances HTTP
• une licence dox42 (dox42 Online ou dox42 Server + dox42 Word/Excel/PowerPoint Add-ins)
• application dox42 Server Designer (version 1.0.1.4 ou ultérieure)
• SharePoint en ligne

Comment obtenir des informations d’identification

Inscrire une application Microsoft Entra ID pour votre connecteur Premium

Nous devons d’abord inscrire dox42 en tant qu’application dans l’ID Microsoft Entra. Cela permet au connecteur de s’identifier à l’ID Microsoft Entra afin qu’il puisse demander des autorisations d’accès à vos données pour le compte de l’utilisateur final. Vous pouvez en savoir plus ici

Cette application Microsoft Entra ID doit être inscrite dans le portail Azure (https://portal.azure.com), en suivant les étapes décrites dans le chapitre 6 de la documentation d’ID De Microsoft Entra dox42 : https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf. N’oubliez pas d’ajouter les éléments suivants en tant qu’URI de réponse web à votre application : https://global.consent.azure-apim.net/redirect

À ce stade, nous disposons d’une application Microsoft Entra ID valide qui peut être utilisée pour obtenir des autorisations auprès des utilisateurs finaux et accéder à la génération de documents dox42. L’étape suivante consiste à modifier le connecteur Premium.

Générer des jetons d’accès et d’ID en externe ou dans vos flux

• Méthode 1

  • À l’aide de Postman ou d’un autre outil de test d’API, vous pouvez générer des jetons d’accès et des jetons d’ID Microsoft Entra
  • Vous pouvez ensuite coller cette clé d’accès dans le champ « Jeton d’accès du porteur » du connecteur dox42 respectif

• Méthode 2 (recommandée)

  • Dans vos flux, utilisez le connecteur HTTP Premium pour générer des jetons d’accès ou d’ID
  • Avec « Compose », vous pouvez ensuite enregistrer le jeton dans une variable qui peut être utilisée dans le champ « Jeton d’accès du porteur » du connecteur dox42.

• Pour les deux méthodes, vous pouvez consulter ces articles :

  • 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

Nous vous recommandons vivement d’utiliser la fonctionnalité « Entrées/sorties sécurisées » dans vos flux afin qu’aucune information sensible ne soit visible sous forme de texte clair. En outre, Azure Key Vault peut être utilisé pour stocker des secrets, des mots de passe, et ainsi de suite et s’intègre facilement dans vos flux.

Prise en main de votre connecteur

• Pour appeler la génération de document dox42, insérez une chaîne de requête générée dans l’application du Concepteur de serveur dox42 lors de la conception de votre flux. Pour plus d’informations, suivez notre documentation sur le connecteur personnalisé dox42 : https://www.dox42.com/Download/dox42_dox42Connector.pdf

• Par exemple, cette chaîne de requête est la suivante :

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

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limitations

Actions

appel de service dox42