Partager via


Utiliser Moniteur pour résoudre les problèmes liés au comportement des formulaires d’applications pilotées par modèle

Monitor est un outil qui peut aider les créateurs d’applications à déboguer et diagnostiquer les problèmes, ce qui les aide à créer des applications plus rapides et plus fiables. Monitor fournit une vue approfondie du fonctionnement d’une application en fournissant un journal de toutes les activités de l’application au fur et à mesure de son exécution.

Le filtrage des événements liés aux formulaires d’application pilotées par modèle dans Monitor peut fournir des informations sur les tables, les tableaux, les contrôles et les composants associés sur un formulaire dans Monitor pendant l’exécution de votre application.

Dans de nombreuses situations, Monitor peut aider les créateurs à comprendre pourquoi un formulaire se comporte d’une certaine manière. De nombreux problèmes de formulaire sont basés sur des règles métier, JavaScript, des événements de formulaire ou une API client définie par les administrateurs et les créateurs. Monitor peut également aider à identifier si le problème rencontré est conçu par défaut ou est dû à une personnalisation. Il fournit des détails qui peuvent aider à répondre aux questions suivantes :

Suivez les instructions ci-dessous pour comprendre le comportement de vos formulaires d’applications pilotées par modèle.

Étape 1 : créer une session Monitor

Il existe deux manières d’ouvrir une session Monitor.

Option 1 :

  1. Se connecter à Power Apps, cliquer sur Applications.

  2. Sélectionner ... à côté de l’application pilotée par modèle ou dans la barre de commandes globale, puis sélectionnez Monitor.

    Exemple d’application pilotée par modèle

  3. Suivez les instructions à l’écran pour exécuter l’application et rejoindre la session de surveillance.

Option 2 :

  1. Lancer votre application pilotée par modèle.

  2. Ajouter &monitor=true à la fin de l’URL dans votre navigateur Web, puis actualisez la page.

  3. Sélectionnez Monitor sur la barre de commandes.

    Emplacement du bouton Monitor dans la barre de commandes globale

Étape 2 : Connectez votre application à la session Monitor

  1. Une fois dans Monitor, sélectionnez Lancer l’application pilotée par modèle dans le menu de la barre de commandes. Cela ouvre l’application et commence la surveillance.

  2. Effectuez des actions dans l’application pilotée par modèle conformément à l’utilisation normale de l’application. Par exemple, ouvrez et modifiez des données à l’aide d’un formulaire de table.

  3. Dans la fenêtre du navigateur exécutant Monitor, sélectionnez la colonne Catégorie, puis sélectionnez Filtrer par.

    Filtrer sur les événements de formulaire dans Monitor.

  4. Sélectionner Égal ou Contient dans la liste déroulante, puis saisissez formchecker dans la case. Cliquez sur Appliquer.

    Enter formchecker filter
  5. Les catégories sont maintenant filtrées. La colonne Opération peut être développée pour voir le nom complet des événements qui sont suivis en sélectionnant et en maintenant le côté droit de la colonne et en faisant glisser vers la droite. Lorsque vous utilisez l’application et ouvrez et utilisez un formulaire, Surveiller met à jour la liste des événements.

    Affichage des événements de formulaire surveillés.

Utilisez Monitor pour comprendre le comportement du formulaire

Pour chaque ligne avec Monitor, des informations détaillées sur l’événement de formulaire peuvent être consultées. Par exemple, imaginons que vous ayez une question concernant une erreur survenue dans le formulaire. Vous accédez à ce formulaire dans l’application et sélectionnez le composant de formulaire approprié. Revenez ensuite au navigateur avec Monitor activé et examinez les résultats avec ou sans filtrage. Dans ce cas, il y a une erreur sur le champ composite. En développant les zones de Détails vous pouvez en savoir plus sur l’événement lui-même.

Surveillance d’un menu associé.

Il existe de nombreux types d’événements qui sont surveillés, y compris les événements de formulaire standard tels que onload, onsave et onclose.

Au fur et à mesure que vous continuez à utiliser l’application surveillée, Surveiller met à jour les informations dans la liste des événements. Pour les formulaires, il existe de nombreux scénarios différents que vous pouvez résoudre et trouver des informations supplémentaires sur le formulaire, le contrôle ou la table en cours de traitement.

Zones et événements de vérification de formulaire pris en charge

Les zones prises en charge pour la surveillance des formulaires sont les suivantes.

Zone d’application Description
État du contrôle Détails sur l’état de la source visible, activée et étiquetée d’un contrôle lorsque le formulaire est chargé.
Menu Association Détails sur l’état des éléments de menu associés. Exemples :
Pourquoi un élément de menu n’est-il pas affiché ?
D’où vient l’élément de données ?
Changement d’état d’onglet / section / contrôle Détails sur qui (via la pile d’appels) a causé la modification de la visibilité et de l’état activé du composant, comme un onglet, une section ou un contrôle.
Navigation Détails sur ce qui cause la navigation ou les dialogues inattendus en traçant la pile d’appels de ces méthodes Xrm.Navigation de l’API client : openAlertDialog(), openConfirmDialog(), openDialog(), openErrorDialog(), navigateTo(), openForm(), openTaskFlow(), openUrl(), openWebResource()
Personnalisations non prises en charge Détails sur l’accès à l’API client non pris en charge avant que le formulaire ne soit prêt. Exemples :
Accès à parent.Xrm.Page dans iFrame avant que le formulaire ne soit complètement chargé.
Accéder à Xrm.Page dans une ressource Web de formulaire en dehors des contextes de gestionnaire de formulaire en utilisant window.setTimeout() pour appeler périodiquement l’API client de formulaire.
Accès à Xrm.Page dans la méthode updateView() du code de contrôle Power Apps control framework.

Voici des exemples d’événements liés au formulaire pris en charge dans Surveiller :

  • FormEvents.onsave
  • XrmNavigation
  • FormEvents.onload
  • FormControls
  • TabStateChange.visible
  • RelatedMenu
  • ControlStateChange.disabled
  • ControlStateChange.visible
  • SectionStateChange.visible
  • UnsupportedClientApi

Étapes suivantes

Pour plus d’informations sur la résolution des problèmes liés aux formulaires dans une application pilotée par modèle, consultez Résoudre les problèmes de formulaire dans les applications basées sur un modèle.

En savoir plus sur Monitor en tant qu’outil Power Apps

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).