3 — Transformer & exporter — Manuel

Lancer une transformation demande trois choses : une feuille de style, un document d'entrée, un fichier de sortie. Debug XML Tool les devine pour vous démarrer vite, puis vous rend la main dès que vos besoins se précisent.

Ce chapitre couvre le dialogue de configuration, les formats de sortie, les paramètres, les points d'entrée, les sorties multiples et les scénarios enregistrés.

3.1 Deux façons de lancer

Sans rien configurer

Ouvrez votre feuille de style, appuyez sur F5. Debug XML Tool complète ce qui manque :

la feuille de style est celle de l'onglet actif ;
le document XML est le premier trouvé dans le workspace ;
le fichier de sortie est généré à côté du document source.

Chaque décision est tracée en console, préfixée [Auto-config]. C'est fait pour démarrer, pas pour durer : dès que votre workspace contient plusieurs documents, désignez-les.

En désignant les fichiers

Deux moyens, du plus rapide au plus complet :

Clic droit dans l'explorateur → Définir comme XML source ou Définir comme XSL principal. Le message d'état confirme : XML source défini : input.xml.
Le dialogue ⚙ (bouton Paramètres de transformation), qui donne accès à tout.

3.2 Le dialogue ⚙

Le bouton Paramètres de transformation ouvre Configuration de la transformation, en six rangées :

Rangée	Rôle
Fichier XSLT :	la feuille de style à exécuter — bouton Parcourir…
Fichier XML source :	le document d'entrée — Parcourir…
Format de sortie :	Auto, HTML, Texte, XML ou PDF (§3.3)
Fichier de sortie (auto-généré) :	le chemin calculé, affiché pour information
Paramètres XSLT :	table des paramètres transmis à la feuille (§3.4)
Point d'entrée :	par où commencer l'exécution (§3.5)

Le fichier de sortie n'est pas à saisir : il est dérivé du document source, du jour et du format — input.xml traité en HTML donne input_out_2026-08-02.html, à côté de la source. Il est recalculé à chaque changement de format.

La configuration n'est appliquée qu'à la validation du dialogue, et seulement si elle est complète. Le message d'état confirme alors : Configuré : main.xsl + input.xml → HTML.

3.3 Choisir le format de sortie

Format	Extension	Sérialisation	Ouverture du résultat
Auto (xsl:output)	`.html`	celle que votre feuille déclare dans `xsl:output`	onglet en lecture seule
HTML	`.html`	forcée en HTML	onglet en lecture seule
Texte	`.txt`	forcée en texte — aucune balise	onglet en lecture seule
XML	`.xml`	forcée en XML — déclaration comprise	onglet en lecture seule
PDF	`.pdf`	XSL-FO → PDF	lecteur PDF du système

Auto est le défaut et ne s'impose à rien : votre xsl:output fait foi. Les quatre autres priment sur ce que déclare la feuille — c'est le moyen d'obtenir une sortie texte d'une feuille qui produit du HTML, sans la modifier.

Le résultat s'ouvre dans un nouvel onglet en lecture seule. L'onglet est refermé et régénéré à chaque exécution : ce que vous lisez correspond toujours au dernier run.

Exporter en PDF

Le format PDF attend une feuille de style produisant du XSL-FO. Le fichier est écrit sur disque puis ouvert dans votre lecteur PDF habituel ; la console le confirme — [PDF] Ouverture du fichier dans le lecteur par défaut : ….

Votre lecteur PDF garde le fichier ouvert, donc verrouillé. Fermez-le avant de relancer la transformation ou de supprimer le fichier.

3.4 Passer des paramètres à la feuille de style

Une feuille qui déclare <xsl:param name="devise" select="'EUR'"/> peut être pilotée depuis le dialogue ⚙, sans être modifiée.

Ouvrez ⚙, rangée Paramètres XSLT :.
Saisissez le Nom (devise) et la Valeur (USD).
Cliquez + Param : la ligne rejoint la table.
Validez, puis F5.

La sortie reflète la valeur transmise. Tant qu'aucun paramètre n'est défini, la table affiche Aucun paramètre.

Pour retirer un paramètre : sélectionnez sa ligne, cliquez − Param.

Les paramètres sont rechargés à la réouverture du dialogue et s'appliquent aussi bien au lancement ▶ qu'au profileur : vous profilez donc exactement la configuration que vous exécutez.

3.5 Choisir le point d'entrée

Par défaut, une transformation part du document source : Saxon applique les templates au document XML. C'est le cas classique, et le comportement historique.

XSLT 3.0 permet deux autres démarrages, tous deux accessibles à la rangée Point d'entrée : :

Point d'entrée	Ce qui se passe	Document XML
Document source (défaut)	les templates s'appliquent au document	requis
Template initial	l'exécution démarre sur un template nommé	facultatif
Mode initial	l'exécution démarre dans un mode donné	requis

Template initial

Choisissez Template initial et laissez le nom vide : Saxon invoque xsl:initial-template, le nom par défaut. Saisissez un nom pour démarrer sur un autre template.

Aucun document XML n'est nécessaire. Le sélecteur XML devient facultatif et affiche (aucun — template initial) ; le fichier de sortie est alors dérivé du nom de la feuille de style. C'est le mode des feuilles qui génèrent leur contenu sans entrée — génération de code, jeux de données, rapports paramétrés.

Mode initial

Choisissez Mode initial et saisissez le nom du mode : l'exécution démarre dans ce mode plutôt que dans le mode par défaut.

Le nom est obligatoire. Si vous le laissez vide, le message d'état vous le dit — Erreur : un nom de mode est requis pour le mode initial — et votre configuration précédente est conservée. Le dialogue ne valide qu'une configuration exploitable ; il n'efface jamais la vôtre au passage.

Rien d'autre ne change

Le débogueur, le profileur, le back-mapping et les sorties multiples fonctionnent à l'identique quel que soit le point d'entrée. Un point d'arrêt posé dans un template initial est atteint comme n'importe quel autre, et la pile d'appels affiche ce template comme frame racine.

Si vous nommez un template qui n'existe pas, l'erreur du moteur est relayée en console et l'application revient à l'état IDLE — sans planter.

3.6 Feuilles produisant plusieurs fichiers

Les feuilles de style qui utilisent xsl:result-document sont pleinement prises en charge.

Chaque sortie secondaire est :

écrite sur disque, son chemin relatif résolu à côté de la sortie principale — un href="pages/3.html" crée bien le dossier pages/ ;
annoncée en console — [xsl:result-document] Sortie secondaire générée : …, une ligne par fichier ;
visible dans l'explorateur, sans rafraîchissement manuel ;
exploitable comme la sortie principale : ouvrez-la depuis l'explorateur, le Ctrl+clic y remonte à l'instruction XSLT génératrice et au nœud source (chapitre Analyser).

Un point d'arrêt posé dans un xsl:result-document est atteint normalement.

Un fichier secondaire déjà ouvert dans un onglet est refermé quand vous régénérez : vous ne lisez jamais une version périmée.

Le profileur, lui, n'écrit aucune de ces sorties : profiler une feuille ne produit aucun effet de bord sur vos fichiers.

3.7 Enregistrer une configuration : les scénarios

Un scénario est une configuration complète — feuille de style, document, format, paramètres, point d'entrée — enregistrée sous un nom et relancée en un clic. C'est ce qui remplace le « reconfigurer le ⚙ à chaque fois » quand vous alternez entre plusieurs chaînes de production.

Créer

Cliquez Scénarios de transformation dans la barre d'outils.
+ Nouveau.
Renseignez Nom : (par exemple Catalogue → PDF Production), XSL :, XML :, Format :, et si besoin les Paramètres XSLT et le Point d'entrée.
💾 Sauvegarder — le dialogue se referme.

Le nom est obligatoire, ainsi que les fichiers XSL et XML ; l'application vous le signale plutôt que d'enregistrer un scénario inexploitable.

Exécuter

Rouvrez Scénarios de transformation, sélectionnez le scénario dans Scénarios sauvegardés — les champs se repeuplent — puis ▶ Exécuter. La transformation part immédiatement, et la console l'annonce : --- Lancement depuis scénario "…" ---.

Comparer à une référence

Le champ Sortie de référence : est facultatif. Renseignez-le, et le bouton Exécuter et comparer lance la transformation puis compare le résultat au fichier de référence. C'est le moyen le plus court de vérifier qu'une modification de feuille de style n'a rien cassé — la comparaison est détaillée au chapitre Valider & comparer §7.6.

Supprimer

Sélectionnez le scénario, cliquez 🗑 Suppr, confirmez.

Persistance

Les scénarios sont enregistrés dans le workspace et restaurés au démarrage suivant. Deux projets ont donc chacun les leurs.

Si vous créez un scénario sans workspace ouvert, la console vous prévient qu'il sera enregistré dans votre dossier personnel plutôt que dans un projet.

3.8 Lire la console

Une exécution nominale laisse une trace complète :

--- Lancement de la transformation ---
XML : C:\...\input.xml
XSLT : C:\...\main.xsl
Sortie : C:\...\input_out_2026-08-02.html (format: AUTO)
[HTML] Sortie générée : C:\...\input_out_2026-08-02.html
--- Transformation terminee en 136 ms ---

S'y intercalent vos xsl:message, ligne à ligne, dans l'ordre où le moteur les produit.

Les erreurs de configuration — pas de feuille désignée, aucun XML dans le workspace, fichier introuvable — ne passent pas par la console : elles s'affichent dans le message d'état de la barre d'outils. Réflexe utile : rien ne se lance ⇒ lisez la barre d'outils, pas la console.

3.9 Limites à connaître

Le moteur est Saxon-HE. Les transformations schema-aware et le streaming des éditions Professional et Enterprise ne sont pas disponibles.
Le back-mapping n'est pas disponible sur l'export PDF. Il fonctionne sur les sorties HTML, XML et Texte (chapitre Analyser).
Le format PDF suppose une feuille produisant du XSL-FO. Il ne convertit pas un HTML en PDF.
Le chemin de sortie est calculé, pas choisi : il est dérivé du document source (ou de la feuille de style en l'absence de source), de la date et du format.

Et ensuite

Déboguer — arrêter la transformation et regarder ce qu'elle fait.
Analyser — profileur, couverture des templates, back-mapping de la sortie.
Valider & comparer — comparer une sortie à sa référence, valider un dossier entier, exécuter des tests XSpec.