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

Effectué

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

Notes

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.

Notes

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

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

  1. Accédez au Portail des créateurs Power Apps et assurez-vous que vous vous trouvez dans l’environnement approprié.

  2. Sélectionnez Solutions > Importer.

  3. Sélectionnez Parcourir.

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

  5. Sélectionnez Suivant.

  6. Sélectionnez 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. Sélectionnez Publier toutes les personnalisations et attendez la fin de la publication.

  8. Ouvrez la solution Déclencheurs Contoso Invoicing que vous avez importée.

    Vous devriez voir le composant connecteur personnalisé Déclencheurs Contoso Invoicing.

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

  9. Accédez à Contoso Invoicing.

  10. Sélectionnez 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 au Portail des créateurs Power Apps et assurez-vous que vous vous trouvez dans l’environnement approprié.

  13. Sélectionnez Solutions, puis ouvrez la solution Déclencheurs Contoso Invoicing.

  14. Ouvrez le connecteur personnalisé Déclencheurs Contoso Invoicing.

  15. Sélectionnez 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. Sélectionnez Mettre à jour le connecteur.

  18. Sélectionnez 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. Sélectionnez 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é Déclencheurs Contoso Invoicing et sélectionnez 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. Entrez les valeurs suivantes, puis cliquez sur Importer.

    • Verbe : GET

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

  6. Sélectionnez le bouton 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 Retour.

    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écifier la valeur à transmettre au paramètre de requête sélectionné. Vous pouvez choisir des expressions : @{triggerBody().invoices[0].createDate}

    • Sélectionner une collection contenant les données du déclencheur : @triggerBody().invoices

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

  11. Sélectionnez 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 au Portail des créateurs Power Apps et assurez-vous que vous vous trouvez dans l’environnement approprié.

  2. Sélectionnez Solutions, puis ouvrez la solution Déclencheurs Contoso Invoicing.

  3. Sélectionnez + 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. Sélectionnez + 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. Sélectionnez l’onglet Personnalisé, puis sélectionnez le connecteur personnalisé Contoso Invoicing.

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

  9. Sélectionnez 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. 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. Sélectionnez Enregistrer.

  13. Conservez cet onglet ou cette fenêtre de navigateur ouvert(e), basculez vers un onglet ou une fenêtre du navigateur de la solution, puis cliquez sur Terminé.

    Capture d’écran du flux terminé avec le bouton Terminé.

  14. Cliquez de nouveau sur + Nouveau > Flux de cloud.

  15. Entrez Interrogation de notification de facture comme nom, sélectionnez l’onglet Personnalisé, puis le connecteur personnalisé Contoso Invoicing.

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

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

  17. Sélectionnez le bouton Menu... du déclencheur, puis assurez-vous que Références de connexion est sélectionné.

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

  18. Sélectionnez + Nouvelle étape.

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

  20. Sélectionnez 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.

  21. Sélectionnez Enregistrer, puis attendez que le flux soit enregistré.

  22. Sélectionnez Tester.

  23. Sélectionnez Manuellement > Enregistrer et tester. Le flux commence, attendez les notifications.

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

  25. Sélectionnez Tester.

  26. Sélectionnez Manuellement > Enregistrer et tester.

  27. Entrez 6500 pour Montant, puis sélectionnez Exécuter le flux.

  28. Sélectionnez Terminé.

  29. Le flux doit s’exécuter avec succès. Sélectionnez Modifier.

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

  30. Cliquez de nouveau sur Tester.

  31. Sélectionnez Manuellement > Enregistrer et tester.

  32. Entrez 8800 pour Montant, puis sélectionnez Exécuter le flux.

  33. Sélectionnez Terminé. Le flux doit à nouveau s’exécuter avec succès.

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

    Notes

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

  35. Sélectionnez pour développer l’étape de l’action Composer.

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

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