ONYX - Utilisation - Convertisseur Texte paginé vers XML Pivot
Différence entre versions
(→Exemple) |
|||
| Ligne 35 : | Ligne 35 : | ||
===Maquette Designer=== | ===Maquette Designer=== | ||
La maquette Designer doit lister les tous les champs et groupes devant être retrouvés dans le flux XML Pivot en sortie. | La maquette Designer doit lister les tous les champs et groupes devant être retrouvés dans le flux XML Pivot en sortie. | ||
| − | ==== | + | ====Champs devant être créés au niveau <doc>==== |
Les champs hors groupe (dit en standalone), feront l'objet d'un <field> au niveau <doc>, les <field> étant dans des groupes non nommé BG-xxx ou LS-xxx seront placés également au niveau <doc>. | Les champs hors groupe (dit en standalone), feront l'objet d'un <field> au niveau <doc>, les <field> étant dans des groupes non nommé BG-xxx ou LS-xxx seront placés également au niveau <doc>. | ||
| − | ==== | + | ====Champs devant être créés dans une liste==== |
| − | Le <field> | + | Le <field> présent dans un groupe nommé BG-xxx ou LS-xxx seront feront eux l'objet d'une liste <list> dans le fichier XML Pivot généré. |
====Règle de rupture d'item <item> dans les listes==== | ====Règle de rupture d'item <item> dans les listes==== | ||
| Ligne 45 : | Ligne 45 : | ||
====Gestion du DOC-BREAK==== | ====Gestion du DOC-BREAK==== | ||
(A finir) | (A finir) | ||
| + | |||
| + | ===Fichier de paramétrage=== | ||
| + | Le convertisseur PAGTOPIVOT peut lire un fichier de paramétrage dans lequel nous pouvons : | ||
| + | #Surcharger le champ DOC-BREAK de rupure de doc <field id="DOC-BREAK">DOC-BREAK</field> | ||
| + | #Lister les groupes Designer devant donner naissance à une liste dans le fichier de sortie XML Pivot | ||
| + | |||
===Lescommandes d'exécutions associés=== | ===Lescommandes d'exécutions associés=== | ||
Version du 11 août 2023 à 15:57
Sommaire
Introduction
L'objet du convertisseur texte paginé (PAG) vers XML Pivot (Module : PAGTOPIVOT) est de convertir un fichier texte paginé (Spooled files IBM-i, fichiers textes paginée provenant d'ERP quelquonces) en XML Pivot. Il peut avoir plusieurs intérêts à faire cela :
- Génération de formats UBL, CII et Factu-X pour la facturation électronique
- Besoin de repaginer un flux texte provenant par exemple d'un IBM-i (ou autres)
En effet, Efalia Compose (Anciennement MAPPING), utilise le format XML Pivot comme format standard pour les conversions de flux. De ce fait, il est très aisé de générer un flux CII, UBL ou même XML Designer afin de recomposer un document.
Le convertisseur texte paginé vers XML Pivot donne la possibilité de profiter de toutes ces sorties et fonctionnalités quand l'ERP génère un fichier texte paginé.
Prérequis
- la clé Connect doit être activée sur le serveur Efalia Compose
- Les valeurs présentes dans le fichier texte paginé doivent être au format attendu dans le fichier XML Pivot (pas de modification de format dans un premier temps : Possible dans une valeur ultérieure)
Principe de fonctionnement
Le convertisseur se passe en deux étapes :
- Exécution d'une maquette Designer générerant un XML Designer du fichier texte paginé (maquette designer respectant quelques normes)
- Exécution du convertisseur PAGTOPIVOT pour convertir la sortie XML Designer en XML Pivot
A ce moment là, le XML Pivot sera disponible et pourra être utilisé comme souhaité.
Exemple
Prenons pour exemple, le besoin de convertir un fichier texte paginé en XML Pivot afin de gérer un flux CII pour la facturation électronique.
Structure du fichier texte paginé
Le fichier texte paginé est un exemple de flux. N'importe quel flux pouvant être pris en charge par Designer peut être utilisé.
Ce flux d'exemple a été enrichi et modifier pour répondre aux exigences de la norme CII (flux 2) :
Maquette Designer
La maquette Designer doit lister les tous les champs et groupes devant être retrouvés dans le flux XML Pivot en sortie.
Champs devant être créés au niveau <doc>
Les champs hors groupe (dit en standalone), feront l'objet d'un <field> au niveau <doc>, les <field> étant dans des groupes non nommé BG-xxx ou LS-xxx seront placés également au niveau <doc>.
Champs devant être créés dans une liste
Le <field> présent dans un groupe nommé BG-xxx ou LS-xxx seront feront eux l'objet d'une liste <list> dans le fichier XML Pivot généré.
Règle de rupture d'item <item> dans les listes
_1, etc (A finir)
Gestion du DOC-BREAK
(A finir)
Fichier de paramétrage
Le convertisseur PAGTOPIVOT peut lire un fichier de paramétrage dans lequel nous pouvons :
- Surcharger le champ DOC-BREAK de rupure de doc <field id="DOC-BREAK">DOC-BREAK</field>
- Lister les groupes Designer devant donner naissance à une liste dans le fichier de sortie XML Pivot
Lescommandes d'exécutions associés
Conversion du fichier texte paginé en fichier XML Designer :
"C:\MAPPING\M-Processing Server\Applications\mapcpysplf" "-infile:C:\DesignerToPivot\PAG.txt" "-mapnam:FLUX1" "-xmlmapping" -xmloutfile:C:\DesignerToPivot\flux1_XML_Designer.xml -overflow:9999
Conversion du fichier XML designer en fichier XML Pivot :
"C:\MAPPING\M-Processing Server\Applications\maprunrpt" "-rptname:PAGTOPIVOT" "-param:DB.infile=C:\DesignerToPivot\DesignerToPivot\flux1_Exemple.xml" "-param:DB.param=P:\MAPPING\M-Designer\docpc\Clients\Efalia\DesignerToPivot\designertopivot_param.xml" "-outfile:C:\DesignerToPivot\DesignerToPivot\out1.xml"
Evolutions futures
- imbrication de listes
