ComposantsComponents › XML
Convertit un fichier EDIFACT (échange UN/EDIFACT : enveloppe UNB, messages UNH… UNT) en un document XML, rangé dans la colonne document, de type Document, d'une ligne de sortie. L'analyse est faite par l'analyseur EDI de Smooks (Milyn Smooks, org.milyn.edisax), avec la description des messages de la version de répertoire choisie, de D93A à D09B. Le document se lit ensuite par un tExtractXMLField ou un tXMLMap.
Converts an EDIFACT file (UN/EDIFACT interchange: UNB envelope, UNH… UNT messages) into an XML document, stored in the document column, of type Document, of one output row. The parsing is done by the EDI parser of Smooks (Milyn Smooks, org.milyn.edisax), with the message descriptions of the chosen directory version, from D93A to D09B. The document is then read by a tExtractXMLField or a tXMLMap.
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Iterate (un fichier par itération) ou Main (une conversion par ligne). None: it starts its subjob. Otherwise one Iterate link (one file per iteration) or Main (one conversion per row).
SortieOutput
Main une ligne : la colonne document.one row: the document column.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Le tExtractXMLField lit la colonne document par des requêtes XPath, comme pour tout document XML. Pour écrire le document dans un fichier, un tJavaRow peut appeler row1.document.toString(), qui donne le texte XML.
The tExtractXMLField reads the document column with XPath queries, as for any XML document. To write the document to a file, a tJavaRow can call row1.document.toString(), which gives the XML text.
UNH : UNH+1+ORDERS:D:96A:UN' correspond à D96A.
Set the EDI filename and the EDI version of the messages, the one of their UNH segment: UNH+1+ORDERS:D:96A:UN' matches D96A.
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de paramètres avancés. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaPROPERTY | document |
ToujoursAlways |
En lecture seule : une colonne document de type Document. Le paramètre s'appelle PROPERTY et n'a pas de libellé dans les fichiers de messages du composant : Talaxie affiche ce nom.
Read-only: one document column of type Document. The parameter is called PROPERTY and has no label in the message files of the component: Talaxie displays that name.
|
| Nom du fichier EDIEDI filenameEDI_FILE | "" |
ToujoursAlways | Le fichier EDIFACT. D'après le modèle, il est ouvert avant le bloc qui traite les erreurs : un fichier absent arrête le composant, même Arrêter en cas d'erreur décoché. The EDIFACT file. Per the template, it is opened before the block that handles errors: a missing file stops the component, even with Die on error unchecked. |
| Version d'EDIEDI versionEDI_VERSION | D00A | ToujoursAlways |
La version de répertoire UN/EDIFACT : D93A, D94A, D94B… D99B, D00A… D09B (34 versions). Le modèle charge seulement la description de cette version (urn:org.milyn.edi.unedifact:d96a-mapping:1.4 pour D96A) : un message d'une autre version n'y trouverait pas la sienne.
The UN/EDIFACT directory version: D93A, D94A, D94B… D99B, D00A… D09B (34 versions). The template loads only the description of that version (urn:org.milyn.edi.unedifact:d96a-mapping:1.4 for D96A): a message of another version would not find its own there.
|
| Ignorer la nouvelle ligneIgnore new lineIGNORE_NEW_LINE | NonNo | ToujoursAlways |
Active la fonctionnalité FEATURE_IGNORE_NEWLINES de l'analyseur de Smooks : les sauts de ligne placés entre les segments sont ignorés.
Enables the FEATURE_IGNORE_NEWLINES feature of the Smooks parser: the line breaks placed between the segments are ignored.
|
| Arrêter en cas d'erreurDie on errorDIE_ON_ERROR | NonNo | ToujoursAlways |
D'après le modèle : cochée, une erreur d'analyse arrête le composant. Décochée, son message va sur la sortie d'erreur et dans ERROR_MESSAGE, et la ligne de sortie part quand même, avec un document vide (toString() donne null).
Per the template: checked, a parsing error stops the component. Unchecked, its message goes to the error output and to ERROR_MESSAGE, and the output row still leaves, with an empty document (toString() gives null).
|
Lu dans le modèle tEDIFACTtoXML_main.javajet et dans la routine système NamespaceFilter, non vérifié par une exécution :
Read in the tEDIFACTtoXML_main.javajet template and in the NamespaceFilter system routine, not checked by a run:
UNEdifactInterchangeParser) reçoit la description des messages de la version choisie et lit le fichier en flux SAX. Les éléments vides sont gardés.
A UN/EDIFACT interchange parser of Smooks (UNEdifactInterchangeParser) gets the message descriptions of the chosen version and reads the file as a SAX stream. Empty elements are kept.
urn:org.milyn.edi. le perdent : le document s'interroge par des requêtes XPath sans préfixe.
The elements whose namespace starts with urn:org.milyn.edi. lose it: the document is queried with XPath queries without prefix.
document de la ligne de sortie, une ligne pour tout le fichier, quel que soit le nombre de messages.
The resulting dom4j document is stored in the document column of the output row, one row for the whole file, whatever the number of messages.
Le composant importe 40 bibliothèques, toutes obligatoires, quelle que soit la version choisie : The component imports 40 libraries, all of them required, whatever the chosen version:
| BibliothèqueLibrary | Coordonnées MavenMaven coordinates | Sur le poste d'essaiOn the test machine |
|---|---|---|
| Descriptions des messages, une par version (34)Message descriptions, one per version (34) | mvn:org.milyn.edi.unedifact/d93a-mapping/1.4 … d09b-mapping/1.4 | IntrouvablesNot found |
| Milyn Smooks | mvn:org.talend.libraries/milyn-smooks-all-1.7.0/6.0.0 | IntrouvableNot found |
| jaxen, commons-logging, commons-collections, commons-lang, dom4j | jaxen 1.2.0, commons-logging 1.1, commons-collections 3.2.2, commons-lang 2.6, org.dom4j 2.1.3 | PrésentesPresent |
Ni dans le dépôt Maven de l'utilisateur (~/.m2), ni dans le dépôt configuration/.m2 des Studios Talaxie 8.9.0 installés (DI et ESB). Le téléchargement depuis les dépôts distants n'a pas été essayé : les descriptions des messages sont publiées sur Maven Central sous ces coordonnées d'après leur nom, ce qui n'a pas été vérifié ; org.talend.libraries/milyn-smooks-all-1.7.0 est une coordonnée propre à Talend.
Neither in the Maven repository of the user (~/.m2), nor in the configuration/.m2 repository of the installed Talaxie 8.9.0 Studios (DI and ESB). Downloading from the remote repositories was not tried: the message descriptions are published on Maven Central under these coordinates according to their name, which was not checked; org.talend.libraries/milyn-smooks-all-1.7.0 is a Talend-specific coordinate.
Les sources de Talaxie ont un plugin org.talend.libraries.edifact avec des versions de développement des 34 descriptions (déclarées 1.4-SNAPSHOT) et milyn-smooks-all-1.4.jar. Elles ne remplacent pas celles du composant : Smooks 1.4 n'a pas le paquet org.milyn.edisax.registry que le code généré utilise, et le composant demande les descriptions …:1.4.
The Talaxie sources have an org.talend.libraries.edifact plugin with development builds of the 34 descriptions (declared 1.4-SNAPSHOT) and milyn-smooks-all-1.4.jar. They do not replace those of the component: Smooks 1.4 does not have the org.milyn.edisax.registry package that the generated code uses, and the component asks for the …:1.4 descriptions.
Job tEDIFACTtoXML → tLogRow, lancé dans Talaxie 9.0.6 sans téléchargement. Console copiée telle quelle, nom du job remplacé par MyJob, dossier de travail par C:\work, lignes répétées abrégées (…) :
tEDIFACTtoXML → tLogRow job, started in Talaxie 9.0.6 without download. Console copied as it is, job name replaced with MyJob, working folder with C:\work, repeated lines shortened (…):
Bibliothèque introuvable : mvn:org.milyn.edi.unedifact/d00a-mapping/1.4
Bibliothèque introuvable : mvn:org.milyn.edi.unedifact/d00b-mapping/1.4
…
Bibliothèque introuvable : mvn:org.milyn.edi.unedifact/d99b-mapping/1.4
Bibliothèque introuvable : mvn:org.talend.libraries/milyn-smooks-all-1.7.0/6.0.0
Échec de la compilation du job :
C:\work\src\demo\myjob_0_1\MyJob.java:669: error: package org.milyn.edisax.unedifact does not exist
org.milyn.edisax.unedifact.UNEdifactInterchangeParser parser_tEDIFACTtoXML_1 = new org.milyn.edisax.unedifact.UNEdifactInterchangeParser();
^
…
C:\work\src\demo\myjob_0_1\MyJob.java:690: error: package org.milyn does not exist
} catch (org.milyn.SmooksException sE_tEDIFACTtoXML_1) {
^
7 errors
Les 35 bibliothèques manquantes sont signalées, puis la compilation échoue : les classes de Smooks sont absentes. The 35 missing libraries are reported, then the compilation fails: the Smooks classes are missing.
Le message préparé pour l'exemple : une commande ORDERS de la version D96A, aux données fictives, un segment par ligne. Avec les bibliothèques, il se lirait avec la Version d'EDI D96A et Ignorer la nouvelle ligne cochée ; sans elles, aucune sortie n'a pu être relevée.
The message prepared for the example: an ORDERS order of version D96A, with fictitious data, one segment per line. With the libraries, it would be read with the D96A EDI version and Ignore new line checked; without them, no output could be recorded.
UNA:+.? ' UNB+UNOA:2+SENDER1:ZZ+RECEIVER1:ZZ+261120:1200+1' UNH+1+ORDERS:D:96A:UN' BGM+220+PO12345+9' DTM+137:20261120:102' NAD+BY+++Demo Buyer' LIN+1++4006381333931:EN' QTY+21:12' UNS+S' UNT+8+1' UNZ+1+1'
Le composant ne déclare aucune variable propre. ERROR_MESSAGE (String), commune à tous les composants, reçoit d'après le modèle le message d'une erreur d'analyse, que Arrêter en cas d'erreur soit coché ou non. Dans le job ci-dessus, le tJava qui devait l'afficher n'a pas pu s'exécuter. The component declares no variable of its own. ERROR_MESSAGE (String), common to all components, gets per the template the message of a parsing error, whether Die on error is checked or not. In the job above, the tJava that was to print it could not run.
((String) globalMap.get("tEDIFACTtoXML_1_ERROR_MESSAGE"))
Pour utiliser le composant, il faut les 35 jars manquants sous leurs coordonnées exactes, dans un dépôt que Talaxie consulte (dans Talaxie : Préférences › Modules, « Installer un jar… »). Le composant date de Smooks 1.x, dont le développement est arrêté ; son fonctionnement avec Java 21 n'a pas pu être vérifié. To use the component, the 35 missing jars are needed under their exact coordinates, in a repository that Talaxie reads (in Talaxie: Preferences › Modules, “Install a jar…”). The component dates from Smooks 1.x, whose development has stopped; how it works with Java 21 could not be checked.
Tout l'échange tient dans un seul document. Pour une ligne par message ou par ligne de commande, bouclez ensuite sur l'élément voulu avec un tExtractXMLField. The whole interchange fits in a single document. For one row per message or per order line, then loop on the wanted element with a tExtractXMLField.
tExtractXMLField · lire le document par XPathread the document with XPathtXMLMap · transformer le documenttransform the documenttXSLT · transformer du XML par une feuille XSLtransform XML with an XSL stylesheettFileInputXML · lire les lignes d'un fichier XMLread the rows of an XML filetFileList · traiter plusieurs fichiers, un par itérationprocess several files, one per iterationtLibraryLoad · charger une bibliothèque dans un jobload a library into a job