Professional Documents
Culture Documents
Des composants logiciels de tierces parties sont distribués dans le paquet d'installation de oXygen, dont le Java Runtime
Environment (JRE), la DTD DocBook et les feuilles de style. Ce produit inclut des logiciels développés par la Apache Software
Foundation (http://www.apache.org) : Apache FOP, la moulinette XML Xerces et XSLT Xalan. Ces produits ne sont pas la
propriété de SyncRO Soft Ltd. À la connaissance de SyncRO Soft Ltd. les détenteurs des produits cités ont donné leur permission
pour copier, distribuer et/ou modifier les logiciels et leurs documents sous les termes de l'Apache Software License, Version 1.1.
D'autres paquets sont utilisés sous la GNU Lesser General Public License. Les utilisateurs sont prévenus que le JRE est livré
comme logiciel libre, mais en accord avec la licence de Sun Microsystems. Les utilisateurs sont prévenus que SyncRO Soft Ltd.
n'assume aucune responsabilité pour les erreurs ou les omissions, ou pour les dommages résultants de l'utilisation de oXygen et
des logiciels de tierces parties cités ci-dessus. SyncRO Soft Ltd. n'assume non plus aucune responsabilité pour les licences des
logiciels cités auparavants, si les revendeurs changent les termes de leurs licences. En utilisant oXygen l'utilisateur accepte la
responsabilité de conserver toute licence requise par SyncRO Soft Ltd. ou des tierces parties. À moins que SyncRO Soft Ltd.
déclare par écrit que la licence oXygen comprend les licences des logiciels de tierces parties.
Table des matières
1. Introduction ............................................................................................................ 1
Fonctions clés ..................................................................................................... 1
À propos du manuel <oXygen/> ............................................................................ 2
2. Installation ............................................................................................................. 3
Configuration nécessaire ...................................................................................... 3
Plateforme nécessaire ................................................................................... 3
Système d'exploitation, outils et environnement nécessaires ................................ 3
Instructions pour l'installation ................................................................................ 4
Lancer le module d'extension <oXygen/> ................................................................ 4
Obtenir et installer une licence <oXygen/> ............................................................... 4
Mettre à jour <oXygen/> ...................................................................................... 6
Désinstaller le module d'extension <oXygen/> .......................................................... 6
3. Débuter .................................................................................................................. 7
Préférences ........................................................................................................ 7
Général ..................................................................................................... 7
Éditeur ...................................................................................................... 8
Catalogue XML ........................................................................................ 13
Caractéristiques de la moulinette XML .......................................................... 14
Options de XSLT ...................................................................................... 15
Réglages Debugger ................................................................................... 16
Processeurs FO ......................................................................................... 17
Configuration du proxy .............................................................................. 20
Couleurs .................................................................................................. 21
Assistant de plugin <oXygen/> ............................................................................ 22
Le menu personnalisé <oXygen/> ........................................................................ 28
Menu XML .............................................................................................. 29
Menu XML Tools ..................................................................................... 30
Les boutons de la barre d'outils de <oXygen/> ........................................................ 30
Le panneau Éditeur ............................................................................................ 32
Panneau Contour ............................................................................................... 33
Vue d'ensemble du document XML .............................................................. 34
Suivi de modification ................................................................................. 34
Sélection de balise du document ................................................................... 34
La vue texte de <oXygen/> ................................................................................. 34
La vue XPath de <oXygen/> ............................................................................... 35
4. Transformer des documents ..................................................................................... 36
Scénarios de transformation ................................................................................ 38
Créer un scénario ...................................................................................... 41
Le scénario par défaut ................................................................................ 41
Importer/Exporter des scénarios de transformation .......................................... 41
Exemples de scénarios de transformation ............................................................... 42
Sortie PDF ............................................................................................... 42
Sortie PS ................................................................................................. 43
Sortie TXT .............................................................................................. 43
Sortie HTML ........................................................................................... 44
Sortie HTML Help .................................................................................... 44
Sortie JavaHelp ........................................................................................ 45
Rendu XHTML ........................................................................................ 45
5. Debugger XSLT .................................................................................................... 46
Contour ........................................................................................................... 46
Agencement ..................................................................................................... 46
Vue du document source (XML) .................................................................. 47
Vue du document feuille de style (XSL) ........................................................ 47
iv
Vue du document de sortie .......................................................................... 47
Vue de Contrôle ........................................................................................ 47
Travailler avec le Debugger ................................................................................ 50
Débuter ................................................................................................... 50
Le débogage ............................................................................................. 50
Sortie vers le mapping de source .................................................................. 51
Comprendre les vues des informations .......................................................... 52
6. Support WSDL ...................................................................................................... 63
Vue d'ensemble du Web Services Description Language ........................................... 63
Éditer des fichiers WSDL ........................................................................... 63
Valider des fichiers WSDL ......................................................................... 64
Analyser et tester des fichiers WSDL ............................................................ 64
7. Support XQuery .................................................................................................... 67
Vue d'ensemble de XQuery ................................................................................. 67
Colorisation de syntaxe et complétion de syntaxe ............................................ 67
Validation XQuery .................................................................................... 68
Transformer des documents XML avec XQuery .............................................. 68
v
Liste des illustrations
2.1. Dialogue d'enregistrement ....................................................................................... 5
3.1. Les préférences générales ....................................................................................... 7
3.2. Le panneau Aspect ................................................................................................ 8
3.3. Le panneau Formatage ........................................................................................... 9
3.4. Le panneau Propriétés de Tag Insight ...................................................................... 10
3.5. Le panneau Défaut Tag Insight .............................................................................. 12
3.6. Le panneau XSL de Tag Insight ............................................................................. 13
3.7. Le panneau XML Catalog ..................................................................................... 13
3.8. Le panneau Options Parseur XML .......................................................................... 15
3.9. Option du transformateur XSLT JAXP .................................................................... 15
3.10. Réglages Debugger ............................................................................................ 16
3.11. Le panneau processeur FO ................................................................................... 17
3.12. Configurer les processeurs externes ....................................................................... 19
3.13. Le dialogue de configuration du proxy ................................................................... 20
3.14. Le panneau Couleurs .......................................................................................... 21
3.15. Créer un document XML - Onglet schéma XML ..................................................... 23
3.16. Créer un document XML - Onglet DTD ................................................................. 23
3.17. Créer un document XML - Onglet Relax NG .......................................................... 25
3.18. Créer un document XML - Onglet NRL ................................................................. 25
3.19. Importer HTML ................................................................................................ 27
3.20. Le dialogue Modèles .......................................................................................... 27
3.21. Les boutons de la barre d'outils de <oXygen/> ......................................................... 30
3.22. Le panneau Éditeur ............................................................................................ 32
3.23. Le panneau Contour ........................................................................................... 33
3.24. La vue texte de <oXygen/> .................................................................................. 34
3.25. La vue XPath de <oXygen/> ................................................................................ 35
4.1. Le dialogue Configuration de la transformation ......................................................... 38
4.2. Dialogue Édition de cascade de feuilles de style ........................................................ 40
5.1. Interface du mode Debugger .................................................................................. 47
5.2. Barre d'outils du contrôle ...................................................................................... 48
5.3. Sortie vers mapping de source ............................................................................... 52
5.4. La vue nœud contextuel ........................................................................................ 52
5.5. La vue XPath ...................................................................................................... 53
5.6. La vue Breakpoints .............................................................................................. 54
5.7. La vue des Messages ............................................................................................ 55
5.8. La vue de la pile .................................................................................................. 56
5.9. La vue de l'historique de la trace ............................................................................ 57
5.10. La vue des modèles ............................................................................................ 58
5.11. La vue ensemble de nœuds .................................................................................. 59
5.12. La vue des variables ........................................................................................... 61
6.1. Tag insight pour WSDL ........................................................................................ 63
6.2. Valider un fichier WSDL ...................................................................................... 64
6.3. Analyseur WSDL ................................................................................................ 64
7.1. Tag Insight Query ............................................................................................... 67
7.2. Validation XQuery .............................................................................................. 68
7.3. Transformation XQuery ........................................................................................ 69
vi
Liste des tableaux
3.1. Options du menu XML ......................................................................................... 29
3.2. Options du menu XML Tools ................................................................................ 30
3.3. Description des boutons de la barre d'outils de <oXygen/> .......................................... 31
3.4. Description des types de l'éditeur <oXygen/> ........................................................... 32
5.1. Détails nœud contextuel ....................................................................................... 53
5.2. Détails XWatch .................................................................................................. 54
5.3. Détails des Breakpoints ........................................................................................ 55
5.4. Détails des Messages ........................................................................................... 56
5.5. Détails de la pile ................................................................................................. 56
5.6. Détails de la trace de l'historique ............................................................................ 58
5.7. Détails des modèles ............................................................................................. 59
5.8. Détails de l'ensemble de nœuds .............................................................................. 60
5.9. Détails des variables ............................................................................................ 61
vii
Chapitre 1. Introduction
Bienvenue au manuel de l'utilisateur de l'éditeur XML <oXygen/>. Ce chapitre donne un aperçu des
caractéristiques et bénéfices de <oXygen/> ainsi que l'organisation de ce livre.
L'éditeur XML <oXygen/> est une application multi-plateformes pour le développement de document
en utilisant des langages de formatage tels que XML, XSD, XSL, DTD.
<oXygen/> offre aux développeurs et aux auteurs un puissant environnement intégré de développement.
Basé sur une technologie Java éprouvée, l'interface graphique utilisateur de l'éditeur XML <oXygen/>
est facile à utiliser et offre des fonctionnalités robustes pour l'édition, la gestion de projet et la validation
de sources structurées. Couplé avec les technologies de transformation XSLT et FOP, <oXygen/>
supporte la sortie vers de multiples formats cibles, dont : PDF, PS, TXT, HTML et XML.
<oXygen/> est l'éditeur XML de choix pour les développeurs, les auteurs et les intégrateurs qui
demandent une sortie de haute qualité avec un environnement flexible et robuste, une source unique, et
un formatage structuré.
Fonctions clés
L'éditeur XML <oXygen/> offre les fonctions clés suivantes.
1
Introduction
• Chapitre 3, Débuter : Débuter avec l'interface de <oXygen/> - donne une orientation générale,
explique les concepts et définit les fonctionnalités des composants de l'interface graphique utilisateur
(GUI) de <oXygen/> .
• Chapitre 5, Debugger XSLT : débogueur XSLT - Ce chapitre explique les fonctionnalités des modes
du débogueur, qui offre un riche ensemble de fonctions pour le développement, le test, et la
résolution de problèmes XSL.
• Chapitre 6, Support WSDL : support WSDL - ce chapitre explique les facilités offertes par
<oXygen/> pour le support WSDL.
• Chapitre 7, Support XQuery : support XQuery - ce chapitre explique le support offert par <oXygen/>
pour l'édition, la validation et l'exécution d'expressions XQuery.
2
Chapitre 2. Installation
Cette section explique la configuration requise et la procédure d'installation. Elle donne aussi les
instructions pour savoir comment obtenir et appliquer une licence <oXygen/>, comment procéder aux
mises à jour et désinstaller <oXygen/> si nécessaire.
Si vous avez besoin d'aide à n'importe quel moment durant ces procédures veuillez envoyer un courriel à
<support@oxygenxml.com>.
Attention
Si vous souhaitez exécuter <oXygen/> avec Java WebStart directement depuis la page
<oXygen/> Java WebStart page [http://www.oxygenxml.com/javawebstart/] ou depuis votre
serveur intranet, veuillez configurer votre Java WebStart afin qu'il ne demande pas d'intégration
au bureau (Fichier -> Préférences, Raccourcis), sinon un dialogue va s'afficher au même
moment que le dialogue d'enregistrement de licence de <oXygen/>, amenant ainsi à une
situation de blocage.
Configuration nécessaire
Plateforme nécessaire
Le run-time minimum nécessaire est indiqué ci-dessous.
• Plateforme Pentium
• 128 Mo de RAM
Outils
Les packages d'installation sont fournis en tant qu'archives compressées. Assurez-vous que vous avez
installé un outil d'extraction correspondant avec lequel extraire l'archive.
Environnement pré-requis
3
Installation
Avant l'installation, assurez-vous que votre plate-forme Eclipse installée est au moins :
1. Start Eclipse. Choose the menu option: Help / Software Update / Find and Install. Select the
checkbox: "Search for new features to install" and press the "Next" button..
2. From the dialog "Update sites to visit" press the button "Add update site" or "New Remote Site".
3. Enter "oXygen XML Editor" in the "Name" field and the value
http://www.oxygenxml.com/InstData/Eclipse/site.xml into the "URL" field of the "New Update
Site" dialog. Press the "OK" button.
4. Select the checkbox "oXygen XML Editor" and press the "Next" button.
5. Select the new feature to install "oXygen XML Editor and XSLT debugger" and press the "Next"
button in the following install pages. You must accept the Eclipse restart.
6. Coller l'information de licence pour <oXygen/> reçu dans le courriel d'enregistrement lorsque cela
est demandé. Cela va se produire lorsque vous utilisez un des assistants de <oXygen/> pour créer
un projet ou un document XML, quand vous ouvrez ou créez un document associé à <oXygen/> ou
en accédant aux Préférences de <oXygen/>.
7. Le module d'extension de <oXygen/> est installé correctement si vous pouvez créer un projet XML
avec un assistant <oXygen/> : Fichier->Nouveau (Ctrl+N) -> <oXygen/> - Projet XML.
Pour des besoins de démonstration et d'évaluation une licence limitée dans le temps est disponible à la
demande depuis le site web de oXygen [http://www.oxygenxml.com]. Cette licence est offerte
gratuitement pour une période de 30 jours à partir de la date de délivrance. Durant cette période
<oXygen/> est totalement fonctionnel et vous permet de tester tous les aspects de l'application. Après,
4
Installation
l'application est désactivée et une licence permanente doit être achetée afin d'utiliser l'application. Pour
des circonstances spéciales, si une période d'essai de plus de 30 jours est nécessaire, veuillez contacter
<support@oxygenxml.com>. Toutes les licences sont obtenues depuis le site web de <oXygen/>
[http://www.oxygenxml.com].
Une fois que vous avez obtenu une licence la procédure d'installation est la suivante :
1. Faites une copie de sauvegarde du nouveau fichier licence dans un endroit sûr.
4. Si c'est une nouvelle installation de l'éditeur, alors un dialogue d'enregistrement sera affiché lors du
lancement. Au cas où vous utilisiez déjà l'éditeur et aviez déjà obtenu une nouvelle licence, utilisez
l'option Aide/Enregistrement du menu pour faire apparaître le dialogue d'enregistrement.
5
Installation
Cette section détaille la procédure pour mettre à jour <oXygen/> tout en préservant les réglages de la
configuration personnelle.
4. Start the <oXygen/> plugin to ensure that the application can start and that your license is
recognized by the upgrade installation.
5. If you are upgrading to a major version, for example from 4.2 to 5.0, then you will need to enter the
new license text into the registration dialog that is shown when the application starts.
6. Select Window->Preferences -> Plug-In Development -> Target Platform and next to the
com.oxygenxml.editor list entry you should see the version number of the newest installed plugin. If
the previous version was 4.2.0, the list entry should now contain 5.0.0.
1. Choose the menu option: Help / Software Update / Manage Configuration and from the list of
products select <oXygen/> XML Editor and XSLT Debugger.
2. From the right section of the displayed window choose Uninstall and accept the Eclipse restart after
the uninstall procedure is complete.
6
Chapitre 3. Débuter
Cette section offre un aperçu de l'interface graphique utilisateur (GUI) de <oXygen/>. Une explication
de chaque composant de l'interface et une courte description de son but ou son usage sont données.
La GUI du module d'extension <oXygen/> est intégrée dans la plate-forme Eclipse par les composants
suivants :
• Le panneau de l'éditeur
• La vue contour
Préférences
Une fois que <oXygen/> est installé vous pouvez utiliser les préférences suivantes pour personnaliser
<oXygen/> selon vos besoins et votre environnement réseau.
Général
Navigateur internet par défaut Le chemin de l'exécutable d'un navigateur internet à utiliser pour
ouvrir les résultats des transformations XSLT ou PDF.
7
Débuter
Éditeur
Utilisez ces options pour configurer l'aspect visuel, les paramètres de formatagee et le comportement de
l'assistant de contenu.
Aspect
Changer les polices Utilisez cette option pour sélectionner la la famille et la taille de
la police utilisée pour afficher le texte dans l'éditeur.
Couleur de fond de l'éditeur Utilisez cette option pour régler la couleur de fond de l'éditeur.
Saut de ligne Cette option va automatiquement faire de sauts de ligne dans les
documents édités.
Surligner la balise correspondante Cette option active le surlignage pour les balises correspondant à
celle où se trouve le curseur.
Formatage
8
Débuter
Indenter avec tabulation Si coché active 'Indenter avec tabulation' pour régler l'indentation
à une unité de tabulation. Si la case n'est pas cochée, 'Indenter
avec tabulation' est désactivé et l'indentation sera du nombre
d'espaces définis par l'option 'Largeur d'une indentation'.
Augmenter les éléments vides Si coché, l'opération Format et indenter va représenter les
éléments vides avec une balise de fermeture séparée, par ex. <a
atr1="v1"></a>. Si non-coché, la même opération va représenter
un élément vide dans une forme plus compacte : <a atr1="v1"/>
9
Débuter
Longueur de ligne - pretty print Définit le point auquel la fonction "Formater et indenter"
(Pretty-Print) va exécuter le saut de ligne. Si réglé à 100, Pretty-
Print va faire un saut de ligne au 100ème espace, espaces vierges,
balises, et éléments inclus.
Préserver les éléments d'espace Cette liste contient les noms des éléments pour lesquels les
espaces blancs contenus comme les blancs, tabulations et lignes
vierges sont préservés par l'opération Formater et indenter
exactement comme avant l'application de l'opération.
Éliminer les éléments d'espace Cette liste contient les noms des éléments pour lesquels les
espaces blancs contigus comme les blancs, tabulations et lignes
vierges sont fusionnés par l'opération Formater et indenter en un
seul blanc.
Tag-Insight
La fonction Tag-insight permet la recherche en ligne de syntaxe et l'auto-remplissage d'éléments et
d'attributs de formatage pour rationnaliser le formatage et réduire les erreurs lors de l'édition.
Propriétés
Ces réglages définissent le mode opératoire de l'assistant de contenu.
10
Débuter
Utilisation Tag-insight Cette option active le Tag-insight. Si la case n'est pas cochée,
toutes les fonctionnalités Tag-insight sont désactivées.
Fermer l'élément inséré Lors de l'insertion d'éléments depuis l'assistant Tag-insight, les
balises de début et de fin sont toutes deux insérées.
Insérer les attributs obligatoires Si coché, <oXygen/> va automatiquement insérer les attributs
requis depuis la DTD ou le schéma XML pour un élément inséré
avec l'aide de l'assistant Tag-Insight.
Insérer les attributs fixés Si coché, <oXygen/> va automatiquement insérer n'importe quels
attributs FIXÉS de la DTD ou du Schema XML pour un élément
inséré à l'aide de l'assistant Tag-Insight.
11
Débuter
Montrer toutes les entités Si coché, <oXygen/> va afficher une liste avec toutes les entités
internes et externes déclarées dans le document actuel quand
l'utilisateur tape le caractère de début d'une entité (c.-à-d. &).
Position du curseur entre les balises Si coché, <oXygen/> va mettre le curseur automatiquement entre
les balises même si les éléments auto-insérés ont des attributs qui
ne sont pas requis. La position du curseur peut être forcée entre
les balises.
Utiliser les commentaires de la Si coché, <oXygen/> va utiliser tous les commentaires de DTD
DTD comme annotation comme annotation.
Apprendre les valeurs des attributs Si coché, <oXygen/> va afficher une liste avec toutes les valeurs
des attributs apprises depuis le document actuel.
Défaut
L'URL du DTD / XML Schéma à utiliser lorsque aucune grammaire n'est spécifiée dans le document
édité.
DTD Utilisé pour spécifier le chemin complet du fichier DTD qui sera utilisé pour initialiser
l'assistant Tag-insight quand un document ne définit pas une DTD, un Schema XML
ou un Relax NG Schema.
Schema XML Utilisé pour spécifier le chemin complet du fichier Schema XML qui sera utilisé pour
initialiser l'assistant Tag-insight quand un document ne définit pas une DTD, un
Schema XML, un Relax NG Schema ou un NRL Schema.
XSL
Ces réglages définissent quels éléments sont suggérés par l'assistant de contenu en plus de ceux de la
XSL.
12
Débuter
XHTML transitional Inclut les éléments XHTML Transitional comme substitut pour
xsl:element.
Formating objects Inclut des éléments Formating Objects comme substitut pour xsl:element.
Autre Inclut des éléments d'un fichier DTD ou Schema XML spécifié depuis une
URL comme substitut pour xsl:element.
Catalogue XML
Un catalogue XML est un ensemble de correspondances entre fichiers DTD et/ou XML Schéma et/ou
Relax NG et des copies locales de ces fichiers. Si l'accès à internet n'est pas disponible ou est lent, un ou
plusieurs catalogues XML peuvent être ajoutés à la liste dans le dialogue ci-dessous et les copies locales
des fichiers DTD et/ou XML Schéma et/ou Relax NG seront utilisées durant la validation. Quand vous
ajoutez ou effacez un catalogue XML à la liste des catalogues XML dans le panneau Options ->
Préférences -> XML Catalog vous devez relancer l'application pour que les changements prennent effet.
13
Débuter
Si l'option "Utiliser catalogue par défaut" est cochée, <oXygen/> va utiliser les catalogues par défaut
pour les documents DocBook, TEI et XHTML situés dans le sous-répertoire frameworks du répertoire
d'installation. Sinon, <oXygen/> utilisera les catalogues spécifiés dans la liste.
L'option Préférer est utilisée pour spécifier si <oXygen/> va essayer de résoudre d'abord la référence
PUBLIC ou SYSTEM en utilisant les catalogues XML spécifiés. Si une référence PUBLIC n'est pas
référencée dans aucun des catalogues alors une référence SYSTEM est cherchée.
Le niveau de verbosité spécifie les types de messages de sortie affichés en standard qui peuvent avoir
une de ces valeurs : debug, warn, info, erreur et fatal.
14
Débuter
Valider selon un schéma XML même si une DTD est spécifiée - Cette option force la validation selon un
schéma XML référé même si le document inclut une déclaration de DTD.
Activer le traitement XInclude - si coché, le support XInclude dans <oXygen/> est activé.
Options de XSLT
15
Débuter
Si vous souhaitez utiliser un autre transformateur XSLT que celui livré avec <oXygen/> c.-à-d. Apache
Xalan et Saxon, il vous suffit de spécifier le nom de la classe du transformateur que <oXygen/> va
régler comme valeur de la propriété Java "javax.xml.transform.TransformerFactory". Pour exécuter une
transformation XSLT avec Saxon 7 par exemple, vous devez placer le fichier jar Saxon 7 dans le
répertoire des bibliothèques de <oXygen/> (le sous-répertoire lib du répertoire d'installation), régler
"net.sf.saxon.TransformerFactoryImpl" comme valeur de la propriété et sélectionnert JAXP comme le
processeur XSLT dans le scénario de transformation associé au document XML transformé.
XSLT 1.0 Valider avec Permet à l'utilisateur de régler le moteur XSLT utilisé pour la
validation des documents XSL 1.0.
XSLT 2.0 Valider avec Permet à l'utilisateur de régler le moteur XSLT utilisé pour la
validation des documents XSL 2.0.
Réglages Debugger
16
Débuter
Détection de boucle infinie Activez cette option pour recevoir une notification lorsqu'une
boucle infinie apparaît durant la transformation.
Processeurs FO
En dehors du processeur d'objets de formatage intégré (Apache FOP) l'utilisateur peut utiliser d'autres
processeurs externes. <oXygen/> a implémenté une façon aisée d'ajouter XEP comme processeur de FO
externe si l'utilisateur a XEP d'installé.
17
Débuter
Permettre le rendement du FOP Si coché, toutes les sorties FOP seront affichés dans un panneau
intégré de résultats en bas de la fenêtre de l'éditeur dont les messages
ennuyants sur les instructions FO non-supportées par FOP.
Mémoire disponible pour le FOP Si vos transformations FOP échouent avec l'erreur "Out of
intégré Memory", sélectionnez depuis cette liste de choix une plus grande
valeur pour le niveau de mémoire réservé pour les transformations
FOP.
Fichier de configuration pour le Vous devriez spécifier ici un chemin pour le fichier de
FOP intégré configuration FOP, nécessaire par exemple pour sortir en PDF en
utilisant une fonte True Type pour un document contenant de
l'Unicode.
Les utilisateurs peuvent configurer les processeurs externes à utiliser avec <oXygen/> dans le dialogue
suivant.
18
Débuter
Nom Le nom qui sera affiché dans la liste des processeurs FOP disponibles
sur l'onglet FOP du dialogue configuration de la transformation.
19
Débuter
Configuration du proxy
Some networks use Proxy servers to provide Internet Services to LAN Clients. Clients behind the Proxy
may therefore, only connect to the Internet via the Proxy Service. The Proxy Configuration dialog
enables this configuration. If you are not sure whether your computer is required to use a Proxy server to
connect to the Internet or the values required by the Proxy Configuration dialog, please consult your
Network Administrator.
Utiliser serveur proxy Si coché, permet à <oXygen/> d'utiliser le serveur proxy spécifié. Si
non-coché, le serveur proxy est désactivé.
Proxy web (HTTP) L'adresse IP address ou le Fully Qualified Domain Name (FQDN) du
serveur proxy.
20
Débuter
Aucun proxy pour Donne les domaines pour lesquels aucun proxy ne doit être utilisé.
Couleurs
<oXygen/> supporte la colorisation de syntaxe pour les documents XML, DTD, Relax NG (XML et
syntaxe compacte), Java, JavaScript, XQuery, C++, C, PHP,CSS, Perl, Properties, SQL, Shell et Batch.
Même si <oXygen/> offre une configuration des couleurs par défaut pour coloriser les signes, vous
pouvez choisir de personnaliser, comme exigé, en utilisant le dialogue Couleurs.
21
Débuter
22
Débuter
23
Débuter
24
Débuter
NG
25
Débuter
26
Débuter
Les modèles sont des documents contenant une structure prédéfinie. Ils
offrent des point de départ sur lesquels rapidement construire des
nouveaux documents qui répètent les mêmes caractéristiques de base.
<oXygen/> installe un riche ensemble de modèles pour de nombreuses
applications XML. On peut aussi créer ses propres modèles et les
partager avec d'autres utilisateurs.
27
Débuter
28
Débuter
Menu XML
Note
Les utilisateurs de Macintosh doivent utiliser la touche Commande au lieu de Control pour tous
les raccourcis clavier.
29
Débuter
30
Débuter
XML->Vérifier que le document soit bien formé (Ctrl+Shift+W) : Exécute l'opération de vérification de la
forme du document en utilisant une moulinette non-validante. Renvoie une liste-résultat d'erreurs dans la vue
texte de <oXygen/>.
XML->Validation Relax NG (Ctrl+Shift+R) : Affiche le dialogue de validation Relax NG, utilisé pour
sélectionner le schéma Relax NG et pour exécuter l'opération de validation sur le document actuel. Le fichier
schéma peut être soit en syntaxe XML Relax NG, ou en syntaxe compacte Relax NG. En cas d'erreurs la
validation renvoie une liste-résultat d'erreurs dans la vue texte de <oXygen/>.
XML->Validation NRL (Ctrl+Shift+N) : Affiche le dialogue de validation NRL, utilisé pour sélectionner le
schéma NRL (Namespace Routing Language) et pour exécuter l'opération de validation sur le document
actuel. En cas d'erreurs la validation renvoie une liste-résultat d'erreurs dans la vue texte de <oXygen/>.
XML->Effacer les marqueurs de validation (Ctrl+Shift+K) : Efface les marqueurs dans la vue des problèmes
correspondant aux erreurs obtenues durant la dernière validation du document actuel.
XML->Convertir avec Trang (Ctrl+Shift+\) : Convertit le document actuel vers un langage de grammaire
supporté en utilisant le convertisseur Trang intégré.
XML->Apprendre la structure (Ctrl+Shift+L) : Lit la structure du balisage du document actuel afin qu'elle
puisse être utilisée pour l'assistant de contenu.
XML->Formater et indenter (Ctrl+Shift+F) : Aussi référencer comme "Pretty print", "Formater et indenter"
opère des fonctions de mise en page afin de rendre le balisage plus lisible à l'écran et sur sortie papier.
XML->XPath (Ctrl+Shift+/) : Ouvre un dialogue pour entrer et exécuter une requête XPath sur le document
actuel.
XML->Ajouter aux modèles (Ctrl+Shift+A)Affiche le dialogue Ajouter aux modèles utilisé pour définir le
nom par lequel le contenu du document actuel sera reconnu dans l'option "À partir d'un modèle".
31
Débuter
XML Tools->Trang intégré... : Convertit le document actuel vers un langage de grammaire supporté en
utilisant le convertisseur Trang intégré.
XML Tools->Documentation de schéma... : Un outil utilisé pour générer une documentation HTML d'un
document schéma XML.
Outils XML->Analyseur WSDL SOAP : contient un analyseur et émetteur SOAP pour les fichiers Web
Services Description Language.
Le panneau Éditeur
Le panneau éditeur est le lieu où vous éditez vos documents ouverts ou créés par le module d'extension
Eclispe <oXygen/>. Vous savez si le document est associé à <oXygen/> avec l'icône spécial affiché
dans la barre de titre de l'éditeur qui a le même motif graphique avec différentes couleurs suivant les
différents types de documents :
32
Débuter
Panneau Contour
Le panneau Contour possède les fonctions suivantes :
• Suivi de modification
33
Débuter
Suivi de modification
Lors de l'édition, le Contour suit dynamiquement les modifications introduites par l'utilisateur, affichant
dans le milieu du panneau le nœud étant actuellement modifié. Ceci donne à l'utilisateur une meilleure
idée de l'endroit où il est positionné et comment la structure du document est affectée par ses
modifications.
34
Débuter
35
Chapitre 4. Transformer des
documents
XML est conçu pour entreposer, diffuser, et échanger des données, pas à afficher des données. Quand on
souhaite visualiser les données on doit soit avoir un agent utilisateur compatible XML soit le
transformer dans un format qui peut être lu par d'autres agents utilisateur. Ce processus est connu sous le
nom de transformation.
Avec la version actuelle de <oXygen/> vous pouvez transformer vos documents XML dans les formats
suivants sans avoir à sortir de l'application. Pour la transformation vers des formats non-listés, installez
simplement la chaîne d'outils nécessaire pour exécuter la transformation et traiter les fichiers xml créés
avec <oXygen/> en accord avec les instructions du processeur.
PDF Le Adobe Portable Document Format (PDF) est un format de fichier binaire
compact qui peut être visualisé et imprimé par tout le monde, n'importe où parmi un
large éventail de matériels et de logiciels utilisant la visualiseur PDF gratuit de
Adobe [http://www.adobe.com/products/acrobat/readstep.html].
TXT Les fichiers texte sont du Plain ASCII Text et peuvent être ouverts dans n'importe
quel éditeur de texte ou traitement de texte.
• XML a été conçu pour décrire les données et pour se concentrer sur ce que sont
les données.
• HTML a été conçu pour afficher des données et se concentrer sur le rendu visuel
des données.
Tout le formatage durant une transformation est donné sous le contrôle d'une Extensible Stylesheet
(XSLT). Spécifier la XSLT appropriée permet la transformation dans les formats ci-dessus et la
préparation des fichiers de sortie pour des applications spécifique de visualisation, dont:
36
Transformer des documents
De nombreux autres formats cibles sont possibles, ceci sont les plus populaires. La condition basique
pour la transformation vers n'importe quel format est que votre document est valide suivant une DTD
donnée et que la XSLT (XSL) utilisée pour la transformation soit compatible avec la DTD.
Une feuille de style XSL spécifie la présentation d'une classe de documents XML en décrivant comment
les instances de la classe sont transformées en un document XML qui utilise le vocabulaire de
formatage.
<oXygen/> supporte XSLT/XPath en version 1.0 en utilisant Saxon 6.5.3, Xalan et XSLT/XPath 2.0 en
utilisant Saxon 8.1B. L'éditeur bascule entre la liste tag-insight des éléments pour les deux standards
automatiquement en examinant l'attribut de version de la feuille de style. Par ailleurs, la validation est
faite suivant la version de feuille de stylen.
Transformations XSL XSLT est un langage pour transformer les documents XML.
Langage Path XML XPath est un langage d'expression utilisé par XSLT pour accéder
ou référer à des parties d'un document XML. (XPath est aussi
utilisé par la spécification Linking XML Linking).
Objets de formatage XSL XSL-FO est un vocabulaire XML pour spécifier la sémantique de
formatage.
Astuce
Pour inclure des img PNG dans le document PDF final il vous faut les librairies JIMI
[http://java.sun.com/products/jimi/] ou JAI [http://java.sun.com/products/java-media/jai/]. Pour
37
Transformer des documents
Scénarios de transformation
Avant de transformer le document XML actuellement édité dans <oXygen/> on doit définir un scénario
de transformation à appliquer sur ce document. Un scénario spécifie des valeurs pour divers paramètres
définissant une transformation. Il n'est pas lié à un document particulier mais à un type de document :
Scénarios qui s'appliquent aux Un tel scénario contient l'emplacement d'une feuille de style
fichiers XML XSLT qui est appliquée sur le document XML édité, et d'autres
paramètres.
Scénarios qui s'appliquent aux Un tel scénario contient l'emplacement d'un document XML
fichiers XSL auquel le fichier XSL édité est appliqué, et d'autres paramètres de
transformation.
Le dialogue Configurer un scénario est utilisé pour associer un scénario de la liste de tous les scénarios
au document édité en sélectionnant une entrée de la liste. Le dialogue est ouvert en pressant le bouton
Configurer un scénario de transformation sur la barre d'outils de la vue du document. Une fois
sélectionnée, le scénario sera appliquée en un seul clic sur le bouton Appliquer la transformation de la
même barre d'outils. Presser le bouton Appliquer la transformation avant d'avoir associé un scénario au
document édité va ouvrir d'abord le dialogue Configurer le scénario puis appliquer le scénario
sélectionné.
38
Transformer des documents
Onglet XSLT Utilisez l'onglet XSLT pour spécifier un fichier d'entrée XSL à utiliser pour la
transformation. Vous pouvez aussi ajouter des paramètres XSLT et joindre les URL
des en-tête et pied de page pour leur inclusion dans la transformation. Pour
appliquer une cascade de feuilles de style l'utilisateur peut régler la liste des feuilles
de style appliquées après la feuille de style depuis le champ XSL URL du bouton
"Cascade de feuille de style". L'utilisateur peut choisir entre Xalan et Saxon lors de
la configuration de la transformation. Saxon est plus rapide sur les feuilles de style
de Docbook.
Onglet FOP Utiliser l'onglet FOP pour activer/désactiver l'utilisation du FOP durant une
transformation. L'input FOP peut être donné depuis la sortie XSLT ou la source du
document édité. <oXygen/> est livré avec le FOP d'Apache, mais supporte la
définition et l'usage d'un processeur d'une tierce partie. La méthode de sortie par
défaut est réglée pour utiliser le PDF, mais PS et TXT sont aussi configurés. Vous
pouvez ajouter et définir n'importe quelle méthode supportée par votre FOP.
Onglet Rendu Utiliser l'onglet Rendu pour spécifier le chemin de sortie où les fichiers cibles de
sortie seront sauvés. Lors de l'exécution d'une transformation XHTML le chemin
relatif pour l'emplacement des images doit être donné afin d'assurer que les chemins
des images seront correctement résolus pour les afficher dans les fichiers de sortie.
Si on utilise FOP ceci n'est pas nécessaire car les images seront intégrées dans
39
Transformer des documents
La liste des cascades de feuilles de style peut être éditée dans le dialogue ouvert par le bouton "Cascade
de feuilles de style".
Ajouter Ajoute une feuille de style dans la liste de "Cascade des feuilles de style" en utilisant le
dialogue d'un sélecteur de fichiers, vous pouvez aussi entrer une macro dans le champ
nom du fichier du sélecteur de fichiers. Le nom de la feuille de style sera ajouté dans la
liste après la sélection actuelle.
Nouvelle Ouvre un dialogue dans lequel vous pouvez taper le nom d'une feuille de style. Le nom
est considéré en relation à l'URL du document XML actuellement édité. Vous pouvez
utiliser des macros dans le nom de la feuille de style. Le nom de la feuille de style sera
ajouté dans la liste après la sélection actuelle.
Dans les champs réservés pour : URL d'entrée (XSL URL ou XML URL, suivant le type de scénario),
URL d'en-tête, URL de pied, les URL dans la liste de cascade de feuilles de style, URL du fichier de
40
Transformer des documents
sortie (le champ Enregistrer sous dans l'onglet Sortie), URL de la base d'images, l'utilisateur peut utiliser
les macros suivantes :
${cfdu} url du répertoire du fichier actuel - le chemin du document actuellement édité jusqu'au nom
du répertoire parent comme URL
${cfn} nom du fichier actuel - le nom du fichier actuellement édité sans extension ni répertoire
parent
In the Save As field from the Output tab, the user can use the following macros: ${home}, ${cfd},
${cfn}.
${cfd} répertoire du fichier actuel - le chemin du document actuellement édité jusqu'au nom du
répertoire parent
Les macros définies ici peuvent être aussi utilisées dans les valeurs réglées pour les paramètres de la
transformation (par ex. le répertoire de base).
Créer un scénario
Utiliser la procédure suivante pour créer un scénario.
2. Cliquer sur Reproduire le scénario pour créer une copie du "scénario" actuel.
L'option d'Exporter des scénarios de transformation est utilisée pour sauver tous les scénarios dans un
fichier séparé, un fichier de propriétés. Dans ce fichier seront sauvées aussi les associations entre URL
de documents et scénarios. Les URL sauvées sont absolues. Vous pouvez charger les scénarios sauvés
en utiliisant l'option Importer scénarios de transformation, tous les scénarios importés auront le mot
'import' ajouté dans leur nom.
Les étapes suivantes sont communes à tous les exemples de procédures ci-dessous.
4. Cliquer sur le bouton "Parcourir pour un fichier input XSL". Le sélecteur de fichier est affiché.
Note
Durant les transformations la barre de statut de l'éditeur va afficher "Transformation - en
cours". La transformation est terminée avec succès quand le message "transformation XSL
réussie" est affiché. Si la transformation rate, le message "transformation XSL ratée" est affiché
ainsi qu'une erreur dans le panneau message. L'utilisateur peut stopper le processus de
transformation à n'importe quel point en pressant le bouton "Stopper transformation". Dans ce
cas, les message affiché dans la barre de statut sera "Transformation stoppée par l'utilisateur".
Sortie PDF
4. Cocher l'option Exécuter le traitement de FO. Les options restantes sont activées.
42
Transformer des documents
7. Dans le champ "Enregistrer sous" entrez le nom du fichier de sortie relativement au répertoire
actuel (VotreNomdeFichier.pdf) ou le chemin et le nom du fichier de sortie
(C:\RépertoireduFichier\VotreNomdeFichier.pdf).
Sortie PS
4. Cocher l'option Exécuter le traitement de FO. Les options restantes sont activées.
b. PS comme méthode.
7. Dans le champ "Enregistrer sous" entrez le nom du fichier de sortie relativement au répertoire
actuel (VotreNomdeFichier.ps) ou le chemin et le nom du fichier de sortie
(C:\RépertoireduFichier\VotreNomdeFichier.ps).
Sortie TXT
4. Cocher l'option Exécuter le traitement de FO. Les options restantes sont activées.
43
Transformer des documents
7. Dans le champ "Enregistrer sous" entrez le nom du fichier de sortie relativement au répertoire
actuel (VotreNomdeFichier.txt) ou le chemin et le nom du fichier de sortie
(C:\RépertoireduFichier\VotreNomdeFichier.txt).
Sortie HTML
6. Dans le champ "Enregistrer sous" entrez le nom du fichier de sortie relativement au répertoire
actuel (VotreNomdeFichier.html) ou le chemin et le nom du fichier de sortie
(C:\RépertoireduFichier\VotreNomdeFichier.html).
a. Si vos images ne se trouvent pas relativement à l'endroit de la sortie, vérifiez la case XHTML
dans Montrer comme.
3. Voir le paramètre XSLT base.dir, il identifie le répertoire de sortie (s'il n'est pas spécifié, le
44
Transformer des documents
Sortie JavaHelp
3. Règle le paramètre XSLT base.dir, il identifie le répertoire de sortie (s'il n'est pas spécifié, le
répertoire de sortie est dépendant du système).
5. Décocher l'option Exécuter le traitement FO. Les options FOP sont désactivées.
Rendu XHTML
4. Décocher l'option Exécuter le traitement de FO. Les options FOP sont désactivées.
6. Dans le champ "Enregistrer sous" entrez le nom du fichier de sortie relativement au répertoire
actuel (VotreNomdeFichier.html) ou le chemin et le nom du fichier de sortie
(C:\RépertoireduFichier\VotreNomdeFichier.html).
a. Si vos images ne se trouvent pas dans l'emplacement de la sortie, cochez la case XHTML dans
Montrer comme.
45
Chapitre 5. Debugger XSLT
Contour
<oXygen/> ajouter deux perspectives dans Eclipse. La première est la perspective standard d'édition qui
offre des fonctions générales pour le développement de documents XML et d'autres langages de
programmation. La seconde est la perspective Debugger. La perspective Debugger est lancée en cliquant
sur le bouton Debugger XSLT de oXygen situé sur la barre d'outils de la perspective ou en sélectionnant
le Debugger XSLT de oXygen depuis Fenêtre->Ouvrir perspective->Autre. Pour revenir à la perspective
de l'Éditeur, cliquez sur le bouton oXygen XML qui est adjacent au bouton Debugger XSLT de oXygen
sur la barre d'outils de la perspective ou sélectionnez oXygen XML depuis Fenêtre->Ouvrir perspective-
>Autre. Les utilisateurs peuvent cycler les perspectives Debugger et Éditeur comme souhaité en cliquant
sur l'un des boutons.
Ce chapitre explique les fonctions du mode Debugger, qui offre un riche ensemble de fonctionnalités
pour le développement, le test et la résolution de problèmes XSL, dont :
• Capacités de stepping : step in, step over, step out, run, run to cursor, run to end, pause, stop.
• Back mapping between every piece of output and style element /source context who generate it .
• Entre dans les feuilles de style importées/incluses ainsi que dans les entités source incluses.
Agencement
Un exemple de ce à quoi ressemble l'interface du Debugger est affiché ci-dessous. Cette interface
comprend quatre panneaux comme suit :
4. Vue de Contrôle
46
Debugger XSLT
Les documents XML et les feuilles de style XSL qui sont ouverts dans la perspective Éditeur sont
automatiquement classés dans les deux premiers panneaux. Quand de multiple fichiers de chaque type
sont ouverts, les documents/feuilles de style individuels sont séparés en utilisant le système de gestion
familier par onglets de la perspective Éditeur. Sélectionner un onglet rend actif le document/la feuille de
style sans avoir à revenir à la perspective Éditeur.
Durant le débogage le nœud d'exécution actuel est surligné à la fois dans la vue du document (XML) et
de la feuille de style (XSL).
Vue de Contrôle
47
Debugger XSLT
La vue de contrôle offre des fonctionnalités pour la configuration et le contrôle des opérations de
débogage. Elle offre aussi une série de Vue Information types. Ce panneau comprend trois parties :
• Vue Information
Sélecteur de source XML La sélection représente le document source à utiliser par le moteur
de transformation. La liste de sélection contient tous les fichiers
ouverts (les fichiers XML étant mis en avant). Cela vous donne la
possibilité d'utiliser d'autres types de fichier comme source.
Sélecteur de feuille de style XSL La sélection représente le document feuille de style à utiliser par
le moteur de transformation. La liste de sélection contient tous les
fichiers ouverts (les fichiers XSL étant mis en avant).
Aller au-dessus Exécute le nœud de feuille de style actuel (dont ses sous-
éléments) et va au prochain nœud dans l'ordre du document
(habituellement le prochain fils du nœud actuel).
Aller dehors Passe au nœud parent (équivalent à Aller au-dessus sur le parent).
Exécute jusqu'à la fin Exécute la transformation jusqu'à la fin, sans prendre en compte
les breakpoints qui pourraient être présents.
48
Debugger XSLT
Afficher le contexte actuel Surligne à la fois dans la source et dans la feuille de style les
nœuds d'exécution actuels. Cette fonction est utile quand vous
avez perdu la sélection actuelle.
Info de l'étape actuelle Affiche les informations sur le nœud actuellement atteint par le
processus de débogage. Les détails affichés sont :
• Nom du nœud.
Vue Information
La vue information comprend deux panneaux qui sont utilisés pour afficher divers types d'information
qui peuvent être utilisés pour comprendre le processus de transformation. Pour chaque type de
transformation il y a un onglet correspondant, sélectionner un onglet active la vue du type d'information.
En exécutant une transformation, les événements pertinents pour les différents types d'informations sont
sortis pour être affichés dans les différentes vues de types d'informations. Cela permet au développeur
d'obtenir une vue claire du type d'information sélectionné qui suit la progression de la transformation.
Combiné avec l'utilisation de contrôle de débogage, les développeurs peuvent aisément isoler des parties
de fonctionnalité de feuille de style pour pouvoir les comprendre et les modifier si nécessaire. Les types
d'informations incluent (pour une discussion plus détaillée de chaque type d'information, voir
Comprendre les vues des informations):
• Vue XPath
• Vue Breakpoints
• Vue de la pile
49
Debugger XSLT
Débuter
<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 ou sélectionnez le Debugger XSLT de oXygen depuis
Fenêtre->Ouvrir perspective->Autre
>Autre .
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
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.
Les erreurs rencontrées durant le débogage sont rapportées sur la vue des problèmes.
À la fin du débogage, seul le contenu des vues suivantes est préservé (toutes les autres vues sont
effacées) :
• Vue XPath
50
Debugger XSLT
2. À partir de Vue du document feuille de style (XSL) sélectionnez un document feuille de style.
3. À partir de Barre d'outils du contrôle utilisez le contrôle Sélecteur de source XML pour
sélectionner un document source.
4. À 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.
5. À 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.
6. Configurez le Paramètres XSLT. Une fois réglés, ces paramètres sont préservés entre les sessions
de débogage.
7. 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).
Note
Initialement, seul le processeur XSLT Saxon est actif dans la perspective Debugger. Si vous
sélectionnez le processeur XSLT Xalan, un message d'alerte est affiché demandant la version
2.5.1 de Xalan. Pour régler Xalan 2.5.1, vous devez copier le fichier xalan.jar depuis
[oxygen]/lib et le mettre dans le dossier adapté de votre JRE/JDK utilisé pour Eclipse (vous
pouvez le toruver dans l'entrée Aide->À propos de la plateforme Eclipse+Détails de la
configuration java.endorsed.dirs) et relancer Eclipse.
Durant le débogage, il est important de connaître ce mapping de la sortie à la source afin de trouver
rapidement quels modèles posent problème. Quelques fonctions de débogage, par exemple "Step in"
peuvent être utilisées dans ce but. En utilisant "Step in" vous pouvez voir comment la sortie est générée
et la lier avec l'élément de style exécutée dans le contexte du source actuel . Néanmoins, ceci peut être
difficile sur des feuilles de style complexes qui générent de grosses sorties.
Sortie vers mapping de xource est une fonction puissante qui rend ce mapping persistant, c.-à-d. que
vous pouvez cliquer sur le texte depuis la Vue du document de sortie et l'éditeur va sélectionner le
contexte du source et l'élément XSL qui ont généré le texte.
51
Debugger XSLT
52
Debugger XSLT
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.
53
Debugger XSLT
Remarques
• Les expressions ayant des références vers des noms de variables ne sont pas évaluées. Dans
le cas d'une erreur XPath, une ligne d'erreur est renvoyée.
• La liste des expressions n'est pas effacée à la fin de la transformation (elle est préservée
durant les sessions).
• Pour insérer une nouvelle expression, cliquez sur la dernière ligne de la colonne expressions
et entrez-la. Appuyez sur Entrée sur la cellule pour confirmer.
• Pour effacer une expression, cliquez sur sa colonne Expression et effacez son contenu.
Appuyez sur Entrée pour confirmer.
• Si le type de résultat de l'expression est un Ensemble de nœuds, vous pouvez cliquez dessus
(colonne Valeur) et vous verrez sur la partie droite sa valeur (voir Vue d'ensemble de
nœuds).
Vue Breakpoints
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.
54
Debugger XSLT
Breakpoint valide
• Les breakpoints ne sont pas tous valides. Par exemple si le breakpoint est mis sur une ligne
vite ou de commentaire, ou si la ligne n'est pas atteinte par le processeur example (no
template to match it, line containing only an end tag), ce breakpoint est invalide.
55
Debugger XSLT
Remarques
Vue de la pile
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.
56
Debugger XSLT
Colonne Description
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é.
Remarques
• En utilisant Saxon, les élements de la feuille de style sont qualifiés avec proxy XSL, tandis
qu'avec Xalan vous ne voyez que leurs noms. (exemple <xsl:template> sous Saxon et
modèle sous Xalan).
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.
57
Debugger XSLT
Remarques
58
Debugger XSLT
Remarques
• Saxon n'affiche que les modèles appliqués ayant au moins un hit par le processeur. Xalan
affiche tous les modèles définis, avec ou sans hits.
59
Debugger XSLT
Remarques
• 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 :
60
Debugger XSLT
Valeurs possibles
• Booléen.
• Chaîne.
• Numérique.
• Ensemble de nœuds.
• Fragment d'arbre.
• Objet.
• Tous.
Remarques
61
Debugger XSLT
62
Chapitre 6. Support WSDL
Vue d'ensemble du Web Services Description
Language
Le Web Services Description Language (WSDL) est un format XML pour descrire des services réseau
comme un ensemble de points de fin opérant sur des messages contenant soit des informations orientées
document ou orientées procédure.
63
Support WSDL
64
Support WSDL
Dans le cas d'un fichier distant vous devez utiliser l'option "Analyseur WSDL SOAP". Dans le cas du
document édité, vous pouvez lancer l'analyseur avec le premier bouton de la barre d'outils.
• La liste des services. La liste des services définis par le fichier WSDL.
• La liste des opérations. La liste des opérations disponibles pour le service sélectionné.
• L'URL Action. Ce n'est pas éditable et affiche le script qui sert l'opération.
65
Support WSDL
• L'action SOAP. Ce n'est pas éditable et identifie l'action exécutée par le script.
• L'éditeur de requête. Il vous permet de composer la requête web service. Quand une action est
sélectionnée, <oXygen/> essaie de générer autant de contenu que possible pour le squelette d'appel.
Habituellement, vous n'avez qu'à changer que quelques valeurs afin de rendre la requête valide. Le
tag-insight est disponible pour cet éditeur et est piloté par le schéma qui défini le type du message
actuel.
• La liste des pièces jointes. Vous pouvez définir une liste d'URL à joindre à la requête.
• La zone de réponse. Elle présente le message reçu par le serveur en réponse de la requête Web
Service. Elle peut aussi montrer les messages d'erreur.
• La liste des erreurs. Il peut y avoir des situations où le fichier WSDL respecte le schéma XML
WSDL, mais n'arrive pas à être valide pour l'exemple dans le cas d'un message qui est défini par le
moyen d'un élément qui ne se trouve pas dans la section des types du WSDL. Dans un tel cas, les
erreurs seront listées ici. Cette liste est présentée seulement quand il y a des erreurs.
• Le bouton envoyer. Exécute la requête. Un dialogue de statut est affiché quand <oXygen/> se
connecte au serveur.
Le test d'un fichier WSDL est très rapide, vous n'avez qu'à cliquer sur le bouton d'analyse WSDL, puis
sélectionner le service, le port et l'opération. L'éditeur va générer le squelette de la requête. Vous pouvez
éditer la requête, éventuellement y joindre des fichiers et l'envoyer au serveur. Regardez la réponse du
serveur dans la zone réponse.
66
Chapitre 7. Support XQuery
Vue d'ensemble de XQuery
XQuery est le langage de requête pour XML. Les nombreux bénéfices de XQuery incluent :
• XQuery vous permet de travailler dans un modèle commun quelque soit le type de données avec
lequel vous travaillez: relationnel, XML, ou données objet.
• XQuery est idéal pour les requêtes qui doivent représenter les résultats en XML, pour faire des
requêtes sur du XML dans ou en dehors de la base de données et pour enjamber les sources
relationnelles et XML.
• XQuery vous permet de créer de nombreux types différents de représentations XML des mêmes
données.
• XQuery vous permet de faire des requêtes à la fois sur des sources XML et de créer un résultat
XML.
L'éditeur XML <oXygen/> inclut un éditeur XQuery qui possède les caractéristiques suivantes :
Pour créer un nouveau document XQuery vous pouvez sélectionner Fichier-> Nouveau (Ctrl+N) et
quand le dialogue Nouveau document apparaît, sélectionnez l'entrée XQuery.
67
Support XQuery
Validation XQuery
Avec <oXygen/> vous pouvez valider vos documents avant de les utiliser dans vos scénarios de
transformation. La validation utilise le processeur Saxon 8.1B. C'est en conformité avec le XQuery
Working Draft http://www.w3.org/TR/xquery/. Le processeur est utilisé dans deux cas : la validation de
l'expression et l'exécution. Même si l'exécution implique une validation, il est plus rapide de vérifier
systématiquement l'expression sans l'exécuter. Les erreurs qui apparaissent dans le document sont
présentés dans la vue des messages en bas de la fenêtre de l'éditeur, avec un message de description
complet. Comme avec tous les messages d'erreur, si vous cliquez sur une entrée, la ligne où l'erreur est
apparue est surlignée.
68
Support XQuery
69