ONYX - 9.0 - Utilisation - Traitements XSL

Différence entre versions

De MappingDoc
(Trier les lignes du groupe group1 par ordre décroissant)
(Exemples de feuilles de style XSL)
Ligne 284 : Ligne 284 :
  
 
  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"  
 
  <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">
+
  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:output method="xml" encoding="utf-8" indent="yes" omit-xml-declaration="no" cdata-section-elements="field"/>
 
  <span style="color:red"><xsl:template match="/doc/page/group[@name='group1']">
 
  <span style="color:red"><xsl:template match="/doc/page/group[@name='group1']">
Ligne 300 : Ligne 301 :
 
     </xsl:template>
 
     </xsl:template>
 
  </xsl:stylesheet>
 
  </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
 +
- Ecrire la ligne info_livraison uniquement si la valeur de son champs date_LivConf est différent de la ligne info_livraison précédente
 +
-
 +
 +
XML d'entré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>
 +
<!-- traiter tous les noeuds sauf les group name='Article' (ils seront tous recopiés en l'état grâce au dernier template ci-dessous) -->
 +
<xsl:apply-templates select="*[not(self::group[@name='Article'])]"/>
 +
<!-- traiter les noeuds group Article en les triant en fonction de la date de livraison confirmée (c'est un tri sur une chaîne de caractères, on pourrait trier sur la semaine de livraison, confirmée ou demandée, ...) -->
 +
<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>
 +
 +
<!-- cas des noeuds group Article -->
 +
<xsl:template match="group[@name='Article']">
 +
<!-- ajouter le noeud dans le document résultat puis traiter ses fils -->
 +
<group name="Article">
 +
<!-- Un noeud group est composé de lignes qu'on va ordonner dans l'ordre suivant : info-liraison, info_article, info_remise, info_compo, tailles croissantes -->
 +
<!-- On ne recopie les infos de livraison que si la date de livraison confirmée de ce noeud n'est pas déjà apparue dans un noeud précédent (on va comparer l'info dans le noeud courant avec ./ et dans les noeuds précédents avec prededing-sibling) -->
 +
<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'])">
 +
<!-- recopier les infos de livraison -->
 +
<xsl:apply-templates select="./line[@name='info_livraison']"/>
 +
</xsl:if>
 +
<!-- recopier les infos article -->
 +
<xsl:apply-templates select="./line[@name='info_article']"/>
 +
<!-- recopier les infos remise -->
 +
<xsl:apply-templates select="./line[@name='info_remise']"/>
 +
<!-- recopier les infos compo -->
 +
<xsl:apply-templates select="./line[@name='info_compo']"/>
 +
<!-- recopier les infos taille en recopiant ces lignes par nom de taille croissant -->
 +
<xsl:apply-templates select="./line[starts-with(@name, 'tailles')]">
 +
<xsl:sort select="@name" data-type="text" order="ascending"/>
 +
</xsl:apply-templates>
 +
</group>
 +
</xsl:template>
 +
 +
<!-- copie basique des noeuds, attributs, commentaires -->
 +
<xsl:template match="@*|*|comment()">
 +
<xsl:copy>
 +
<xsl:apply-templates select="@*|*|text()|comment()|processing-instruction()"/>
 +
</xsl:copy>
 +
</xsl:template>
 +
</xsl:stylesheet>

Version du 27 mai 2019 à 15:04

Préambule

Cette documentation aborde des principes simples du XSLT. Mapping ne pourra en aucun cas faire le support des XLS 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 DRAWXML en un autre. (détails dans le chapitre Avantages)

Avantages

Le principal avantage de cette nouvelle fonctionnalité est la possibilité d'avoir un flux générique en entrée tout en gardant un flux de sortie personnalisé D'une manière très simple, Onyx nous donne 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) :

  1. Filtrer des informations
  2. Trier les lignes d'un tableau
  3. Gérer les veuves et orphelines (Bloc de lignes devant être obligatoirement sur une même page)
  4. Ajouter des informations pour simplifier la conception
  5. Faire des conversions de formats de dates

Appels

Il existe 2 façons pour appeler les feuilles XSL :

Workflow

Pour appeler le XSL dans le moteur de règles Mapping (Workflow), nous devons utiliser une boite Workflow detype CMD et appeler le programme M-XSLTransoform 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 tout à fait 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. La feuille XSL permettant de personnaliser le document (tri sur les lignes, suppression de lignes, ajout de ligne, gestion des veuves et orphelines, etc) fait alors partie intégrante du projet Designer

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

Syntaxe :
#xsltransform;
//Contenu de ma feuille de XSL
#endxsltransform;



Exemples de feuilles de style XSL

Etant donnée que nous partons généralement d'un flux DRAWXML vers un autre flux DRAWXML, 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 tel (car il n'est pas utile de faire un traitement XSL si on applique aucune modification aux flux de donnée) 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 de rajouter 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 de rajouter 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ésent 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 en sortie généré :

<?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 - Ecrire la ligne info_livraison uniquement si la valeur de son champs date_LivConf est différent de la ligne info_livraison précédente -

XML d'entré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>