Débogueur
Le débogueur vous permet de déboguer une expression XPath dans le contexte d’un fichier de travail XML. Pour accéder au débogueur, sélectionnez Lancer débogage dans le menu déroulant Lancer Évaluation/Débogage (capture d'écran ci-dessous). Le mode Déboguer est activé. Vous pouvez ensuite alterner entre le Générateur (pour obtenir de l’aide avec la génération d’expression) et l’Évaluateur (pour déboguer l’expression). Pour lancer le débogage, cliquer sur Lancer Évaluation/Débogage (F5)
Une fois que vous avez saisi une expression, vous pouvez commencer à déboguer en cliquant sur Lancer Évaluation/Débogage (F5) (après vous être assuré que vous êtes dans le mode Débogage).
|
Mise en page du Mode Débogage
Dans le Mode Débogage, deux volets supplémentaires sont ajoutés au volet Résultats (voir capture d'écran ci-dessous):
•le volet Pile d’appel et Points de débogage, dont chacun a un onglet séparé dans le volet
•le volet Variables et Expressions Watch ; les expressions watch et les variables sont affichées dans le même volet.
Le Mode Débogueur propose les fonctions suivantes :
•Vous permet de pénétrer dans le processus d’évaluation XPath, une étape à la fois pour voir comment l’expression XPath est évaluée. Utiliser la touche de la barre d’outils Entrer dans (F11). À chaque étape d’évaluation, la partie de l’expression actuellement évaluée est marquée en jaune (voir capture d'écran ci-dessus), alors que le résultat de l’évaluation de cette étape est affiché dans le volet Résultats. Par exemple, dans la capture d'écran ci-dessus, tous les éléments descendants section de l'élément book ont été sélectionnés.
•Définir des points d’arrêt dans les endroits où vous souhaitez interrompre l’évaluation et contrôler les résultats à ces points. Vous pouvez faire défiler l'évaluation en ne vous arrêtant que dans les points d'arrêt. Utiliser la touche de la barre d'outils Lancer le débogage (F5). Cela est plus rapide que de s'interrompre à chaque étape avec Pas à pas détaillé (F11).
•Définir des points de trace pour consulter un rapport des résultats dans les étapes marquées en tant que point de trace. L’évaluation ne s’interrompra pas (sauf aux points d’arrêt), mais les résultats du point de trace seront affichés dans une liste dans le volet Résultats.
•Des expressions Watch peuvent être utilisées pour contrôler l’information (comme des données de document ou des aspects de l’évaluation). Cela est particulièrement utile au niveau des points d’arrêt.
•Les variables qui sont exposées, y compris leurs valeurs, sont affichées dans le volet Variables et Expressions Watch.
•Les appels du processeur d’une étape d’évaluation sont affichés dans l’onglet Pile d’appel du volet Pile d’appel et Points de débogage.
•Si des points d’arrêt et des points de trace ont été définis, alors ils seront affichés dans l’onglet Points de débogage du volet Pile d’appel et Points de débogage.
Pour plus d'information à propos de ces fonctions, voir leur description ci-dessous.
Lancer le débogueur
Les étapes générales pour déboguer une expressions XPath sont les suivantes :
1.Saisir l’expression XPath dans le volet d’expression.
2.Définir tous les points d’arrêt ou les point de trace que vous souhaitez. Un point d’arrêt est un point au niveau duquel l’évaluation est interrompue. Un point d’arrêt est un point dans l’évaluation qui est enregistré ; les points de trace fournissent donc un chemin traçable des résultats d’évaluation.
3.Si vous cliquez sur Lancer débogage, l'évaluation est effectuée dans une étape jusqu'à la fin à moins qu'un point d'arrêt a été marqué dans l'expression. Cliquer sur Lancer débogueur plusieurs fois pour passer dans chaque point d’arrêt jusqu’à la fin de l’évaluation.
4.Utiliser la fonction Pas à pas détaillé/sortant/principal pour se rendre étape par étape par le biais de l'évaluation.
|
Entre, sort et passe par-dessus les étapes d’évaluation
La fonction Pas à pas détaillé vous permet de passer étape par étape à travers l’évaluation. Chaque clic de cette commande vous fait passer dans l’étape suivante de l’évaluation ; l’étape actuelle est soulignée par le marquage dans l’expression (voir capture d'écran ci-dessous). La fonction Pas à pas sortant vous amène à une étape dans un niveau supérieur que l’étape actuelle, alors que la fonction Pas à pas principal passe par-dessus les étapes de niveau inférieur et vous amène à l’étape suivante dans le même niveau. Vous pouvez essayer la fonction Pas à pas en utilisant l’expression affichée dans la capture d'écran ci-dessous et en cliquant sur les trois touches Pas à pas pour tester leur fonctionnement.
La capture d'écran ci-dessous montre l’évaluation lorsque le traitement a été interrompu lorsque vous avez atteint l’étape de localisation newsitem. À cette étape, le résultat affiche les quatre nœuds newsitem.
Points d’arrêt
Des point d’arrêt sont des points dans lesquels vous souhaitez que le débogueur s’arrête après l'avoir lancé avec la touche Lancer débogueur. Ils sont utiles lorsque vous souhaitez analyser une partie spécifique de l’expression. Lorsque le débogueur s’arrête au point d’arrêt, vous pouvez contrôler le résultat et vous pouvez ensuite utiliser la fonction Pas à pas détaillé pour afficher les résultats des étapes suivantes de l’évaluation. Pour définir un point d’arrêt, placer le curseur dans l’expression à l’endroit où vous souhaitez trouver le point d’arrêt, et cliquer sur la touche de la barre d’outils Insérer/Supprimer point d’arrêt (F9). Le point d’arrêt sera marqué avec une surligne en pointillés rouge. Pour retirer un point d’arrêt, le sélectionner et cliquer sur Insérer/Supprimer point d’arrêt (F9).
Voir aussi Points de débogage ci-dessous.
Points de trace
Des points de trace sont des points dans lesquels les résultats sont enregistrés. Ces résultats sont affichés dans l’arborescence Traces de l’onglet Résultat (voir capture d'écran ci-dessous). Cela vous permet de voir tous les résultats d’évaluation des parties particulières de l’expression. Par exemple, dans la capture d'écran ci-dessous, des points de trace ont été définis dans le nœud team et le nœud member. Les résultats dans ces points de trace sont affichés dans l’arborescence Traces.
Pour définir un point de trace, placer le curseur à l’endroit où vous souhaitez trouver le point de trace, et cliquer sur la touche de la barre d’outils Insérer/Supprimer point de trace (F9). Les points de trace seront marqués avec une surligne en pointillés bleu (voir capture d'écran ci-dessous). Pour supprimer un point de trace, le sélectionner et cliquer sur Insérer/Supprimer points de trace (F9).
Note : si le point d'arrêt et le point de trace sont définis sur une partie de l'expression, alors la surligne est composée de pointillés rouge et bleu.
Voir aussi Points de débogage ci-dessous.
Variables, Expressions Watch et Pile d'appels
Les variables et les expressions watch sont affichées dans le volet Variables et Expressions Watch (volet central inférieur dans la capture d'écran ci-dessous).
Variables
Les variables qui ont été déclarées dans l'expression et qui sont incluses dans l'étape d'évaluation actuelle seront affichées avec leurs valeurs actuelles respectives. Par exemple, dans la capture d’écran ci-dessus, le traitement a été interrompu au point d’arrêt dans la headline. La variable$i est dans la portée de cette étape d’évaluation. Donc $i est affichée avec sa valeur actuelle, qui dans la capture d'écran ci-dessus est le premier nœud newsitem.
Expressions Watch
Les expressions Watch sont des expressions que vous pouvez saisir, soit avant le début de l'évaluation ou pendant une interruption dans une évaluation. Elles peuvent être utilisées pour les objectifs suivants :
•Pour tester des conditions spécifiques. Par exemple, dans la capture d’écran ci-dessus, l’expression watch $i/metainfo/enteredBy/@id="NED" est utilisée pour tester si l’item news a été saisi par le membre de l’équipe avec l’id de NED. Le résultat true dans le cas du premier newsitem nous dit que cette condition a été satisfaite.
•Pour trouver des données dans le cadre d'un contexte particulier. Par exemple, dans le cadre du contexte d'un élément Company, nous pouvez saisir une expression watch @id pour consulter ce code de clients de l'entreprise dans le document XML cible.
•Pour générer des données supplémentaires. Par exemple, un string adapté peut être généré pour indiquer le nombre total de newsitems.
Pour saisir l'expression watch, cliquez sur Ajouter entrée Watch dans la barre d'outils du volet(encerclé en rouge dans la capture d'écran ci-dessus), puis double-cliquez la nouvelle entrée watch pour saisir l’expression et cliquez sur Entrée lorsque vous avez terminé. Pour supprimer une expression watch, la choisir et cliquer sur Supprimer Entrée watch sélectionnée dans la barre d'outils. Si, au cours du débogage, l’expression ne peut pas être évaluée correctement pour une raison quelconque (par exemple si une de ses variables est hors de portée), l’expression watch passe au rouge.
Pile d’appel
L’onglet Pile d’appel du volet Pile d’appel et Points de débogage(volet en bas à droite dans la capture d'écran ci-dessus) affiche les appels du processeur jusqu’à ce point du débogage. L’appel de processeur actuel est marqué en jaune. Veuillez noter que seuls les appels qui mènent directement à l'étape d'évaluation actuelle sont affichés.
Points de débogage
L’onglet Points de débogage du volet Pile d’appel et Points de débogage(volet en bas à droite dans la capture d'écran ci-dessous) montre les points d’arrêt (avec des cercles rouges) et des points de trace (cercles bleus) que vous avez défini dans l’expression. Chaque point de débogage est recensé avec son numéro de ligne et de caractère. Par exemple, AxisStep@2:12 signifie qu’il y a un point de débogage sur la ligne 2, caractère 12 de l’expression dans le volet d’expression.
Veuillez noter les fonctions suivantes :
•Pour les points d’arrêt, vous pouvez saisir une break condition en (i) double-cliquant sur Saisir break condition dans le volet Déboguer Points, (ii) saisissant l’expression pour la condition, et (iii) en appuyant sur Enter. Ce point d’arrêt sera uniquement activé si la condition évalue à true. Par exemple, dans la capture d’écran ci-dessus, la break condition $i/metainfo/enteredBy/@id="ABE" activera le point d’arrêt sur le titre de chaque newsitem qui a été saisi par le membre de l’équipe avec l’id ABE. La capture d'écran montre que l'évaluation s'est interrompue à ce point d'arrêt. (Notez également que l’expression Watch à ce point d’arrête renvoie false.)
•Vous pouvez activer/désactiver tous les points de débogage en cliquant sur leur touche de la barre d’outils respective : Activer tous les Points de débogage et Désactiver tous les Points de débogage (touches encerclées en vert dans la capture d'écran ci-dessus). Lorsqu’un point de débogage est désactivé, il est désactivé pour toutes les évaluations jusqu’à ce qu’il soit réactivé ultérieurement.
•Vous pouvez activer/désactiver les points d’arrêt individuels dans leurs menus contextuels respectifs.
Commandes de barre d’outils dans les volets
Les volets du dialogue Éditer Expression XPath dans le Mode Débogage (voir capture d'écran ci-dessus) contiennent des touches qui proposent des fonctions de navigation, de recherche et de copie. Ces boutons, en commençant par la gauche, sont décrits dans la table ci-dessous. Les commandes correspondantes sont aussi disponibles dans le menu contextuel des items recensés.
Icône | Fonction |
Suivant, Précédent | Sélectionne, respectivement, l'item suivant et précédent dans la liste de résultats |
Copier la ligne de texte sélectionnée dans le presse-papiers | Copie la colonne de valeur de l'item de résultat sélectionné dans le presse-papiers. Afin de copier toutes les colonnes, activer la commande La copie contient toutes les colonnes (voir ci-dessous) |
Copier tous les messages dans le presse-papiers | Copie la colonne de valeur de tous les items de résultat dans le presse-papiers, y compris des valeurs vides. Chaque item est copié en tant que ligne séparée |
La copie contient toutes les colonnes | Passe entre la copie (i) de toutes les colonnes, ou (ii) uniquement la colonne de valeur. Le séparateur de colonne est un espace unique |
Recherche | Ouvre un dialogue Chercher pour chercher un string, y compris des caractères spéciaux, dans la liste de résultat |
Chercher précédent | Cherche l'occurrence précédente du terme qui a été saisi en dernier dans le dialogue Chercher |
Trouver suivant | Cherche l'occurrence suivante du terme qui a été saisi en dernier dans le dialogue Chercher |
Élargir avec des enfants | Élargit l’item sélectionné et tous ses descendants |
Comprime avec les enfants | Comprime l’item sélectionné et tous ses descendants |
Supprimer | Supprime la liste de résultats |