Exercice : implémenter un déclencheur de webhook

  • 10 minutes

Dans cet exercice, vous allez ajouter un déclencheur de webhook au connecteur personnalisé pour une API Contoso Invoicing existante.

Important

Utilisez un environnement de test avec Microsoft Dataverse approvisionné. Si vous ne disposez pas d’un environnement de test, vous pouvez vous inscrire pour bénéficier de l’offre Communauté.

Remarque

Téléchargez le fichier suivant sur votre ordinateur local pour effectuer cet exercice Contoso Invoicing Triggers. Cliquez sur le bouton Télécharger au milieu de l’écran à droite.

Tâche 1 : Importer une solution avec le connecteur personnalisé

Dans cette tâche, vous allez importer une solution non gérée qui comporte un connecteur personnalisé prédéfini pour l’API Contoso Invoicing.

  1. Accédez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.

  2. Cliquez sur Solutions > Importer la solution.

  3. Cliquez sur Parcourir.

  4. Sélectionnez la solution ContosoInvoicingTriggers_1_0_0_0.zip, puis cliquez sur Ouvrir.

  5. Cliquez sur Suivant.

  6. Cliquez sur Importer, puis attendez la fin du processus d’importation. Une fois l’importation terminée, un message devrait vous indiquer que vous avez réussi.

  7. Cliquez sur Publier toutes les personnalisations et attendez la fin de la publication.

  8. Sélectionnez pour ouvrir la solution Contoso Invoicing triggers que vous avez importée.

    Vous devriez voir le composant connecteur personnalisé Contoso Invoicing triggers.

    Capture d’écran de la solution Contoso Invoicing triggers mise en évidence.

  9. Dans un nouvel onglet, accédez à Contoso Invoicing.

  10. Cliquez sur le lien Clé API.

    Capture d’écran du lien vers la clé API en surbrillance.

  11. Copiez la Clé API et enregistrez-la sur votre Bloc-notes. Elle vous servira à plusieurs reprises au cours de cet exercice.

  12. Retournez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.

  13. Cliquez sur Solutions, puis sélectionnez pour ouvrir la solution Contoso Invoicing triggers.

  14. Cliquez sur le connecteur personnalisé Contoso Invoicing triggers pour l’ouvrir.

  15. Cliquez sur Modifier.

    Capture d’écran avec une flèche pointant vers le bouton de modification du connecteur.

  16. Entrez contosoinvoicing.azurewebsites.net pour Hôte.

  17. Cliquez surMettre à jour le connecteur.

  18. Sélectionnez Tester > Nouvelle connexion.

    Capture d’écran avec une flèche pointant vers le bouton d’ajout d’une nouvelle connexion.

  19. Collez la Clé API et cliquez sur Créer une connexion.

    Capture d’écran du bouton Créer une connexion.

  20. Cliquez sur Actualiser. La connexion que vous avez créée doit être sélectionnée automatiquement.

  21. Faites défiler vers le bas jusqu’à la section Opérations, sélectionnez ListInvoices, puis cliquez sur Opération de test.

    Capture d’écran avec une flèche pointant vers le bouton Opération de test.

    Vous devriez voir une liste de factures dans la section Corps.

    Capture d’écran d’une liste de factures dans la section Corps.

  22. Ne quittez pas cette page.

Tâche 2 : Ajouter un déclencheur de webhook

Pour ajouter un déclencheur de webhook, procédez comme suit :

  1. Sélectionnez Définition.

    Capture d’écran de l’onglet Définition sélectionné.

  2. Faites défiler vers le bas jusqu’à la section Déclencheurs, puis cliquez sur + Nouveau déclencheur.

  3. Renseignez les valeurs suivantes :

    • Résumé : Lorsqu’une facture est créée

    • Description : Lorsqu’une facture est créée

    • ID d’opération : InvoiceCreated

    • Type de déclencheur : Webhook

    Capture d’écran des nouvelles valeurs du déclencheur pour Résumé, Description, ID d’opération et Type de déclencheur.

  4. Accédez à la section Demande et cliquez sur + Importer à partir de l’exemple.

    Capture d’écran avec une flèche pointant vers le bouton Importer à partir de l’exemple.

  5. Renseignez les valeurs suivantes, puis cliquez sur Importer. Avec d’autres API, vous obtiendriez l’exemple à partir de la documentation de l’API.

    • Verbe : POST

    • URL - https://contosoinvoicing.azurewebsites.net/NewInvoiceNotification/

      Remarque

      Intégrez la barre oblique de fin à l’URL.

    • Corps

       {
 "targetUrl":"https://webhook.site"
 }

    Capture d’écran des propriétés de l’exemple de demande.

  6. Faites défiler jusqu’à Configuration du déclencheur, puis sélectionnez targetUrl pour Paramètre d’URL de rappel. Cette sélection permet à targetUrl d’être renseigné lors de l’exécution par le connecteur personnalisé.

    Capture d’écran de la fenêtre de confirmation du déclencheur.

  7. Faites défiler jusqu’à la section Demande, sélectionnez Corps, puis cliquez sur Modifier.

    Capture d’écran avec une flèche pointant vers le bouton de modification du corps.

  8. Sélectionnez targetUrl, puis cliquez sur Modifier.

    Capture d’écran avec une flèche pointant vers le bouton de modification de l’URL cible.

  9. Sélectionnez Oui pour Obligatoire et sélectionnez interne pour Visibilité.

    Capture d’écran des champs des propriétés de l’URL cible.

  10. Cliquez sur le bouton Précédent.

    Capture d’écran avec une flèche pointant vers le bouton Précédent.

  11. Cliquez de nouveau sur le bouton Précédent.

  12. Faites défiler vers le bas jusqu’à la section Réponse du webhook, entrez Facture pour Description, puis cliquez sur + Importer à partir de l’exemple. La réponse du webhook définit ce qui sera envoyé à votre flux lorsque l’événement de déclenchement se produira.

    Capture d’écran avec une flèche pointant vers le bouton Importer à partir de l’exemple.

  13. Collez l’exemple JSON suivant dans la section Corps, puis cliquez sur Importer.

     {
 "invoiceId": "1933",
 "date": "2021-01-26T04:02:52.1490835+00:00",
 "amount": 5000,
 "accountId": "1001",
 "accountName": "Wing Tips",
 "status": "Invoiced",
 "typeId": 1,
 "purchaseOrderId": "3002",
 "tags": "New Account;Special Pricing"
 }

    Capture d’écran des détails des propriétés d’importation de la réponse.

  14. Cliquez sur Mettre à jour le connecteur.

    Remarque

    Si vous recevez un message d’erreur indiquant que « tous les chemins d’accès doivent commencer par ’/’ », ouvrez Swagger, recherchez la ligne contenant ’’:{}, puis supprimez-la.

  15. Cliquez sur Fermer.

Tâche 3 : Tester le déclencheur

  1. Accédez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.

  2. Cliquez sur Solutions, puis ouvrez la solution Contoso Invoicing triggers.

  3. Cliquez sur + Nouveau, puis sélectionnez Automatisation > Flux de cloud > Instantané.

  4. Saisissez Créer une facture pour le nom, sélectionnez Déclencher manuellement un flux sous Déclencheurs, puis cliquez sur Créer.

    Capture d’écran avec une flèche pointant vers le déclencheur Déclencher manuellement un flux.

  5. Développez le déclencheur, puis cliquez sur + Ajouter une entrée.

  6. Sélectionnez Nombre pour le type d’entrée.

    Capture d’écran avec une flèche pointant vers le type d’entrée Nombre.

  7. Entrez Montant pour le nom de l’entrée, puis cliquez sur + Nouvelle étape.

    Capture d’écran avec une flèche pointant vers le bouton d’ajout d’un nouveau flux.

  8. Cliquez sur l’onglet Personnalisé, puis sélectionnez le connecteur personnalisé Contoso Invoicing.

    Capture d’écran avec une flèche pointant vers le connecteur personnalisé.

  9. Cliquez sur l’action Ajouter une facture.

  10. Entrez Connexion Contoso dans le champ Nom de connexion, collez la Clé API que vous avez copiée à la Tâche 1 : Importer une solution avec le connecteur personnalisé, puis cliquez sur Créer. Vous devez utiliser la même clé API dans les deux flux, sinon le flux de votre déclencheur ne s’exécutera pas.

    Capture d’écran du bouton de création d’une connexion.

  11. Sélectionnez le champ montant, puis sélectionnez Montant dans le volet Contenu dynamique.

    Capture d’écran de la sortie du champ montant à partir de l’étape précédente.

  12. Cliquez sur Enregistrer.

  13. Cliquez sur le bouton <- Précédent.

  14. Vérifiez que vous vous trouvez toujours dans la solution Contoso Invoicing - Triggers.

  15. Cliquez sur + Nouveau, puis sélectionnez Automatisation > Flux de cloud > Automatisé.

  16. Saisissez Notification de facture pour le Nom du flux, puis cliquez sur Ignorer.

  17. Cliquez sur l’onglet Personnalisé, puis sélectionnez le connecteur personnalisé Contoso Invoicing.

    Capture d’écran avec une flèche pointant vers le déclencheur du connecteur personnalisé.

  18. Sélectionnez le déclencheur Lorsqu’une facture est créée.

  19. Cliquez sur + Nouvelle étape.

  20. Recherchez composer, puis sélectionnez l’action Composer.

  21. Cliquez sur le champ Entrées, puis sélectionnez corps dans le volet Contenu dynamique.

    Capture d’écran du champ Entrées et du corps dans le volet Contenu dynamique.

  22. Cliquez sur Enregistrer.

  23. Cliquez sur Tester.

  24. Sélectionnez Manuellement > Tester. Le flux commence, puis attendez les notifications.

  25. Ouvrez une nouvelle fenêtre de navigateur, puis accédez à https://make.powerapps.com/.

  26. Vérifiez que vous avez sélectionné l’environnement adéquat.

  27. Cliquez sur Solutions, puis ouvrez la solution Contoso Invoicing - Triggers.

  28. Ouvrez le flux de cloud Créer une facture.

  29. Cliquez sur Modifier.

  30. Cliquez sur Tester.

  31. Sélectionnez Manuellement > Tester.

  32. Cliquez sur Continuer.

  33. Saisissez 5500 pour Montant, puis cliquez sur Exécuter le flux.

  34. Cliquez sur Terminé.

  35. Basculez vers le flux Notification de facture. Le flux devrait s’exécuter avec succès.

  36. Cliquez sur l’action Composer pour la développer.

    Capture d’écran avec une flèche pointant vers l’action Composer.

    Les sections Entrées et Sorties doivent indiquer le montant que vous avez fourni dans le flux Créer une facture.

    Capture d’écran des sections Entrées et Sorties de l’action Composer.