Exercice : implémenter un déclencheur de webhook
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.
Accédez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.
Cliquez sur Solutions > Importer la solution.
Cliquez sur Parcourir.
Sélectionnez la solution ContosoInvoicingTriggers_1_0_0_0.zip, puis cliquez sur Ouvrir.
Cliquez sur Suivant.
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.
Cliquez sur Publier toutes les personnalisations et attendez la fin de la publication.
Sélectionnez pour ouvrir la solution Contoso Invoicing triggers que vous avez importée.
Vous devriez voir le composant connecteur personnalisé Contoso Invoicing triggers.
Dans un nouvel onglet, accédez à Contoso Invoicing.
Cliquez sur le lien Clé API.
Copiez la Clé API et enregistrez-la sur votre Bloc-notes. Elle vous servira à plusieurs reprises au cours de cet exercice.
Retournez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.
Cliquez sur Solutions, puis sélectionnez pour ouvrir la solution Contoso Invoicing triggers.
Cliquez sur le connecteur personnalisé Contoso Invoicing triggers pour l’ouvrir.
Cliquez sur Modifier.
Entrez
contosoinvoicing.azurewebsites.net
pour Hôte.Cliquez surMettre à jour le connecteur.
Sélectionnez Tester > Nouvelle connexion.
Collez la Clé API et cliquez sur Créer une connexion.
Cliquez sur Actualiser. La connexion que vous avez créée doit être sélectionnée automatiquement.
Faites défiler vers le bas jusqu’à la section Opérations, sélectionnez ListInvoices, puis cliquez sur Opération de test.
Vous devriez voir une liste de factures dans la section Corps.
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 :
Sélectionnez Définition.
Faites défiler vers le bas jusqu’à la section Déclencheurs, puis cliquez sur + Nouveau déclencheur.
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
Accédez à la section Demande et cliquez sur + Importer à partir de l’exemple.
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" }
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é.
Faites défiler jusqu’à la section Demande, sélectionnez Corps, puis cliquez sur Modifier.
Sélectionnez targetUrl, puis cliquez sur Modifier.
Sélectionnez Oui pour Obligatoire et sélectionnez interne pour Visibilité.
Cliquez sur le bouton Précédent.
Cliquez de nouveau sur le bouton Précédent.
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.
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" }
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.
Cliquez sur Fermer.
Tâche 3 : Tester le déclencheur
Accédez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.
Cliquez sur Solutions, puis ouvrez la solution Contoso Invoicing triggers.
Cliquez sur + Nouveau, puis sélectionnez Automatisation > Flux de cloud > Instantané.
Saisissez Créer une facture pour le nom, sélectionnez Déclencher manuellement un flux sous Déclencheurs, puis cliquez sur Créer.
Développez le déclencheur, puis cliquez sur + Ajouter une entrée.
Sélectionnez Nombre pour le type d’entrée.
Entrez Montant pour le nom de l’entrée, puis cliquez sur + Nouvelle étape.
Cliquez sur l’onglet Personnalisé, puis sélectionnez le connecteur personnalisé Contoso Invoicing.
Cliquez sur l’action Ajouter une facture.
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.
Sélectionnez le champ montant, puis sélectionnez Montant dans le volet Contenu dynamique.
Cliquez sur Enregistrer.
Cliquez sur le bouton <- Précédent.
Vérifiez que vous vous trouvez toujours dans la solution Contoso Invoicing - Triggers.
Cliquez sur + Nouveau, puis sélectionnez Automatisation > Flux de cloud > Automatisé.
Saisissez Notification de facture pour le Nom du flux, puis cliquez sur Ignorer.
Cliquez sur l’onglet Personnalisé, puis sélectionnez le connecteur personnalisé Contoso Invoicing.
Sélectionnez le déclencheur Lorsqu’une facture est créée.
Cliquez sur + Nouvelle étape.
Recherchez composer, puis sélectionnez l’action Composer.
Cliquez sur le champ Entrées, puis sélectionnez corps dans le volet Contenu dynamique.
Cliquez sur Enregistrer.
Cliquez sur Tester.
Sélectionnez Manuellement > Tester. Le flux commence, puis attendez les notifications.
Ouvrez une nouvelle fenêtre de navigateur, puis accédez à https://make.powerapps.com/.
Vérifiez que vous avez sélectionné l’environnement adéquat.
Cliquez sur Solutions, puis ouvrez la solution Contoso Invoicing - Triggers.
Ouvrez le flux de cloud Créer une facture.
Cliquez sur Modifier.
Cliquez sur Tester.
Sélectionnez Manuellement > Tester.
Cliquez sur Continuer.
Saisissez 5500 pour Montant, puis cliquez sur Exécuter le flux.
Cliquez sur Terminé.
Basculez vers le flux Notification de facture. Le flux devrait s’exécuter avec succès.
Cliquez sur l’action Composer pour la développer.
Les sections Entrées et Sorties doivent indiquer le montant que vous avez fourni dans le flux Créer une facture.