Exercice : implémenter un déclencheur d’interrogation

  • 10 minutes

Dans cet exercice, vous allez ajouter un déclencheur d’interrogation 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é.

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

Remarque

Vous pouvez continuer à utiliser le connecteur que vous avez créé et modifié dans Unité 4 : Implémenter un déclencheur de webhook. Si vous avez terminé cet exercice, vous pouvez passer à la Tâche 2.

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.

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.

  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. Ouvrez la solution Contoso Invoicing triggers que vous avez importée.

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

    Capture d’écran du composant Contoso Invoicing triggers mis en évidence.

  9. 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, puis collez-la sur un bloc-notes pour une utilisation future.

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

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

  14. Ouvrez le connecteur personnalisé Contoso Invoicing triggers.

  15. Cliquez sur Modifier.

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

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

  17. Cliquez sur Mettre à jour le connecteur.

  18. Cliquez sur Tester > + Nouveau connecteur.

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

  19. Collez la Clé API, puis 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 ListInvoice, 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 d’interrogation

Si vous avez sauté la tâche précédente, accédez à votre connecteur personnalisé Contoso Invoicing triggers et cliquez sur Modifier.

  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 (Interrogation)

    • Description : Lorsqu’une facture est créée (Interrogation)

    • ID d’opération : InvoiceCreatedPoll

    • Type de déclencheur : Interrogation

    Capture d’écran des propriétés du déclencheur de connecteur.

  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. Saisissez les valeurs suivantes, puis cliquez sur Importer :

    • Verbe : GET

    • URL : https://contosoinvoicing.azurewebsites.net/ListInvoices?fromDate=

  6. Cliquez sur le bouton (Chevron) des points de suspension en regard de fromDate, puis sélectionnez Modifier.

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

  7. Sélectionnez interne pour l’option Visibilité, puis cliquez sur le bouton Précédent.

    Capture d’écran de l’option de visibilité des paramètres définie sur interne.

  8. Faites défiler vers le bas jusqu’à la section Réponse et sélectionnez + Ajouter une réponse par défaut.

  9. Collez le code JSON suivant dans le champ Corps, puis cliquez sur Importer.

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

    Capture d’écran de l’importation de la réponse par défaut.

  10. Accédez à la section Configuration du déclencheur et indiquez les valeurs suivantes :

    • Sélectionner le paramètre de requête pour surveiller le changement d’état : fromDate

    • Spécifiez la valeur à transmettre au paramètre de requête sélectionné. Vous pouvez choisir des expressions : - @{triggerBody().invoices[0].createDate}

    • Sélectionner la collection qui contient les données du déclencheur - @triggerBody().invoices

    Capture d’écran de la section Configuration du déclencheur avec des valeurs.

  11. Cliquez sur le bouton Mettre à jour le connecteur situé en haut de l’écran, puis attendez que le connecteur soit mis à jour.

Tâche 3 : Tester le déclencheur

Si vous avez déjà terminé Unité 4 : Implémenter un déclencheur de webhook et avez créé le flux de cloud Créer une facture, passez à l’étape 14.

  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 > Flux de cloud.

  4. Entrez Créer une facture pour le nom, puis sélectionnez Déclencher manuellement un flux pour le déclencheur.

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

  5. 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, puis cliquez sur Créer.

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

  11. Cliquez sur 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. Gardez cet onglet ou cette fenêtre de navigateur ouvert(e).

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

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

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

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

  18. Saisissez Interrogation de notification de facture pour le nom, puis cliquez sur Ignorer.

  19. 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é.

  20. Sélectionnez le déclencheur Lorsqu’une facture est créée (Interrogation).

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

  21. Cliquez sur le bouton Menu... du déclencheur, puis assurez-vous que l’option Références de connexion est sélectionnée.

    Capture d’écran de la section Références de connexion.

  22. Cliquez sur + Nouvelle étape.

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

  24. 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.

  25. Cliquez sur Enregistrer, puis attendez que le flux soit enregistré.

  26. Cliquez sur Tester.

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

  28. Basculez vers l’onglet ou la fenêtre de navigateur du flux Créer une facture.

  29. Cliquez sur Tester.

  30. Sélectionnez Manuellement > Tester.

  31. Saisissez 6500 pour Montant, puis cliquez sur Exécuter le flux.

  32. Cliquez sur Terminé.

  33. Le flux devrait s’exécuter avec succès. Cliquez sur Modifier.

    Capture d’écran du flux réussi avec l’icône de modification.

  34. Recliquez sur Tester.

  35. Sélectionnez Manuellement > Tester.

  36. Saisissez 8800 pour Montant, puis cliquez sur Exécuter le flux.

  37. Cliquez sur Terminé. Le flux devrait à nouveau s’exécuter avec succès.

  38. Basculez vers le flux Interrogation de notification de facture. Ce flux devrait s’exécuter avec succès.

    Remarque

    À la différence d’un déclencheur de webhook, cela peut prendre environ une minute pour savoir si le flux s’est exécuté avec succès ou non.

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

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

  40. Passez en revue les Sorties, puis cliquez sur le bouton.

    Capture d’écran des sections Sorties de l’action de flux Composer.

    Vous devez voir deux résultats d’exécution pour les deux factures que vous avez créées.

    Capture d’écran des détails de l’historique des exécutions de flux.