MappingDoc - Contributions de l’utilisateur [fr]

ONYX:9.0:utilisation des profils de conversion

2019-09-09T12:21:03Z

Admin : Admin a déplacé la page Onyx 9.0 utilisation:utilisation des profils de conversion vers ONYX:9.0:utilisation des profils de conversion sans laisser de redirection

==Utilisation des profils de conversion==

===En ligne de commandes===

====Conversions brutes de documents XPS====

Le principe est de convertir des fichiers XPS, générés ou non par ONYX Server, en vue de leur diffusion finale (impression, envoi par email, archivage…) et en fonction de leur canal de diffusion.
Pour rappel, les langages de sortie supportés sont : PCL, RTF, AFPDS, MapDraw, ProPrinter, PDF, Monarch, HTML, DOCX, TEC, BMP, JPG, PNG, XPS, TXT, XMLPOS, EPL, ZEBRA, IGP, ESCP, ESC, XMLDRAW, PS

Exemple 1 : génération de flux PCL pour impression
map_xps -infile:/tmp/invoice.xps -toPCL -outfile:/tmp/invoice.pcl

Exemple 2 : génération de PDF sur disque, pour éventuel envoi par email
map_xps -infile:/tmp/invoice.xps -toPDF -outfile:/tmp/invoice.pdf

====Conversions par sélection d'un profil====

Le principe est le même mais il faut, en plus, affiner la conversion avec des paramètres d’un profil défini dans le fichier de configuration.

Exemple :
map_xps -infile:/tmp/invoice.xps -outfile:/tmp/invoice.pdf -convert -profile:MYPDF
-config:XXXX ou -profile:XXXX ⇒ sélection du profil à utiliser pour la conversion
-convert ⇒ force la conversion en utilisant le profil sélectionné

Avec, par exemple,un profil MYPDF défini dans le fichier de configuration :
<MYPDF>
<label>Document for Adobe Reader</label>
<language>PDF</language>
<embeddedfont>off</embeddedfont>
<color>on</color>
</MYPDF>

===En automatique dans le spooler===

Dans le Spooler ONYX Server, les profils de conversion sont paramétrés et utilisés au niveau des imprimantes. Au moment de la configuration d’une imprimante dans le Spooler, le paramètre Compatibilité XPS doit être renseigné appelant ainsi un profil de conversion pour tous les flux XPS s’imprimant dans cette imprimante Mapping.

[[Fichier:OX S profildecvr.png|centré|sans_cadre|714x714px]]

Les choix proposés dans la liste déroulante correspondent aux labels de chaque profil défini et identifient de manière unique le profil à utiliser pour la conversion du flux XPS en langage compréhensible par l’imprimante.

Mapping Knowledge Center

2019-09-09T11:20:47Z

Admin : Admin a déplacé la page Accueil vers Mapping Knowledge Center par-dessus une redirection

'''ONYX'''

*[[ONYX:9.0:Accueil|Suite ONYX pour Linux et Windows]]
------------

'''OPALE'''

*[[OPALE:10.0: Accueil|Suite OPALE pour IBM Power i]]
------------

'''FAQ'''

*[[Frequently Asked Questions|Foire Aux Questions]]
------------

'''Anciennes versions'''

*[http://server.mappingsuite.com/wiki Produits antérieurs à 2018]
------------

'''Autres documentations'''

*[[Product Compatibility Matrix|Matrice de compatibilité des différents produits Mapping]]
*[[Fonctionnalités Mapping|Blocs de fonctionnalités Mapping]]
*[[PJL + Mediatype Instructions|Informations spécifiques sur les imprimantes : PJL + instructions Mediatype]]

------------

Accueil

2019-09-09T11:20:47Z

Admin : Admin a déplacé la page Accueil vers Mapping Knowledge Center par-dessus une redirection

#REDIRECTION [[Mapping Knowledge Center]]

Mapping Knowledge Center

2019-09-09T11:20:15Z

Admin : Admin a déplacé la page Mapping Knowledge Center vers Accueil : rétablir

Mapping Knowledge Center

2019-09-09T11:18:31Z

Admin :

Mapping Knowledge Center

2019-09-09T11:16:53Z

Admin : Admin a déplacé la page Accueil vers Mapping Knowledge Center sans laisser de redirection

MediaWiki a été installé.

Consultez le [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents Guide de l’utilisateur] pour plus d’informations sur l’utilisation de ce logiciel de wiki.

== Pour démarrer ==
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Liste des paramètres de configuration]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ/fr Questions courantes sur MediaWiki]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce Liste de discussion sur les distributions de MediaWiki]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Adaptez MediaWiki dans votre langue]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Apprendre comment lutter contre le pourriel dans votre wiki]

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:13:38Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ________ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:13:14Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:12:15Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:11:02Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:10:28Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:09:42Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:08:24Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:07:43Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:06:33Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:04:09Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage comme décrit ci-dessous :

NOM_OUTQ LIB_OUTQ DRAWER BAC_THEORIQUE CODE_PCL_BACPHYSIQUE

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T15:00:11Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|center|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|center|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, on utilise le menu '''Définir les paramètres imprimantes'''

il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T14:59:27Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|left|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|left|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique défini ci-dessus'''

Maintenant que le format Mapping est paramétré sur un bac théorique particulier, il faut faire le lien entre ce bac théorique et le bac physique pour une imprimante particulière.
En effet le code PCL du bac physique 3 ne sera pas le même pour une imprimante Canon et une imprimante Ricoh. (par exemple)
Du coup il faut utiliser une table de correspondance faisant le lien entre : Le nom de l'imprimante, le bac théorique et le bac physique.

Pour ce faire, on utilise le menu '''Définir les paramètres imprimantes'''

il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

OPALE:10.0:Designer:Gestion des bacs sur l'AS/400

2019-05-28T14:52:09Z

Admin :

Cette documentation décrit la gestion des bacs sur IBM-i dans le langage natif. (ne convient pas au fonctionnement en mode XPS)

La gestion des bacs dans les options d'OPALE Server sur le serveur IBM i permet de paramétrer totalement les numéros de bacs en fonction de l'imprimante sur laquelle le fichier mapping est envoyé.

Cette fonction a été ajoutée afin de pouvoir envoyer un code PCL différent pour un même mapping en fonction de l'imprimante.

Il faut définir trois choses :
* Le bac théorique du Format Mapping
* Le code PCL à envoyer en fonction de l'imprimante et du bac théorique
* Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF

'''Le bac théorique du Format Mapping'''
* Choisir l'option '''Gérer les formats mapping''' du menu '''Opale Server'''
* Choisir l'option 2 devant le format mapping à modifier
* Donner une valeur au '''Bac d'entrée''' et/ou au '''Bac de sortie''' (exemple : 1, 2, BAS...)
* Valider la saisie par '''Entrée'''

[[File:Bac Desgnr as400.PNG|600px|left|sans_cadre]]
[[File:Bac-Dgnr as400.PNG|600px|left|sans_cadre]]

Astuces :

Donner comme valeur soit le numéro de bac physique (numéro qui apparaît sur le tiroir : 1, 2, 3, ou BAS, HAUT, MANU...) soit le type de papier qui se trouve dans le bac (Port, Pays, Bleu, Vert).

'''Le code PCL à envoyer en fonction de l'imprimante et du bac théorique'''

Maintenant que le format Mapping s'imprimait sur un bac particulier, il faut remplir une table de paramétrage pour définir le code PCL à envoyer en fonction de l'imprimante pour chaque valeur de bac théorique.
* Aller dans le Menu d'Exploitation d'OPALE Server
* Choisir l'option Définir les paramètres imprimantes
* Remplir la table de paramétrage

'''Les paramètres bacs d'entrée et bac de sortie de la commande MAPCPYSPLF'''

Dans la commande MAPCPYSPLF, les paramètres DRAWER (bac d'entrée) et OUTPUTBIN (bac de sortie) doivent être égaux à '''*MAP'''.

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T14:19:49Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //la ligne de ce champs sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-
prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>

<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] =
./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>

<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T14:19:09Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //la ligne de ce champs sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //la ligne de ce champs sera triée par valeur de
Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-
prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>

<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] =
./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>

<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:40:03Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-
prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>

<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] =
./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>

<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:39:26Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-
prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>

<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] =
./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>

<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:38:07Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-
prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] =
./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:34:44Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-
prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] =
./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:33:17Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:32:50Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">'''20181020'''</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:32:07Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même
(20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:31:52Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">

//Cette ligne ne sera pas affichée car la valeur de Date_LivConf de la ligne info_livraison précédente est la même (20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeur de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:30:46Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">

//Cette ligne ne sera pas affiché car la valeur de Date_LivConf de la ligne info_livraison précédente est la même (20181020)
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:29:35Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:28:30Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne
info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

ONYX:9.0:Utilisation:Traitements XSL

2019-05-28T13:28:05Z

Admin : /* Tri, réagencement, regroupement de lignes */

=Préambule=

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XSL réalisés par ses utilisateurs (clients ou partenaires). Cette documentation a uniquement pour but d'aider ses utilisateurs à profiter de cette fonctionnalité.

=Principes=

La suite Mapping Onyx permet l'utilisation des fonctionnalités XSLT, le but étant de modifier la structure d'un fichier XML en une autre.

Cette transformation peut être appelée soit directement et nativement dans Designer, ou soit nativement dans le moteur de règles via l'utilisation d'une "boite" du Workflow.

Cette nouvelle fonctionnalité propre à Onyx permet notamment la modification d'un flux XMLDRAW en un autre (voir détails dans le chapitre Avantages).

=Avantages=

Le principal avantage de cette nouvelle fonctionnalité est la '''possibilité de traiter un flux générique en entrée tout en gardant un flux de sortie personnalisé.'''

D'une manière très simple, Onyx offre la possibilité de modifier le flux en entrée de Mapping sans devoir retoucher le programme générant ce même flux. Il est alors très simplement possible pour un ou plusieurs documents donnés de (liste non exhaustive) :

#Filtrer des informations
#Trier les lignes d'un tableau
#Gérer les veuves et orphelines (bloc de lignes devant être obligatoirement sur une même page)
#Ajouter des informations pour simplifier la conception
#Réaliser des conversions de formats de dates

=Appels=

Il existe 2 façons d'appeler les feuilles XSL :

==Workflow==

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), il faut utiliser une boite Workflow de type CMD et appeler le programme M-XSLTransform en utilisant la commande suivante :
[%PATH_BIN%]/M-XSLTransform "[%MAP_FILE_IN%]" "[%PATH_XSL%]/MaFeuilleXSL.xsl" "[%MAP_FILE_OUT%]"
Liste des variables : 
- '''PATH_BIN''' : chemin du répertoire des binaires Mapping. (Répertoire Applications sur Onyx Windows ou Bin sur Onyx Linux) 
- '''PATH_XSL''' : chemin du répertoire contenant les feuilles XSL. 
- '''MAP_FILE_IN''' : chemin + nom du fichier d'entrée de la "boite" du workflow 
- '''MAP_FILE_OUT''' : chemin + nom du fichier de sortie de la "boite" du workflow 

==Designer==

Il est également possible d'appeler des feuilles de transformation XSL directement dans Designer. Le gros avantage par rapport aux appels dans le Workflow est l'aspect intégration native dans Designer. En effet, la feuille XSL permet de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc.) et fait alors partie intégrante du projet Designer

Pour ce faire, il faut saisir le contenu de la feuille XSL dans la fenêtre de saisie accessible via le bouton '''Prétraitement XML''' de Designer encapsulé par '''#xsltransform;''' et '''#endxsltransform;'''

Syntaxe : 
<nowiki>#xsltransform;</nowiki> 
//''Contenu de la feuille de XSL'' 
<nowiki>#endxsltransform;</nowiki>

 
[[Fichier:OX D XLS 1.jpg|vignette|450x450px|alt=|néant]]

=Exemples de feuilles de style XSL=
Etant donné que nous partons généralement d'un flux XMLDRAW vers un autre flux XMLDRAW, il est possible de créer des exemples de templates XSL ayant chacun une ou plusieurs fonctionnalités bien spécifiques :

Pour structurer la suite de cette documentation, nous allons partir d'un exemple simple recopiant simplement le flux d'entrée. Dans les exemples qui suivront, nous allons mettre en avant les différences par rapport à cet exemple "coquille générique" afin d'arriver aux résultats souhaités.

==Coquille générique : Simple copie du flux d'entrée==
Cet exemple n'a pas de fonction en tant que telle (car il n'est pas utile d'appliquer un traitement XSL si on applique aucune modification aux flux de données) mais sera utilisé par tous les autres exemples qui suivront comme flux générique commun à tous les exemples.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:stylesheet>

Bon à savoir : 
Entete de la feuille XSL 
template de simple recopie

==Supprimer des types de ligne dans un groupe==

Cet exemple permet de supprimer les types de lignes '''info_remise''' et '''info_compo''' de tous les groupes '''article''' du document.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_remise']"/>
<xsl:template match="/doc/page/group[@name='Article']/line[@name='info_compo']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Ajouter une première ligne et une dernière ligne d'un groupe==
===Sur tous les groupes===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) sur tous les groupes du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

===Sur un groupe spécifique : Article===
Cet exemple permet d'ajouter une ligne de début (first_line) et une ligne de fin (last_line) uniquement sur le ou les groupes Article du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="group[@name='Article']">
<group name="Article">
<line name="first_line"/>
<xsl:apply-templates/>
<line name="last_line"/>
</group>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Supprimer tous les groupes : group1==

Cet exemple permet de supprimer tous les groupes group1 (présents sous /doc/page) du flux d'entrée.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']"/>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Trier les lignes du groupe group1 par ordre décroissant==

Cet exemple permet de trier toutes les lignes du groupe group1 du flux d'entrée par ordre décroissant de valeur de l'attribut name.

XML d'entrée :

<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
</page>
</doc>

Flux généré en sortie :

<?xml version="1.0" encoding="utf-8"?>
<doc>
<page>
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
<group name="group1">
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</group>
<group name="group2">
<line name="line1">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line2">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line3">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
<line name="line4">
<field name="field1">ValueField1</field>
<field name="field2">ValueField2</field>
<field name="field3">ValueField3</field>
<field name="field4">ValueField4</field>
</line>
</page>
</doc>

Feuille XSL utilisée :

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:fn="http://www.w3.org/2005/xpath-functions" version="2.0" exclude-result-prefixes="xsl fo xs
fn">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page/group[@name='group1']">
<xsl:copy>
<xsl:apply-templates select="@*"/>
<xsl:apply-templates>
<xsl:sort select="./@name" data-type="text" order="descending"/>
</xsl:apply-templates>
</xsl:copy>
</xsl:template>
<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>

==Tri, réagencement, regroupement de lignes==

Cet exemple permet de : 
 - Trier les lignes info_livraison des groupes Article par ordre alphabétique croissant de valeur du champs Date_LivConf 
 - Afficher les autres lignes du groupe Article dans un certain ordre : Info_livraison puis info_article puis info_remise puis info_compo et en dernier toutes les lignes commençant par la valeur tailles 
 - Ecrire la ligne info_livraison uniquement si la valeur de son champ date_LivConf est différent de la ligne info_livraison précédente 

XML d'entrée (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>

//Ces 2 lignes seront interverties car le template XSL fait afficher la ligne info_remise avant la ligne info_compo
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20181020</field>
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5,5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20170301</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne">5</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20190101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem">2ème Qz Septembre 2014</field>
<field name="Sem_LivDem">39</field>
<field name="Date_LivConf">20160101</field> //Cette ligne sera triée par valeru de Date_LivConf
<field name="Sem_LivConf">39</field>
</line>
<line name="info_article">
<field name="Num_Ligne">00001</field>
<field name="Type_Ligne">R</field>
<field name="Reference">HOLDEN734</field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon">03789456062585</field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte">20</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte">2</field>
<field name="Unt_Oeuvre">U</field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

XML généré (uniquement les groupes Article pour simplifier la lisibilité du document) :

<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20160101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20170301]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20181020]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_remise">
<field name="Remise_Totale_Ligne"><![CDATA[5,5]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_livraison">
<field name="Date_LivDem"><![CDATA[2ème Qz Septembre 2014]]></field>
<field name="Sem_LivDem"><![CDATA[39]]></field>
<field name="Date_LivConf"><![CDATA[20190101]]></field>
<field name="Sem_LivConf"><![CDATA[39]]></field>
</line>
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="info_compo">
<field name="Composition"><![CDATA[98% Polyester-2% Coton]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>
<group name="Article">
<line name="info_article">
<field name="Num_Ligne"><![CDATA[00001]]></field>
<field name="Type_Ligne"><![CDATA[R]]></field>
<field name="Reference"><![CDATA[HOLDEN734]]></field>
<field name="Designation"><![CDATA[HOLDEN Blanc]]></field>
<field name="GTIN_Taille_Echantillon"><![CDATA[03789456062585]]></field>
</line>
<line name="tailles_1">
<field name="Qte"><![CDATA[20]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
</line>
<line name="tailles_2">
<field name="Qte"><![CDATA[2]]></field>
<field name="Unt_Oeuvre"><![CDATA[U]]></field>
<field name="Lib_Unt_Oeuvre"><![CDATA[Unité(s)]]></field>
</line>
</group>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="2.0" exclude-result-prefixes="xsl xs">
<xsl:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
<xsl:template match="/doc/page">
<page>

<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>

<xsl:apply-templates select="group[@name='Article']">
<xsl:sort select="line[@name='info_livraison']/field[@name='Date_LivConf']" data-type="text" order="ascending"/>
</xsl:apply-templates>
</page>
</xsl:template>


<xsl:template match="group[@name='Article']">

<group name="Article">


<xsl:if test="not(preceding-sibling::group[@name='Article']/line[@name='info_livraison']/field[@name='Date_LivConf'] = ./line[@name='info_livraison']/field[@name='Date_LivConf'])">

<xsl:apply-templates select="./line[@name='info_livraison']"/>
</xsl:if>

<xsl:apply-templates select="./line[@name='info_article']"/>

<xsl:apply-templates select="./line[@name='info_remise']"/>

<xsl:apply-templates select="./line[@name='info_compo']"/>

<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
<xsl:sort select="@name" data-type="text" order="ascending"/>
</xsl:apply-templates>
</group>
</xsl:template>


<xsl:template match="@*|*|comment()">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>