<oXygen/> User Guide |
Cette section explique le travail avec la perspective Debugger.
Oxygen propose deux perspective, Éditeur et Debugger. Oxygen se lance par défaut avec la perspective Éditeur. On peut facilement passer de la perspective Éditeur à la perspective Debugger à tout moment durant une session de travail même lorsqu'aucun fichier n'a été ouvert. Pour lancer la perspective Debugger cliquez sur le
bouton .Contrairement à la perspective Éditeur, la perspective Debugger nécessite qu'au moins un document (XML) et une feuille de style (XSL) soient ouverts avant de pouvoir utiliser les fonctions de débogage. Ces fichiers peuvent être ouverts en étant dans la perspective Éditeur, avant de passer à la perspective Debugger, ou directement depuis la perspective Debugger. Ceci permet l'ouverture et la fermeture des deux types de fichier à toute étape dans une session de travail. Revenez à la perspective Éditeur en cliquant sur le bouton Éditeur
.En passant de la perspective Éditeur à la perspective Debugger, les fichiers déjà ouverts sont classés par extension dans les panneaux Vue du document source (XML) et Vue du document feuille de style (XSL).
Le débogage ci-dessous (voir Débogage typique), suppose que Oxygen est déjà en perspective Debugger avec au moins un document (XML) et une feuille de style (XSL) ouverts. Ce nombre de documents est minimal pour utiliser le débogage. Pour débuter avec le débogage XSLT quelques exemples sont offerts. Ils peuvent être trouvés dans le répertoire samples/debugger de votre installation de Oxygen.
Pendant qu'un débogage est en cours, il est conseillé de stopper l'exécution avant d'essayer d'éditer les documents source ou les feuilles de style. Éditer durant un débogage va afficher des informations inexactes dans Vue Information. L'exécution doit aussi être stoppée pour passer à la perspective Éditeur.
Durant l'exécution, la transformation est en cours, et par conséquent à chaque fois que le moteur de transformation atteint un nœud d'un fichier non encore ouvert, ce fichier sera ouvert dans son panneau respectif et le nœud sera surligné. Cela apparaît le plus souvent dans le cas de fichiers importés/inclus d'entités XML ou XSL.
Si des erreurs sont rencontrées durant le débogage, elles sont rapportées sur le panneau des résultats de Oxygen.
À la fin du débogage, seul le contenu des vues suivantes est préservé (toutes les autres vues sont effacées) :
Procédure 6.1. Débogage typique
À partir de Vue du document source (XML) sélectionnez un document source.
À partir de Vue du document feuille de style (XSL) sélectionnez un document feuille de style.
À partir de Barre d'outils du contrôle utilisez le contrôle Sélecteur de source XML pour sélectionner un document source.
À partir de Barre d'outils du contrôle utilisez le contrôle Sélecteur de feuille de style XSL pour sélectionner une feuille de style.
À partir de Barre d'outils du contrôle utilisez le contrôle Sélecteur de moteur XSLT pour sélectionner un des moteurs de traitement disponibles.
Configurez le Paramètres XSLT. Une fois réglés, ces paramètres sont préservés entre les sessions de débogage.
Lancez le débogage en utilisant les boutons de contrôle actifs (voir Vue de Contrôle pour une description des fonctions de contrôle).
Des informations détaillées sur le statut du débugger sont offertes en utilisant les vues.
Le nœud contextuel est un nœud source correspondant à l'expression XSL actuellement évaluée. Il est aussi appelé le contexte d'exécution. Le nœud contextuel change implicitement lorsque le processeur passe différentes étapes (au point où les expressions XPath sont évaluées). Ce nœud a la même valeur que l'évaluation de l'expression XPath '.' (dot) sur Vue XPath.
Affiche les expressions XPath à évaluer durant le débogage. Les expressions sont évaluées dynamiquement lorsque le processeur change le contexte de sa source.
Tableau 6.2. Détails XWatch
Colonne | Description |
---|---|
Expression | Expression XPath à évaluer (devrait être compatible XPath 1.0). |
Valeur | Résultat de l'évaluation de l'expression XPath. La valeur a un type (voir Valeurs possibles dans la section Vue des variables). Pour un Ensemble de nœuds le nombre de nœuds dans l'ensemble est affiché entre parenthèses. |
![]() | Remarques |
---|---|
|
Liste tous les ensembles de breakpoints sur les documents. Une fois que vous avez mis un breakpoint vous avez une ligne pour celui-ci dans cette liste. Les breakpoints peuvent être mis à la fois sur les documents XML et XSL.
Tableau 6.3. Détails des Breakpoints
Colonne | Description |
---|---|
Ressource | Le fichier ressource où le breakpoint se trouve. Le chemin complet du fichier ressource est disponible comme aide. |
Ligne | Numéro de ligne à lintérieur du ressource où se trouve le breakpoint. |
Les instructions <xsl:message> sont une façon de signaler des situations spéciales rencontrées durant la transformation ainsi qu'une manière basique de faire le débogage. Cette vue montre tous les appels <xsl:message> exécutés par le processeur XSLT durant la transformation.
Tableau 6.4. Détails des Messages
Colonne | Description |
---|---|
Message | Contenu du Message. |
Fin | Signale si le processeur va terminer la transformation ou non du moment qu'il le rencontre(respectivement vrai/faux) |
Ressource | Fichier ressource où l'instruction <xsl:message> est définie. Le chemin complet du ressource est disponible comme aide. |
![]() | Remarques |
---|---|
|
Affiche la pile d'exécution actuelle à la fois des nœuds de la source et du style. Durant la transformation deux piles sont gérées : une de nœuds du source étant traitée et l'autre pour les nœuds de feuilles de style étant traitée. Oxygen affiche les deux types de nœuds dans une pile commune. Les nœuds du source (XML) sont précédés par un icône de couleur rouge tandis que les nœuds de feuilles de style sont précédés par un icône de couleur verte. L'avantage de cette approche est que vous pouvez toujours voir l'étendue du source sur laquelle une instruction de feuille de style est exécutée (le dernier nœud de couleur rouge sur la pile). La pile est orientée de bas en haut.
Tableau 6.5. Détails de la pile
Colonne | Description |
---|---|
# | Numéro d'ordre, représente la profondeur du nœud (0 est la base de la pile). |
Nœud XML/XSL | Nœud du source ou d'un document feuille de style actuellement traité. Un nœud particulier de la pile est la racine du document, notée comme document #. |
Attributs | Attributs du nœud (liste des paires id="valeur"). |
Ressource | Fichier ressource où le nœud est situé. Le chemin complet est disponible comme aide. |
![]() | Remarques |
---|---|
|
Habituellement les processeurs XSLT signalent les événements suivants durant la transformation :
entrée dans un nœud source (XML).
sortie d'un nœud source (XML).
entrée dans un nœud de feuille de style (XSL).
sortie d'un nœud de feuille de style (XSL).
L'historique de la trace saisit tous ces événements, vous pouvez ainsi voir comment le traitement a évolué. Les lignes d'icônes rouges montrent les nœuds de source tandis que les icônes verts montrent les nœuds de feuilles de style.
Tableau 6.6. Détails de la trace de l'historique
Colonne | Description |
---|---|
Profondeur | Débute à 0 et représente le niveau d'imbrication de ce nœud. Cela est similaire au numéro d'ordre # de la pile au moment où le nœud a été traité. |
Nœud XML/XSL | Représente le nœud du document source ou feuille de style traité. Un nœud particulier est la racine du document, notée comme document #. Chaque nœud a une flèche en face de lui représentant quelle action a été exécutée dessus (entrée ou sortie). |
Attributs | Attributs du nœud (liste de paires id="valeur"). |
Ressource | Fichier ressource où le nœud est situé. Le chemin complet du fichier ressource est donné ici comme aide. |
![]() | Remarques |
---|---|
|
<xsl:template> est l'élément de base pour la transformation de feuilles de style. Cette vue affiche toutes les instructions <xsl:template> utilisées par la transformation. En voyant le nombre de hits pour chaque modèle vous pouvez avoir une idée de la couverture de la feuille de style par règles de modèle concernant la source en entrée.
Tableau 6.7. Détails des modèles
Colonne | Description |
---|---|
Correspond | Correspond à l'attribut du <xsl:template>. |
Hits | Nombre de hits pour le <xsl:template>. Affiche combien de fois le processeur XSLT a utilisé ce modèle particulier. |
Priorité | Priorité de modèle comme établi par le processeur XSLT. |
Mode | Attribut de mode du <xsl:template>. |
Nom | Nom de l'attribut du <xsl:template>. |
Ressource | Fichier ressource où le modèle est situé. Le chemin complet du fichier ressource est disponible comme aide. |
![]() | Remarques |
---|---|
|
Cette vue est toujours utilisée en relation avec les vues Vue des variables et Vue XPath et affiche une valeur d'un ensemble de nœuds. Une fois que vous cliquez sur une variable ayant comme valeur un ensemble de nœuds ou un fragment d'arbre ou une expression XPath évaluée pour un ensemble de nœuds dans les vues ci-dessus, la vue ensemble de nœuds est actualisée avec les valeurs respectives.
Tableau 6.8. Détails de l'ensemble de nœuds
Colonne | Description |
---|---|
Nom | Nom du nœud source (XML). |
Attributs/Valeur | Contenu(Valeur) des attributs ou du texte du nœud XML. Si des attributs existent, ils sont affichés sous la forme attributNom="attributeValeur", sinon le contenu textuel du nœud est affiché. |
![]() | Remarques |
---|---|
|
Durant la transformation les variables et les paramètres jouent un rôle important.
Oxygen utilise les icônes suivants pour différencier les variables/paramètres :
Variable globale.
Variable locale.
Paramètre global.
Paramètre local.
Les types de valeurs d'une variable sont marqués par des icônes expliqués ci-dessous :
Tableau 6.9. Détails des variables
Colonne | Description |
---|---|
Nom | Nom de la variable/du paramètre. |
Valeur | Valeur actuelle de la variable/du paramètre. |
![]() | Remarques |
---|---|
|