Le fichier pivot et les fichiers compagnons

Owned by Bertrand Littel
Last updated: 08/02/2022
4 min read

Structure du fichier pivot

 

Un fichier pivot a l'extension .DHUB afin de le distinguer totalement des autres fichiers. Les autres extensions seront des fichiers compagnons du pivot. Le nom du fichier pivot n'est pas significatif pour Divalto. Le but est de mettre les données à l'intérieur du fichier pivot. Le contenu est un fichier texte à structure xml simple (tel que lu par XmlRead en langage Diva, voir aide du langage). Les données sont entourées de balises ouvrantes et fermantes, et permettent l'imbrication de niveaux. Les noms de balises et attributs sont sensibles à la casse. 

 

 

  • Un fichier pivot a l'extension .DHUB afin de le distinguer totalement des autres fichiers. Les autres extensions seront des fichiers compagnons du pivot

  • Le nom du fichier pivot n'est pas significatif pour Divalto. Le but est de mettre les données à l'intérieur du fichier pivot.

  • Le contenu est un fichier texte à structure xml simple (tel que lu par XmlRead en langage Diva, voir aide du langage). Les données sont entourées de balises ouvrantes et fermantes, et permettent l'imbrication de niveaux. Les noms de balises et attributs sont sensibles à la casse

Exemple de valeur donnée par balise : <BALISE>valeur1</BALISE>

Exemple de valeur donnée par attribut : <BALISE ATTRIBUT=valeur2></BALISE>

Exemple de 2 valeurs données par balise et attribut <BALISE ATTRIBUT=valeur2>valeur1</BALISE>

  • Une balise ou un attribut XML pourra contenir des données selon 3 types

    • Alphanumérique

    • Date au format YYYYMMDD

    • Numérique (entier ou décimal) avec séparateur '.' et signe

    • (le type sera imposé par la balise ou l’attribut)

  • Pour être considéré comme correct le pivot comporte au minimum les balises suivantes

<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="CodeDuTypeDeDataset"> </DataHub>

DataSetType : attribut qui indique le code du type de dataset DatasetType. Ce code est indiqué dans la documentation de chaque type de dataset

  • Mais un pivot comportera plutôt au minimum les balises suivantes

<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="CodeDuTypeDeDataset"> <Source>NomDeLaSourceDuPivot</Source> <Dossier>NuméroDeDossierDivalto</Dossier> <SwTicketNo>0</SwTicketNo> <FichierPrincipal>NomDuFichier.ext</FichierPrincipal> </DataHub>

NomDeLaSourceDuPivot : indique le déposant

NuméroDeDossierDivalto : code du dossier Divalto dans lequel traiter le fichier

SwTicketNo : numéro permettant au déposant de retrouver chaque dataset

FichierPrincipal : nom du fichier compagnon principal, selon le type de dataset. Par exemple la version PDF d’une facture ou un fichier de données XML ouTXT

  • La liste complète des fichiers compagnons est décrite dans le pivot par le déposant à l’aide des balises Fichiers et Fichier

(extrait) <Fichiers> <Fichier>Fichier1.pdf</Fichier> <Fichier>Fichier2.xml</Fichier> </Fichiers>

  • Les fichiers compagnons sont forcément dans un chemin relatif à l’emplacement du pivot.

    • Compagnon au même emplacement que le pivot : <Fichier>MonFichier1</Fichier>

    • Compagnon dans un sous-dossier “Facture” : <Fichier>/facture/MonFichier2</Fichier>

  • Le fichier pivot comporte deux parties

    • Une zone propre au futur dataset, comportant les informations pour générer un Entête de datahub (=dataset) comme la source, système, dossier, établissement, id externe

    • Une zone de données, selon le type de dataset, avec ou sans sous-niveaux, et tous les champs de données relatifs au type de dataset

Génération du fichier pivot

Le fichier pivot est prévu pour permettre à un prestataire externe d'une solution complémentaire (ex : LAD/RAD, boutique en ligne, pointage, prévisions) d'alimenter automatiquement les dataset dans le DATAHUB Divalto.

On utilisera soit la dépose directe des fichiers dans le dossier d’entrée du datahub, soit la dépose par l’intermédiaire d’un service web.

 

Il est possible de générer un fichier pivot depuis l’ERP à partir de la commande fournisseur et de la facture client pour le transférer vers un autre environnement ERP.
Pour cela, il faut préciser dans le fournisseur (onglet document) que le support demandé est "EDI" ou
"EDI et papier". Dans ce cas, à la première édition de l'ARC ou de la facture, un fichier pivot de type
Datahub sera généré et placé dans le répertoire demandé (chemin EDI_PIECES)

 

Les fichiers pivots pour chaque type de dataset

 

Exemples de fichiers pivot

Exemple de fichier pivot simple

Exemple de fichier pivot pour complétion

Exemple de fichier pivot plus complet