Inspecter des objets aux points de contrôle

• Définir des points de contrôle dans votre code Apex.
• Analyser les objets présents dans la mémoire à l’aide de l’Inspecteur de points de contrôle.

Remarque

Vous souhaitez apprendre en français ? Dans ce badge, les validations de défi pratique Trailhead se font en anglais. Les traductions sont fournies entre parenthèses à titre de référence. Dans votre Trailhead Playground, veillez (1) à définir les États-Unis comme région, (2) à sélectionner l’anglais comme langue, et (3) à copier et coller uniquement les valeurs en anglais. Suivez les instructions ici.

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

1. Sélectionnez File (Fichier) | Open (Ouvrir) et ouvrez la classe EmailMissionSpecialist.
2. Sélectionnez Debug (Débogage) | Change Log Levels (Modifier les niveaux de consignation).
3. Dans la section General Trace Settings for You (Vos paramètres de suivi généraux), cliquez sur Add/Change (Ajouter/Modifier).
4. Choisissez FINEST comme niveau de consignation pour ApexCode.
   Remarque : Pour définir des points de contrôle, vous aurez besoin de la permission utilisateur Voir toutes les données. Pour générer des résultats en utilisant des points de contrôle, exécutez du code avec l’exécution anonyme, ou définissez un marqueur de suivi DEVELOPER_LOG sur vous-même. Le marqueur de suivi doit avoir un niveau de consignation pour Apex de INFO ou plus.
5. Pour enregistrer vos modifications, cliquez sur Done (Terminé).
6. Pour quitter la boîte de dialogue de modification des niveaux de consignation, cliquez sur Done (Terminé).

EmailMissionSpecialist em = new EmailMissionSpecialist();
em.sendMail('Enter your email address', 'Flight Path Change', 
   'Mission Control 123: Your flight path has been changed to avoid collision '
   + 'with asteroid 2014 QO441.');

• Le tableau Checkpoints (Points de contrôle) affiche l’espace de nommage, la classe et le numéro de ligne de chaque point de contrôle. Il fournit également la date et l’heure de création de chaque point de contrôle.
• Le tableau Checkpoint Locations affiche le nom de fichier, le numéro de ligne et les itérations captées par le point de contrôle sélectionné.

• Heap (Mémoire) : affiche tous les objets présents dans la mémoire au niveau de la ligne de code où le point de contrôle a été exécuté.
• Symbols (Symboles) : affiche tous les symboles présents dans la mémoire sous forme d’arborescence.

Onglet Heap (Mémoire)

L’onglet Heap (Mémoire) abrite des panneaux très pratiques pour le débogage, comme le panneau Types. Ce panneau indique le nombre d’objets qui ont été instanciés et la mémoire qu’ils ont consommée en octets. Examinons les informations captées par le point de contrôle que vous avez défini.

1. Sous Types, cliquez sur Messaging.SingleEmailMessage.
2. Sous Instances, cliquez sur une instance quelconque de ce type d'objet.
3. Sous State (État), vous trouverez les champs de l'objet ainsi que leurs valeurs.

Onglet Symbols (Symboles)

L’onglet Symbols (Symboles) est un moyen simple et rapide de connaître l'état de divers objets à un point de contrôle donné. Les symboles sont des noms uniques qui font référence à des objets spécifiques. L’onglet affiche tous les symboles présents dans la mémoire sous forme d’arborescence.

En tant que commandant, vous ne pouvez pas vous contenter de vérifier que les systèmes fonctionnent correctement : vous devez également pourchasser les erreurs. Voyons comment l’inspecteur de points de contrôle peut vous aider à mieux comprendre votre code.

1. Pour effacer les résultats d’un point de contrôle de l’onglet, sélectionnez Debug (Débogage) | Clear (Effacer) | Checkpoint Results Panel (Panneau des résultats des points de contrôle).
2. Sélectionnez Debug (Débogage) | Open Execute Anonymous Window (Ouvrir la fenêtre d’exécution anonyme).
3. Exécutez à nouveau la classe EmailMissionSpecialist, mais fournissez-lui cette fois une adresse e-mail non valide comme testingemail.

   EmailMissionSpecialist em = new EmailMissionSpecialist();
   em.sendMail('testingemail', 'Flight Path Change', 
      'Mission Control 123: Your flight path has been changed to avoid collision '
      + 'with asteroid 2014 QO441.');

4. Une fois que vous avez exécuté le code, cliquez sur l’onglet Checkpoints (Points de contrôle).

L’onglet Checkpoints (Points de contrôle) n'affiche aucun résultat parce que l’exécution de votre code n’a pas atteint le numéro de ligne auquel votre point de contrôle est défini.

Ajoutons un point de contrôle plus tôt dans le code afin de capturer des informations avant que notre code n’atteigne l’erreur testingemailerror.

1. Sélectionnez File (Fichier) | Open (Ouvrir) et ouvrez la classe EmailMissionSpecialist.
2. Cliquez sur le numéro de ligne devant String[] toAddresses = new String[] {address}.
3. Sélectionnez Debug (Débogage) | Clear (Effacer) | Checkpoint Results Panel (Panneau des résultats des points de contrôle).
4. Sélectionnez Debug (Débogage) | Open Execute Anonymous Window (Ouvrir la fenêtre d’exécution anonyme).
5. Exécutez à nouveau la classe EmailMissionSpecialist en fournissant une adresse e-mail non valide comme testingemail.

   EmailMissionSpecialist em = new EmailMissionSpecialist();
   em.sendMail('testingemail', 'Flight Path Change', 
      'Mission Control 123: Your flight path has been changed to avoid collision '
      + 'with asteroid 2014 QO441.');

6. Cliquez sur l’onglet Checkpoints (Points de contrôle).

Une nouvelle entrée est visible sous l’onglet Checkpoints (Points de contrôle). Vous pouvez désormais analyser les objets présents dans la mémoire à l’aide de l’Inspecteur de points de contrôle.

• Aide Salesforce : Onglet Points de contrôle
• Aide Salesforce : Définir des points de contrôle dans le code Apex
• Aide Salesforce : Inspecteur de points de contrôle