Points d'arrêt

www.altova.com Imprimer cette rubrique Page précédente Un niveau supérieur Page suivante

Accueil >  Manuel de l'utilisateur et référence > XSLT/XQuery débogueur et profileur > Débogueur XSLT et XQuery >

Points d'arrêt

Le Débogueur XSLT et XQuery vous permet de définir des points d'arrêt dans des documents XSLT, XQuery et XML. Les points d'arrêt sont affichés sous la forme d'une ligne en pointillés rouge (voir la capture d'écran ci-dessous).

 

Note : il est possible de définir un point de trace et un point d'arrêt pour la même instruction. Dans ce cas la ligne apparaîtra en pointillés bleus et rouges (voir capture d'écran).

dbg_breakpoint

Lorsque vous lancez le débogueur pendant une session de débogage, le débogage s'interrompra à chaque point d'arrêt rencontré. Cela vous permet d'identifier des zones spécifiques nécessitant un débogage et de limiter l'attention à ces zones dans les documents XSLT, XQuery et/ou XML. Vous pouvez définir un nombre quelconque de points d'arrêt.

 

Note : Les points d'arrêt définis pour un document restent dans ce document jusqu'à ce qu'il soit fermé. Néanmoins, si vous souhaiter passer au Mode Schéma (par exemple, dans le cas de documents XSD), alors les points d'arrêt seront supprimés, lorsque vous retournez au Mode Texte ou au Mode Grille (depuis le Mode Schéma), il n'y aura pas de point d'arrêt.

 

Les points d'arrêts dans les documents XML

Vous pouvez définir des points d'arrêt sur n'importe quel nœud dans un document XML. L'interruption du traitement aura lieu au début de ce nœud.

 

Les points d'arrêts dans les documents XSLT

Vous pouvez définir des points d'arrêt dans les points suivants dans un document XSLT :

 

Au début des modèles et des instructions de modèle (par ex., xsl:for-each).
Dans une expression XPath (XPath 1.0 ou XPath 2.0).
Dans n'importe quel nœud d'un fragment XML construit littéralement. L'interruption du traitement aura lieu au début de ce nœud.

 

Les points d'arrêts dans les documents XQuery

Vous pouvez définir des points d'arrêt dans les endroits suivants d'un document XQuery :

 

Au début des déclarations XQuery.
Dans une expression XQuery.
Dans n'importe quel nœud d'un fragment XML construit littéralement. L'interruption du traitement aura lieu au début de ce nœud.

 

Insérer/supprimer les points d'arrêt

Pour insérer un point d'arrêt :

 

1.Placer le curseur à un endroit du document où vous souhaitez insérer le point d'arrêt (voir paragraphes ci-dessus). Dans les sessions de débogage XSLT, vous pouvez définir des points d'arrêt dans le Mode Texte et le Mode Grille. Les sessions de débogage XQuery sont uniquement disponibles dans le Mode Texte.
2.Choisir une des méthodes suivantes :

 

Sélectionner XSL/XQuery | Insérer/Supprimer point d'arrêt.
Appuyer sur F9.
Cliquer avec la touche de droite et sélectionner Insérer/Supprimer point d'arrêt.

 

Pour supprimer un point d'arrêt :

 

1.Placer le curseur à un endroit du document contenant le point d'arrêt.
2.Choisir une des méthodes suivantes :

 

Sélectionner XSL/XQuery | Insérer/Supprimer point d'arrêt.
Appuyer sur F9.
Cliquer avec la touche de droite et sélectionner Insérer/Supprimer point d'arrêt.

 

En alternative, vous pouvez utiliser le dialogue Points d'arrêt pour supprimer un point d'arrêt :

 

1.Sélectionner l'option de menu XSL/XQuery | Point d'arrêt....
2.Cliquer sur le point d'arrêt dans la fenêtre de dialogue et cliquer sur Supprimer.

 

La touche Supprimer tout supprime tous les points d'arrêt de la fenêtre de dialogue (et toutes les feuilles de style XSLT).

 

Activer/désactiver les points d'arrêt :

Une fois avoir inséré les points d'arrêt, vous pouvez les désactiver si vous souhaitez passer au-dessus des points d'arrêt sans devoir les supprimer. Vous pourrez les activer à nouveau le cas échéant.

 

Pour désactiver un point d'arrêt :

 

1.Placer le curseur à un endroit du nœud ou de l'expression contenant le point d'arrêt.
2.Sélectionner XSL/XQuery | Activer/désactiver le point d'arrêt (ou appuyer sur Ctrl+F9). Le point d'arrêt passe du rouge au gris, indiquant qu'il a été désactivé.

 

En alternative, vous pouvez utiliser le dialogue Points d'arrêt pour désactiver un point d'arrêt :

 

1.Sélectionner l'option de menu XSL/XQuery | Points d'arrêt/Points de trace.... Le dialogue Points d'arrêt / Points de trace XSLT s'ouvre et affiche les points d'arrêt actuellement définis dans tous les documents de source XML et les feuilles de style XSLT ouverts.

xsl_break2

2.Décocher la case des points d'arrêt que vous souhaitez désactiver et cliquer sur OK pour confirmer. Le point d'arrêt passe du rouge au gris, indiquant qu'il a été désactivé.

 

Pour activer un point d'arrêt :

 

 

1.Placer le curseur à un endroit du nœud ou de l'expression contenant le point d'arrêt.
2.Sélectionner XSL/XQuery | Activer/désactiver le point d'arrêt (ou appuyer sur Ctrl+F9). Le point d'arrêt passe du rouge au gris, indiquant qu'il a été désactivé.

 

Trouver un point d'arrêt spécifique

Pour trouver un point d'arrêt spécifique :

 

1.Sélectionner l'option de menu XSL/XQuery | Points d'arrêt/Points de trace.... Le dialogue Points d'arrêt /Points de trace XSLT apparaît.
2.Cliquer sur le point d'arrêt dans la liste de points d'arrêt.
3.Cliquer sur la touche Éditer code. Le dialogue Points d'arrêt se ferme et le curseur de texte est placé directement devant le point d'arrêt dans le mode Texte. Dans le mode Grille amélioré, la cellule de table contenant le point d'arrêt est marquée en rouge.

 

Reprendre le débogage après un point d'arrêt

Pour continuer le débogage après un point d'arrêt :

 

Sélectionner XSL/XQuery | Pas à pas détaillé ou la commande XSL/XQuery | Démarrer débogueur/OK.

 


© 2018 Altova GmbH