Exercice : dépanner et déboguer Monitor

Effectué

Dans ce scénario d’exercice, vous avez créé et publié l’application Gestion des bouteilles pour votre organisation CoHo Winery.

Vous avez reçu les commentaires suivants :

  • Les utilisateurs reçoivent un avertissement chaque fois qu’ils démarrent l’application.

  • Une erreur survient si les utilisateurs tentent de soumettre un volume comprenant des nombres décimaux.

Remarque

Pour réussir toutes les étapes de cet exercice, vous devez avoir accès à deux utilisateurs dans votre environnement d’exercice ou travailler en binôme avec un collègue. Si aucun autre utilisateur n’est à votre disposition, effectuez les étapes que vous pouvez, puis lisez et passez en revue les activités jumelées.

Tâches

Dans cet exercice, vous allez effectuer les tâches suivantes :

  1. Effectuer un débogage à l’aide de l’outil Monitor

  2. Résoudre les problèmes

  3. Tester vos solutions

  4. Publier les modifications

Objectifs

Les objectifs de cet exercice sont que vous découvriez comment :

  • utiliser l’outil Monitor ;

  • déboguer les problèmes liés à votre application canevas ;

  • inviter d’autres utilisateurs à des sessions de débogage ;

  • activer le débogage pour une application publiée ;

  • déboguer une application publiée avec un utilisateur connecté.

Exercice 1 : importer une solution et exécuter un flux

Dans cet exercice, vous allez importer une solution dans votre environnement, puis exécuter un flux de cloud Power Automate qui va créer des exemples de données pour vous.

Tâche 1 : importer une solution

Dans cette tâche, vous allez importer une solution dans votre environnement.

  1. Vous devez télécharger le fichier zip pour mener cet exercice à bien. Cliquez sur Télécharger une fois le lien ouvert.

  2. Accédez à Power Apps Maker Portal, puis sélectionnez l’environnement que vous souhaitez utiliser pour ce labo.

  3. Cliquez sur Solutions > Importer la solution.

  4. Cliquez sur Parcourir dans le volet Importer une solution.

  5. Recherchez/sélectionnez le fichier de solution CohoVineyardMonitorModule_1_0_0_1.zip, puis cliquez sur Ouvrir.

  6. Cliquez sur Suivant.

  7. Si vous y êtes invité, sélectionnez/créez une connexion.

  8. Cliquez sur Importer, puis attendez la fin du processus d’importation de la solution. Suivez l’étape permettant d’établir la connexion à Dataverse, si vous y êtes invité.

  9. Ne quittez pas cette page. Le processus prend quelques minutes. Le message d’information suivant s’affiche alors en haut de votre écran : Importation en cours de la solution « Coho Vineyard : module Monitor ».

    Une fois le chargement de votre solution terminé, le message d’information devient un message de réussite vous informant que l’importation de la solution a réussi. (vous devrez peut-être actualiser votre écran pour le voir.) Vous pouvez maintenant passer à l’étape suivante.

Tâche 2 : exécuter un flux

Dans cette tâche, vous allez exécuter un flux de cloud Power Automate qui va ajouter des exemples de données à votre environnement.

  1. Sélectionnez Coho Vineyard : module Monitor dans la liste des solutions.

  2. Recherchez et sélectionnez le flux de cloud Générer des données de test. Si ce flux de cloud est le premier pour cet environnement, vous devrez peut-être accepter des conditions, puis le sélectionner pour le rouvrir.

  3. Cliquez sur Exécuter dans la barre de commandes.

  4. Cliquez sur Exécuter le flux dans le volet droit.

  5. Cliquez sur Terminé, puis attendez la fin de l’exécution du flux. Ce processus peut prendre trois à six minutes.

  6. Cliquez sur le bouton Précédent de votre navigateur pour revenir à la solution.

  7. Recherchez et sélectionnez l’application canevas Gestion des bouteilles CoHo.

    L’application devrait se charger et les données de test créées par le flux de cloud devraient s’afficher sur l’écran d’accueil pour confirmer que le flux a réussi à créer des données.

Exercice 2 : effectuer un débogage et résoudre un problème de chargement

Dans cet exercice, vous allez surveiller l’application pour déterminer la cause de l’échec survenant lors de son chargement, puis résoudre le problème.

Tâche 1 : effectuer un débogage

Dans cette tâche, vous allez déboguer l’application à l’aide de l’outil Monitor.

  1. Si vous n’avez pas encore ouvert l’application Gestion des bouteilles CoHo dans Power Apps, recherchez-la et sélectionnez-la depuis la solution Coho Vineyard : module Monitor, sinon passez à l’étape suivante.

  2. Cliquez sur l’onglet Outils avancés (qui ressemble à une clé avec un tournevis pointant vers le haut), puis sur Ouvrir Monitor (n° 1 dans l’image ci-dessous).

    Capture d’écran du bouton Ouvrir Monitor mis en évidence dans l’onglet Outils avancés.

    Une autre façon d’ouvrir Monitor est de cliquer sur l’icône Vérificateur d’application représentant un stéthoscope dans la barre de commandes, puis sur Ouvrir Monitor en bas du volet Vérificateur d’application (n° 2 dans l’image ci-dessus).

    Monitor devrait s’ouvrir dans un nouvel onglet ou une nouvelle fenêtre de navigateur et se connecter à votre application. Vous voyez alors « Power Apps | Monitor - Gestion des bouteilles CoHo » dans le titre et la notification suivante au centre de l’écran : « Vous avez démarré une nouvelle session Monitor. »

  3. Ne fermez pas le navigateur Monitor. Revenez à l’onglet de navigateur Power Apps, puis cliquez sur le bouton Aperçu dans la barre de commandes.

  4. L’application devrait s’ouvrir en mode Aperçu. Cliquez sur le bouton Actualiser en haut de l’en-tête de l’application à gauche. Vous ne devriez remarquer aucun changement sur l’écran de l’application. Laissez votre application en mode Aperçu et passez à l’étape suivante.

  5. Revenez à l’onglet Monitor pour examiner les événements. Sélectionnez l’événement d’avertissement de catégorie Délégation qui s’affiche.

  6. Un volet de propriétés de Filtre devrait s’ouvrir sur le côté droit de l’écran Monitor. Il commence sur l’onglet Détails. Cliquez sur le caret à gauche du nœud formulaData pour le développer. Notez que les lignes de code se développent/se réduisent lorsque vous les activez.

    Capture d’écran de l’onglet Détails dans Monitor et du bouton Développer mis en évidence.

  7. Examinez le nœud formulaData, puis, de même, développez le nœud data.

  8. Faites défiler vers le bas, puis lisez le message décrivant le problème. Vers le bas du code, vous voyez alors des informations importantes concernant cet avertissement :

    Capture d’écran des détails de l’avertissement du filtre avec les informations du message d’erreur mises en évidence.

    Dans ce cas, Monitor nous fournit des informations sur l’erreur, une URL permettant de demander de l’aide pour résoudre ce problème (sachant que vous pouvez maintenir la touche Ctrl enfoncée et sélectionner le lien pour ouvrir la référence dans un autre onglet de navigateur) et une description plus longue de l’erreur.

  9. Vous pouvez télécharger les journaux d’événements Monitor et les charger ultérieurement ou les partager avec des membres d’équipe. Cliquez sur Télécharger dans la barre de commandes pour les ajouter à vos téléchargements.

  10. Cliquez sur Effacer les données dans la barre de commandes, puis Monitor efface le moniteur d’événements.

  11. Fermez l’onglet ou la fenêtre de navigateur Monitor.

  12. Revenez à l’éditeur Power Apps, puis fermez l’aperçu.

  13. Ne quittez pas cette page.

Tâche 2 : corriger la formule

Dans cette tâche, vous allez corriger la formule.

  1. Cliquez sur l’onglet Arborescence, puis sélectionnez le contrôle BottleGallery depuis HomeScreen.

  2. Avec la propriété Items s’affichant dans le champ de saisie de formule, cliquez dans ce champ. L’avertissement s’affiche également dans la barre, avec un double soulignement bleu. Si vous survolez le double soulignement bleu, l’avertissement suivant s’affiche : « Le composant DateAdd de cette formule peut ne pas fonctionner correctement sur des jeux de données volumineux. »

    Vous remarquerez peut-être également que votre contrôle de galerie comporte un triangle d’avertissement jaune dans le coin supérieur gauche de l’écran de l’application. Le survoler entraîne l’affichage du même avertissement. Un clic sur Obtenir de l’aide pour cet avertissement entraîne l’ouverture du volet Détails sur le côté droit de l’écran décrivant le problème et comment le résoudre.

  3. Remplacez la formule actuelle par la formule suivante :

    Filter(Bottles, 'Modified On' > DateAdd(Today(), - 7, TimeUnit.Days))     
    

    L’avertissement devrait disparaître.

  4. Cliquez sur l’onglet Outils avancés situé dans le volet de navigation gauche, puis sur Ouvrir Monitor.

  5. Laissez l’outil Monitor s’exécuter.

  6. Revenez à l’onglet de navigateur de l’éditeur Power Apps et cliquez sur Aperçu.

  7. Cliquez sur le bouton Actualiser de l’application.

  8. Revenez à l’onglet de navigateur Monitor.

    Il devrait y avoir trois résultats de réussite sans aucun avertissement.

  9. Cliquez sur le bouton Effacer les données.

  10. Cliquez sur Charger.

  11. Sélectionnez le fichier « PowerAppsTraceEvents » que vous avez téléchargé précédemment, puis cliquez sur Ouvrir.

    Le fichier devrait se charger et les journaux d’événements précédents devraient s’afficher. Ce journal des événements affiche l’avertissement précédent.

  12. Nous n’avons plus besoin d’afficher ce journal des événements d’avertissement, donc vous pouvez fermer l’onglet de navigateur Monitor.

  13. Fermez l’aperçu du concepteur d’applications.

  14. Ne quittez pas l’éditeur Power Apps.

Exercice 3 : surveiller et résoudre le problème de remplissage de bouteilles

Dans cet exercice, vous allez surveiller l’application pour déterminer la cause du problème de soumission de remplissage de bouteilles.

Tâche 1 : déboguer le bouton Remplir la bouteille

Dans cette tâche, vous allez déboguer l’application pendant que vous mettez à jour un enregistrement à l’aide de Monitor.

  1. Sur l’écran de modification Power Apps, cliquez sur l’onglet Outils avancés, puis sur Ouvrir Monitor.

    Encore une fois, Monitor devrait s’ouvrir dans un nouvel onglet ou une nouvelle fenêtre de navigateur et se connecter à votre application.

  2. Laissez l’outil Monitor s’exécuter.

  3. Revenez à l’éditeur Power Apps, puis cliquez sur Aperçu.

  4. Saisissez 28 pour le Volume d’une bouteille, puis cliquez sur Remplir la bouteille.

    Vous avez peut-être remarqué que l’entrée Volume et le bouton Remplir la bouteille ont tous deux disparu de cette ligne quelques instants après, mais vous ne devriez voir aucun message d’erreur.

  5. Accédez à Monitor, puis examinez les journaux d’événements. Assurez-vous qu’aucune erreur ne s’affiche, puis sélectionnez l’opération patchRow.

  6. Dans Détails de patchRow, développez et examinez les nœuds formulaData et data. L’onglet Détails affiche toutes les informations s’affichant dans les onglets Formule, Requête et Réponse.

  7. Cliquez sur l’onglet Formule pour examiner la formule. Il s’agit de la formule Power Apps pour le bouton sur lequel vous avez cliqué dans votre application.

  8. Cliquez sur l’onglet Requête, puis examinez le nœud body. La date du jour devrait s’afficher en regard de cv_bottledon, et la valeur 28 en regard de cv_volume.

  9. Cliquez sur l’onglet Réponse et assurez-vous qu’un statut 200 s’affiche.

  10. Vous déterminez que tout semble fonctionner comme prévu. Cliquez sur Effacer les données. Laissez Monitor ouvert.

  11. Revenez au concepteur, accédez à une autre bouteille de votre galerie et saisissez 28,5 pour le Volume, puis cliquez sur Remplir la bouteille. Notez que votre champ de saisie revient tel qu’il était avant la saisie de données. Voyons ce qui se passe.

  12. Revenez à l’outil Monitor, qui affiche désormais un message d’erreur Mauvaise requête pour l’opération patchRow. Sélectionnez l’opération patchRow.

  13. Cliquez sur l’onglet Réponse, développez le nœud body, puis analysez le message. Le message d’erreur comporte beaucoup de texte, mais cela est dû à une incompatibilité de type. Les données attendent une valeur entière et nous avons fourni une valeur décimale. Nous allons revenir à l’application pour résoudre ce problème.

  14. Cliquez sur Effacer les données, mais laissez l’outil Monitor s’exécuter.

  15. Revenez à l’éditeur Power Apps, puis fermez l’aperçu. Notez qu’une erreur d’exécution s’affiche désormais au-dessus de votre bouton dans la galerie.

  16. Ne quittez pas cette page.

Tâche 2 : résoudre le problème d’incompatibilité

Dans cette tâche, vous allez corriger le problème d’incompatibilité de type.

  1. Cliquez sur l’onglet Arborescence, puis développez votre contrôle BottleGallery.

  2. Cliquez sur le contrôle ButtonFillBottle. Nous allons résoudre ce problème en désactivant le bouton, à moins que l’utilisateur ne fournisse une valeur numérique entière.

  3. Sélectionnez la propriété DisplayMode dans la barre de formule, puis remplacez la valeur actuelle par la formule suivante : Cette formule recherche plusieurs chiffres dans le champ de saisie.

    If(IsMatch(TextVolume.Text,Match.MultipleDigits),DisplayMode.Edit,DisplayMode.Disabled)     
    
  4. Cliquez sur Aperçu.

  5. Saisissez 28 pour le Volume d’une ligne. Le bouton Remplir la bouteille devrait s’activer.

  6. Définissez le Volume sur 28,5. Le bouton Remplir la bouteille devrait désormais se désactiver.

  7. Tapez 28 onces pour le Volume. Le bouton Remplir la bouteille devrait rester désactivé.

  8. Définissez le Volume sur 28. Le bouton Remplir la bouteille devrait s’activer.

  9. Cliquez sur le bouton Remplir la bouteille.

  10. Accédez à l’outil Monitor et assurez-vous que le champ Résultat ne comporte aucune erreur.

  11. Fermez l’outil Monitor.

  12. Fermez l’aperçu.

Exercice 4 : collaborer

Dans cet exercice, vous allez partager une session de débogage avec un collègue, puis surveiller une application publiée.

Tâche 1 : partager une session de débogage

Dans cette tâche, vous allez partager une session avec un collègue.

Remarque

L’utilisateur avec qui vous partagez la session doit être membre de votre organisation et disposer d’une licence Power Apps.

  1. Si l’application Gestion des bouteilles CoHo est toujours ouverte dans l’éditeur Power Apps, vous pouvez passer à l’étape 4, sinon accédez à Power Apps Maker Portal et vérifiez que vous vous trouvez dans l’environnement adéquat.

  2. Cliquez sur Solutions, puis sélectionnez la solution CoHo Vineyard : module de surveillance pour l’ouvrir.

  3. Recherchez et sélectionnez l’application Gestion des bouteilles CoHo pour l’ouvrir.

    L’application devrait s’ouvrir dans l’éditeur d’applications.

  4. Cliquez sur Outils avancés > Ouvrir Monitor.

  5. Cliquez sur Inviter sur le côté droit de la barre de commandes.

  6. Recherchez, puis sélectionnez l’utilisateur avec qui vous souhaitez partager la session.

  7. Copiez le lien de la session utilisateur.

  8. Envoyez le lien à l’utilisateur, puis invitez-le à cliquer dessus.

    Un clic sur le lien entraîne l’ouverture d’une fenêtre de navigateur redirigeant l’utilisateur vers l’instance de Power Apps Monitor avec une notification indiquant qu’il se trouve dans une Session d’invité.

  9. Revenez à Power Apps, puis cliquez sur le bouton Aperçu pour l’application Gestion des bouteilles.

  10. Cliquez sur le bouton Actualiser dans l’application.

  11. Revenez à l’outil Monitor, où les journaux d’événements s’affichent.

    L’utilisateur de votre session d’invité devrait également voir les mêmes journaux d’événements.

  12. Fermez l’outil Monitor.

  13. La session est alors terminée ; par conséquent, vous devez réinviter votre utilisateur invité si vous souhaitez partager une autre session.

  14. Fermez l’aperçu.

  15. Ne quittez pas cette page.

Tâche 2 : déboguer une application publiée

Dans cette tâche, vous allez activer le débogage publié pour l’application, la publier, puis la déboguer pendant que d’autres personnes l’utilisent.

  1. Dans l’application, cliquez sur Paramètres dans la barre de commandes.

  2. Faites défiler l’onglet Général vers le bas, puis activez le bouton bascule Déboguer l’application publiée.

  3. Fermez la fenêtre contextuelle Paramètres.

  4. Enregistrez votre application (si nécessaire) et Publiez-la. Une fenêtre contextuelle Publier s’affiche alors.

  5. Cliquez sur Publier cette version.

Votre application est désormais publiée et les personnes qui y ont accès peuvent l’utiliser.

Tâche 3 : partager et déboguer une application publiée

Pour tester le débogage publié, votre première tâche consiste à lire l’application publiée. Ensuite, vous allez partager l’application avec votre collègue. Vous allez ensuite créer un rôle de sécurité qui permet aux utilisateurs d’afficher et de mettre à jour les lignes de la table Bouteille, puis ajouter votre collègue à ce rôle. N’oubliez pas que votre collègue doit être membre de votre organisation avec une licence Power Apps.

  1. Si l’application Gestion des bouteilles est toujours ouverte, passez à l’étape 4 ci-dessous, sinon accédez à Power Apps Maker Portal et vérifiez que vous vous trouvez dans l’environnement adéquat.

  2. Cliquez sur Applications.

  3. Sélectionnez l’application Gestion des bouteilles CoHo, puis cliquez sur Partager.

  4. Recherchez, puis sélectionnez l’utilisateur avec qui vous souhaitez partager l’application.

  5. Cliquez sur Partager.

    Important

    Les collègues avec lesquels vous partagez l’application peuvent avoir besoin d’une licence pour utiliser l’application. Un clic sur Demander des licences entraîne l’envoi d’une demande à votre administrateur.

  6. Fermez le volet Partager.

  7. Dans l’en-tête de navigateur, cliquez sur l’icône Paramètres représentant un engrenage, puis sur Centre d’administration dans le volet Paramètres.

  8. Cliquez sur Environnements dans le volet de navigation gauche.

  9. Sélectionnez l’environnement que vous utilisez pour ce labo, puis lorsque la page Informations sur l’environnement s’affiche, cliquez sur Paramètres dans la barre de commandes.

  10. Développez la section Utilisateurs + autorisations, puis sélectionnez Rôles de sécurité.

  11. Dans la barre de commandes de Rôles de sécurité, cliquez sur + Nouveau rôle.

  12. Dans le volet Créer un rôle à droite, saisissez « Remplisseur de bouteilles » dans le champ Nom du rôle, sélectionnez un Centre de profit dans la liste déroulante et cliquez sur Enregistrer.

  13. Sous Rôles de sécurité > Remplisseur de bouteilles, recherchez la table Bouteille. Vous pouvez saisir « bouteille » dans le champ de recherche en haut de l’écran à droite pour vous aider.

  14. Sélectionnez la table Bouteille sous la liste Tables personnalisées. Notez que les contrôles déroulants s’affichent sous les paramètres d’autorisation, notamment Créer au moyen de Partager.

  15. Redéfinissez l’accès pour chacun de ces paramètres d’autorisation sur Organisation.

  16. Cliquez sur Enregistrer + fermer dans la barre de commandes.

  17. Dans la liste des Rôles de sécurité, recherchez le rôle Remplisseur de bouteilles et cliquez sur les points de suspension Plus d’actions. Sélectionnez ensuite Membres.

  18. À l’heure actuelle, la liste Remplisseur de bouteilles > Membres est vide. Cliquez sur + Ajouter des personnes.

  19. Dans le volet Ajouter des personnes, saisissez le nom de votre collègue pour le rechercher. Une fois que son nom s’affiche, sélectionnez-le. Ensuite, cliquez sur Ajouter en bas du volet. Son nom devrait maintenant s’afficher sous la liste Remplisseur de bouteilles > Membres.

    Votre collègue devrait désormais être en mesure d’utiliser l’application.

  20. Revenez à la page d’accueil Power Apps.

  21. Cliquez sur Applications.

  22. Sélectionnez Gestion des bouteilles CoHo > Détails > Monitor. Vous n’avez pas besoin d’ouvrir l’application en mode Édition. Vous pouvez cliquer sur les points de suspension Commandes pour rechercher Détails > Monitor ou sur le bouton radio à gauche du nom, puis rechercher la liste déroulante Détails dans la barre de commandes.

    Monitor s’ouvre alors dans un onglet de navigateur distinct.

  23. Dans Monitor, recherchez et sélectionnez Lire l’application publiée dans la barre de commandes.

  24. L’application devrait se charger dans un nouvel onglet ou une nouvelle fenêtre. Cliquez sur le bouton Actualiser de l’application.

  25. Accédez à l’outil Monitor pour afficher les journaux d’événements de session.

  26. Effectuez certaines actions dans l’application, puis affichez les journaux d’événements de session.

  27. Ensuite, fermez l’onglet ou la fenêtre de navigateur de l’application.

  28. De retour dans Monitor, cliquez sur Effacer les données.

  29. Dans la barre de commandes Monitor, cliquez sur Connecter un utilisateur.

  30. Recherchez, puis sélectionnez votre collègue.

  31. Copiez le lien.

  32. Partagez le lien avec votre collègue, puis demandez-lui de cliquer dessus.

  33. Fermez le volet Connecter un utilisateur.

  34. Lorsque l’autre utilisateur accède au lien, une fenêtre contextuelle s’affiche, afin de lui demander s’il souhaite rejoindre la session de débogage.

  35. L’application devrait se charger pour l’autre utilisateur, qui sait que d’autres personnes peuvent voir les données de session.

  36. Accédez à l’outil Monitor, où vous pouvez afficher les journaux d’événements des interactions de l’autre utilisateur.

    Avec cette fonctionnalité à votre disposition, vous pouvez voir les problèmes rencontrés par un autre utilisateur avec une application lorsqu’il interagit avec l’application.

  37. Invitez l’autre utilisateur à créer et mettre à jour des lignes, puis consulter les journaux d’événements dans Monitor.

  38. Ensuite, fermez l’outil Monitor. Cette action met fin à la session et déconnecte votre collègue de Monitor.

J’espère que vous avez compris la puissance du débogage de votre application à l’aide de Power Apps Monitor. La possibilité de surveiller les interactions d’un collègue avec l’application vous permet de vous concentrer sur tout problème lié à l’application en temps réel.