ComposantsComponents › XML
Transforme un document XML par une feuille de style XSL et écrit le résultat dans un fichier : page HTML, autre XML, texte. Dans un flux, il peut lire le XML ou la feuille dans une colonne et mettre le résultat dans une colonne. Le moteur est Saxon-HE 10.6 (XSLT 3.0), bibliothèque importée par le composant et imposée par son code : ce n'est pas le moteur XSLT du JDK. Transforms an XML document with an XSL stylesheet and writes the result to a file: HTML page, other XML, text. In a flow, it can read the XML or the stylesheet from a column and put the result into a column. The engine is Saxon-HE 10.6 (XSLT 3.0), a library imported by the component and forced by its code: it is not the XSLT engine of the JDK.
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Iterate ou Main : une transformation par itération ou par ligne. None: it starts its subjob. Otherwise one Iterate or Main link: one transformation per iteration or per row.
SortieOutput
Main une ligne par ligne entrante : ses colonnes de même nom, et le résultat si une colonne le reçoit.one row per incoming row: its columns with the same name, and the result if a column gets it.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Le composant seul lit le Flux/fichier XML et le Flux/fichier XSL, et écrit le Fichier de sortie. La suite du job reprend ce fichier, par exemple par les variables OUTPUT_FILEPATH et OUTPUT_FILENAME.
The component alone reads the XML file/stream and the XSL file/stream, and writes the Output file. The rest of the job takes that file, for instance through the OUTPUT_FILEPATH and OUTPUT_FILENAME variables.
Le XML de chaque ligne est dans une colonne ; le résultat va dans une colonne du schéma du tXSLT. La feuille reste un fichier, ou vient elle aussi d'une colonne. The XML of each row is in a column; the result goes to a column of the tXSLT schema. The stylesheet stays a file, or also comes from a column.
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Chemins, noms et valeurs sont des expressions Java. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. Paths, names and values are Java expressions.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Flux/fichier XMLXML file/streamXML_FILE | chemin par défaut + /in.xmldefault path + /in.xml |
Colonne pour XML décochéeColumn for XML unchecked |
Le document transformé : un chemin, ou un java.io.InputStream (new java.io.FileInputStream(…) a donné le même résultat).
The transformed document: a path, or a java.io.InputStream (new java.io.FileInputStream(…) gave the same result).
|
| Flux/fichier XSLXSL file/streamXSLT_FILE | chemin par défaut + /in.xsldefault path + /in.xsl |
Colonne pour XSL décochéeColumn for XSL unchecked |
La feuille de style, chemin ou InputStream (essayé aussi). D'après le modèle, elle est compilée à chaque exécution du composant, donc à chaque ligne dans un flux.
The stylesheet, path or InputStream (also tried). Per the template, it is compiled at each run of the component, so at each row in a flow.
|
| Fichier de sortieOutput fileOUTPUT_FILE | chemin par défaut + /in.htmldefault path + /in.html |
Colonne pour le résultat décochéeColumn for result unchecked | Le fichier écrit, remplacé s'il existe. Un chemin relatif part du dossier de travail du job. Dans un flux, une expression qui dépend de la ligne donne un fichier par ligne (exemple) ; sinon, chaque ligne réécrit le même fichier. The written file, replaced if it exists. A relative path starts from the working folder of the job. In a flow, an expression that depends on the row gives one file per row (example); otherwise, each row writes the same file again. |
| ParamètresParametersPARAMS | videempty | ToujoursAlways |
Colonnes (nom) et valeur : le nom d'un xsl:param global de la feuille et sa valeur, deux expressions Java. Le type Java de la valeur décide de son type XPath : un texte arrive en xs:untypedAtomic (voir l'exemple).
name and value columns: the name of a global xsl:param of the stylesheet and its value, two Java expressions. The Java type of the value decides its XPath type: a text arrives as xs:untypedAtomic (see the example).
|
| Utiliser une colonne au lieu d'un fichier/flux pour XMLUse column instead of file/stream for XMLOVERRIDE_INPUT_XML_FILE | NonNo | ToujoursAlways |
Le document est le texte de la Colonne d'entrée pour XML (INPUT_XML_FILE_COL, une colonne String du flux entrant).
The document is the text of the Input column for XML (INPUT_XML_FILE_COL, a String column of the incoming flow).
|
| Utiliser une colonne au lieu d'un fichier/flux pour XSLUse column instead of file/stream for XSLOVERRIDE_INPUT_XSL_FILE | NonNo | ToujoursAlways |
La feuille est le texte de la Colonne d'entrée pour XSL (INPUT_XSL_FILE_COL) : chaque ligne peut avoir la sienne.
The stylesheet is the text of the Input column for XSL (INPUT_XSL_FILE_COL): each row can have its own.
|
| Utiliser une colonne au lieu d'un fichier pour le résultatUse column instead of file for resultOVERRIDE_OUTPUT | NonNo | ToujoursAlways |
Le résultat va, en texte, dans la Colonne de sortie pour le résultat (OUTPUT_COL, une colonne du schéma du composant) au lieu d'un fichier. Il faut alors un lien de sortie : sans lui, le job ne compile pas (voir les pièges).
The result goes, as text, to the Output column for result (OUTPUT_COL, a column of the component schema) instead of a file. An output link is then needed: without it, the job does not compile (see the pitfalls).
|
| SchémaSchemaSCHEMA | videempty | ToujoursAlways | Les colonnes de sortie. Une colonne qui a le nom d'une colonne d'entrée en reçoit la valeur ; celle du résultat est remplie par la transformation. Le schéma de l'entrée n'est pas recopié quand on relie le flux (comme dans le Studio). The output columns. A column that has the name of an input column gets its value; the result one is filled by the transformation. The input schema is not copied when the flow is connected (as in the Studio). |
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Mode hérité, mise en mémoire tampon (non recommandé)Legacy mode In-memory buffering (not recommended)CACHE_SOURCE | NonNo | ToujoursAlways |
Pour un document donné par son chemin : le fichier est d'abord lu en entier en mémoire, puis transformé (bibliothèque commons-io-2.8.0, ajoutée alors au job). Même résultat dans notre essai. D'après le modèle, le document n'a plus alors d'adresse : un chemin relatif à lui (document(), entités) ne se résout plus de la même façon.
For a document given by its path: the file is first read entirely into memory, then transformed (commons-io-2.8.0 library, then added to the job). Same result in our run. Per the template, the document then no longer has an address: a path relative to it (document(), entities) no longer resolves the same way.
|
Écrites après chaque transformation vers un fichier ; avec le résultat dans une colonne, elles restent null.
Written after each transformation to a file; with the result in a column, they stay null.
/, exclu. Sans / : le chemin entier (voir les pièges).String, Output file path: the Output file up to its last /, excluded. Without /: the whole path (see the pitfalls)./. Sans / : le chemin entier.String, Output file name: what follows the last /. Without /: the whole path.((String) globalMap.get("tXSLT_1_OUTPUT_FILEPATH"))
((String) globalMap.get("tXSLT_1_OUTPUT_FILENAME"))
((String) globalMap.get("tXSLT_1_ERROR_MESSAGE"))
Les jobs ont été exécutés dans Talaxie, avec Java 21 ; les sorties sont celles de la console, copiées telles quelles. Le dossier des fichiers est remplacé par C:/data, celui des résultats par C:/out, le nom du job par MyJob. Après le tXSLT, un tJava relié par On Subjob Ok affiche les variables globales puis, après ---, le contenu du fichier produit.
The jobs were run in Talaxie, with Java 21; the outputs are the console ones, copied as they are. The files folder is replaced with C:/data, the results one with C:/out, the job name with MyJob. After the tXSLT, a tJava connected with On Subjob Ok prints the global variables then, after ---, the content of the produced file.
Document books.xml :books.xml document:
<?xml version="1.0" encoding="UTF-8"?> <library name="Central"> <book id="b1"><title>Dune</title><price>9.90</price></book> <book id="b2"><title>Le Petit Prince</title><price>7.50</price></book> <book id="b3"><title>Fondation</title><price>12.00</price></book> </library>
Feuille books-html.xsl, en XSLT 1.0 :books-html.xsl stylesheet, in XSLT 1.0:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" encoding="UTF-8" indent="yes"/>
<xsl:param name="title" select="'Books'"/>
<xsl:template match="/library">
<html>
<body>
<h1><xsl:value-of select="$title"/></h1>
<table>
<xsl:for-each select="book">
<xsl:sort select="title"/>
<tr><td><xsl:value-of select="title"/></td><td><xsl:value-of select="price"/></td></tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
Fichier de sortie "C:/out/books.html", Paramètres : nom "title", valeur "My library" :Output file "C:/out/books.html", Parameters: name "title", value "My library":
OUTPUT_FILEPATH = C:/out
OUTPUT_FILENAME = books.html
ERROR_MESSAGE = null
--- books.html
<!DOCTYPE HTML><html>
<body>
<h1>My library</h1>
<table>
<tr>
<td>Dune</td>
<td>9.90</td>
</tr>
<tr>
<td>Fondation</td>
<td>12.00</td>
</tr>
<tr>
<td>Le Petit Prince</td>
<td>7.50</td>
</tr>
</table>
</body>
</html>
Le paramètre remplace la valeur par défaut de la feuille. La sortie HTML de Saxon commence par <!DOCTYPE HTML> et indente de trois espaces ; une feuille en version 1.0 est acceptée.
The parameter replaces the default value of the stylesheet. The HTML output of Saxon starts with <!DOCTYPE HTML> and indents by three spaces; a version 1.0 stylesheet is accepted.
Feuille books.xsl : elle affiche le type reçu, garde les livres plus chers que $minPrice et donne le moteur.books.xsl stylesheet: it prints the type received, keeps the books more expensive than $minPrice and gives the engine.
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="3.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="text" encoding="UTF-8"/>
<xsl:param name="minPrice" select="0"/>
<xsl:template match="/library">
<xsl:text>minPrice = </xsl:text>
<xsl:value-of select="$minPrice"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="if ($minPrice instance of xs:string) then 'xs:string' else if ($minPrice instance of xs:untypedAtomic) then 'xs:untypedAtomic' else if ($minPrice instance of xs:integer) then 'xs:integer' else 'other'" xmlns:xs="http://www.w3.org/2001/XMLSchema"/>
<xsl:text>) </xsl:text>
<xsl:for-each select="book[price > $minPrice]">
<xsl:value-of select="concat('- ', title, ' : ', price)"/>
<xsl:text> </xsl:text>
</xsl:for-each>
<xsl:text>Engine: </xsl:text>
<xsl:value-of select="system-property('xsl:vendor'), system-property('xsl:product-name'), system-property('xsl:product-version'), '/ XSLT', system-property('xsl:version')"/>
<xsl:text> </xsl:text>
</xsl:template>
</xsl:stylesheet>
Sans paramètre :Without parameter:
--- books.txt minPrice = 0 (xs:integer) - Dune : 9.90 - Le Petit Prince : 7.50 - Fondation : 12.00 Engine: Saxonica SAXON HE 10.6 / XSLT 3.0
"minPrice" = "8" (String) :"minPrice" = "8" (String):
--- books.txt minPrice = 8 (xs:untypedAtomic) - Dune : 9.90 Engine: Saxonica SAXON HE 10.6 / XSLT 3.0
"minPrice" = 8 (Integer) :"minPrice" = 8 (Integer):
--- books.txt minPrice = 8 (xs:integer) - Dune : 9.90 - Fondation : 12.00 Engine: Saxonica SAXON HE 10.6 / XSLT 3.0
"8" arrive en xs:untypedAtomic ; comparé au prix, non typé lui aussi, il donne une comparaison de textes : "12.00" est plus petit que "8", Fondation disparaît. L'entier 8 donne une comparaison de nombres. Avec 8.0 (Double), le type affiché est other (ni texte, ni entier) et le résultat est celui des nombres.
The "8" text arrives as xs:untypedAtomic; compared with the price, also untyped, it gives a text comparison: "12.00" is smaller than "8", Fondation disappears. The integer 8 gives a number comparison. With 8.0 (Double), the printed type is other (neither text nor integer) and the result is the number one.
<xsl:param name="minPrice" as="xs:decimal" select="0"/> convertit le texte "8" en nombre : même résultat qu'avec l'entier (Dune et Fondation).
A stylesheet that declares <xsl:param name="minPrice" as="xs:decimal" select="0"/> converts the "8" text into a number: same result as with the integer (Dune and Fondation).
Deux lignes, colonnes id et xml : A-1 avec la commande <order id="A-1"><customer>Ada</customer> de deux lignes (quantités 3 et 2), A-2 avec celle de Grace (une ligne, quantité 1). Feuille order-summary.xsl :
Two rows, columns id and xml: A-1 with the order <order id="A-1"><customer>Ada</customer> of two lines (quantities 3 and 2), A-2 with the one of Grace (one line, quantity 1). order-summary.xsl stylesheet:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="text"/>
<xsl:template match="/order">
<xsl:value-of select="customer"/>
<xsl:text>: </xsl:text>
<xsl:value-of select="count(line)"/>
<xsl:text> line(s), </xsl:text>
<xsl:value-of select="sum(line/quantity)"/>
<xsl:text> item(s)</xsl:text>
</xsl:template>
</xsl:stylesheet>
Colonne pour XML : xml ; colonne pour le résultat : summary. Schéma du tXSLT : id (copiée de l'entrée) et summary. Le tLogRow est en mode tableau, le tJava affiche les variables :
Column for XML: xml; column for the result: summary. tXSLT schema: id (copied from the input) and summary. The tLogRow is in table mode, the tJava prints the variables:
.---+---------------------------. | tLogRow_1 | |=--+--------------------------=| |id |summary | |=--+--------------------------=| |A-1|Ada: 2 line(s), 5 item(s) | |A-2|Grace: 1 line(s), 1 item(s)| '---+---------------------------' OUTPUT_FILEPATH = null OUTPUT_FILENAME = null
La feuille dans une troisième colonne xsl, avec <xsl:value-of select="upper-case(customer)"/> (fonction XPath 2.0) :
The stylesheet in a third xsl column, with <xsl:value-of select="upper-case(customer)"/> (XPath 2.0 function):
.---+-------. | tLogRow_1 | |=--+------=| |id |summary| |=--+------=| |A-1|ADA | |A-2|GRACE | '---+-------'
Mêmes lignes, XML lu dans la colonne xml, feuille order-summary.xsl, Fichier de sortie "C:/out/order-" + row1.id + ".txt". Schéma du tXSLT : id ; un tLogRow en mode simple la reçoit. Le tJava affiche les variables puis les deux fichiers :
Same rows, XML read from the xml column, order-summary.xsl stylesheet, Output file "C:/out/order-" + row1.id + ".txt". tXSLT schema: id; a tLogRow in basic mode gets it. The tJava prints the variables then both files:
A-1 A-2 OUTPUT_FILEPATH = C:/out OUTPUT_FILENAME = order-A-2.txt order-A-1.txt: Ada: 2 line(s), 5 item(s) order-A-2.txt: Grace: 1 line(s), 1 item(s)
Les variables donnent le fichier de la dernière ligne. The variables give the file of the last row.
Une erreur de la feuille ou du document arrête le composant : Saxon écrit d'abord son propre message, puis vient l'exception. Les jobs ont un tJava relié par On Subjob Error ; les piles d'appels, écrites deux fois, sont abrégées (…).
An error of the stylesheet or of the document stops the component: Saxon first writes its own message, then comes the exception. The jobs have a tJava connected with On Subjob Error; the stack traces, written twice, are shortened (…).
Flux/fichier XSL : "C:/data/order.xsd", un schéma XSD :XSL file/stream: "C:/data/order.xsd", an XSD schema:
Error on line 2 column 56 of order.xsd: XTSE0150: The supplied file does not appear to be a stylesheet Static error on line 2 column 56 of order.xsd: XTSE0150: The supplied file does not appear to be a stylesheet Exception in component tXSLT_1 (MyJob) javax.xml.transform.TransformerConfigurationException: net.sf.saxon.s9api.SaxonApiException: The supplied file does not appear to be a stylesheet … [On Subjob Error] OUTPUT_FILEPATH = null OUTPUT_FILENAME = null ERROR_MESSAGE = net.sf.saxon.s9api.SaxonApiException: The supplied file does not appear to be a stylesheet
Document order-broken.xml, où <quantity> n'est pas fermé :order-broken.xml document, where <quantity> is not closed:
Error on line 4 column 44 of order-broken.xml: SXXP0003 Error reported by XML parser: Le type d'élément "quantity" doit se terminer par la balise de fin correspondante "</quantity>".: Le type d'élément "quantity" doit se terminer par la balise de fin correspondante "</quantity>". Exception in component tXSLT_1 (MyJob) net.sf.saxon.trans.XPathException: org.xml.sax.SAXParseException; systemId: file:/C:/data/order-broken.xml; lineNumber: 4; columnNumber: 44; Le type d'élément "quantity" doit se terminer par la balise de fin correspondante "</quantity>". … [On Subjob Error] OUTPUT_FILEPATH = null OUTPUT_FILENAME = null ERROR_MESSAGE = org.xml.sax.SAXParseException; systemId: file:/C:/data/order-broken.xml; lineNumber: 4; columnNumber: 44; Le type d'élément "quantity" doit se terminer par la balise de fin correspondante "</quantity>".
Le message de l'analyseur XML est en français (langue du système) ; ceux de Saxon sont en anglais.The XML parser message is in French (system language); the Saxon ones are in English.
Fichier de sortie "C:\\out\\books-win.txt" :Output file "C:\\out\\books-win.txt":
OUTPUT_FILEPATH = C:\out\books-win.txt OUTPUT_FILENAME = C:\out\books-win.txt ERROR_MESSAGE = null
Le fichier est bien écrit, mais le découpage ne connaît que / : les deux variables valent le chemin entier. Avec un nom seul, "books-relative.txt", elles valent toutes deux books-relative.txt, et le fichier est écrit dans le dossier de travail du job. Écrivez les chemins avec /.The file is written correctly, but the split only knows /: both variables are the whole path. With a name alone, "books-relative.txt", they are both books-relative.txt, and the file is written in the working folder of the job. Write the paths with /.
Exemple d'une colonne à une colonne, sans le lien vers le tLogRow :From a column to a column example, without the link to the tLogRow:
Échec de la compilation du job : C:\work\src\demo\myjob_0_1\MyJob.java:800: error: illegal start of expression .summary = writertXSLT_1.toString(); ^ 1 error
Défaut du modèle de Talaxie (tXSLT_main.javajet, ligne 150) : le résultat est écrit dans la colonne d'une ligne de sortie qui n'existe pas, sans nom de lien. Reliez une sortie, même vers un composant qui ne fait rien.Defect of the Talaxie template (tXSLT_main.javajet, line 150): the result is written into the column of an output row that does not exist, without a link name. Connect an output, even to a component that does nothing.
Comme le montre l'exemple des paramètres, une valeur Java String donne une comparaison de textes face à un nœud non typé, sans erreur. Passez un nombre Java (8, Integer.valueOf(context.min)), déclarez le type du paramètre (as="xs:decimal"), ou convertissez dans la feuille (number($minPrice)).As the parameters example shows, a Java String value gives a text comparison against an untyped node, without error. Pass a Java number (8, Integer.valueOf(context.min)), declare the parameter type (as="xs:decimal"), or convert in the stylesheet (number($minPrice)).
Le composant importe Saxon-HE-10.6.jar (mvn:net.sf.saxon/Saxon-HE/10.6) et demande nommément sa fabrique : XSLT 3.0 et XPath 3.1, sans ce que Saxon réserve à ses éditions payantes, comme le traitement selon un schéma XSD ou en flux. La version de Java n'y change rien.
The component imports Saxon-HE-10.6.jar (mvn:net.sf.saxon/Saxon-HE/10.6) and asks for its factory by name: XSLT 3.0 and XPath 3.1, without what Saxon keeps for its paid editions, such as schema-aware or streamed processing. The Java version changes nothing there.
D'après le modèle, une feuille donnée par son chemin garde son adresse : ses xsl:include et xsl:import relatifs partent de son dossier. Donnée par un flux ou une colonne, elle n'a pas d'adresse : préférez alors des chemins absolus (non essayé).
Per the template, a stylesheet given by its path keeps its address: its relative xsl:include and xsl:import start from its folder. Given by a stream or a column, it has no address: prefer absolute paths then (not tried).
Seules les colonnes du schéma du tXSLT passent à la suite. Une colonne d'entrée absente du schéma est perdue ; la colonne du résultat doit y être, de type String. Only the columns of the tXSLT schema go on. An input column missing from the schema is lost; the result column must be in it, of type String.
Saxon-HE construit tout le document en mémoire avant de le transformer (la transformation en flux est réservée à l'édition EE). Pour de très gros fichiers, prévoyez la mémoire de la JVM (-Xmx) en conséquence ; le mode hérité ajoute en plus une copie du fichier en mémoire.
Saxon-HE builds the whole document in memory before transforming it (streamed transformation is kept for the EE edition). For very large files, size the JVM memory (-Xmx) accordingly; the legacy mode adds one more copy of the file in memory.
tXMLMap · transformer du XML par un éditeur graphiquetransform XML with a graphical editortXSDValidator · valider le XML avant de le transformervalidate the XML before transforming ittDTDValidator · valider par une DTDvalidate with a DTDtExtractXMLField · lire le XML d'une colonneread the XML of a columntFileInputXML · lire les lignes d'un fichier XMLread the rows of an XML filetAdvancedFileOutputXML · écrire un fichier XML à partir d'un fluxwrite an XML file from a flow