...
La colonne indique si la balise et sa valeur sont obligatoires ou non. 'Rec' signifie 'Recommandé' pour un traitement total automatique
Balise XML | Obligatoire | Observation |
|---|---|---|
<?xml version="1.0" encoding="UTF-8"?> | Oui | Indique le format d'encodage des chaînes de caractères |
<DataHub DataSetType=valeurChaine> | Oui | L'attribut DATASETTYPE indique le type de pivot. Valeur: IMPEXPXML pour indiquer qu'il s'agit d’import/export de données XML |
<Source>valeurChaine</Source> | Rec | Permet d’identifier l’émetteur du pivot dans le dataset |
<Systeme>valeurChaine</Systeme> | Rec | Permet d’identifier le système émetteur dans le dataset |
<Dossier>valeurChaine</Dossier> | Oui | Code de dossier Divalto |
<Etablissement>valeurChaine</Etablissement> | Rec | Code d’établissement Divalto, si gestion du dossier par établissement |
<SwTicketNo>0</SwTicketNo> | Rec | Numéro de ticket de demande. LA présence de la balise indique qu’on veut avoir un ticket en retour |
<FichierPrincipal>valeurChaine</FichierPrincipal> | Oui | Nom du fichier principal. Ce fichier au format XML indique l’action (import ou export) et les données concernées (tables, champs) |
Détails du fichier principal
Cas d’une demande d’export. Une balise indique, pour la table demandée, si le type des données doit être indiqué en retour dans la réponse.
Balise XML | Obligatoire | Observation |
|---|---|---|
<xml> | Oui | Balise d’ouverture |
<export table=”NomTable” datatype=true | Oui | NomTable indique le nom de la table dans la base de données ERP à exporter datatype=true indique que dans la réponse doit figurer le type de chaque donnée. Par défaut, datatype=false, donc aucune indication sur le typage de donnéé |
<fields name=”ALL”/> ou <fields name=”NomDuChamp1”></fields> <fields name=”NomDuChamp2”/> | Oui | Pour obtenir tous les champs, utiliser le mot clé ALL Sinon indiquer le nom du champ à exporter. (Peuvent être trouvés depuis le zoom par l’explorateur de champs Ctrl+D) |
</xml> | Oui | Balise de clôture |
Cas d’une demande d’import. C’est au demandeur de donner les champs de la clé primaire qui permettra de traiter correctement la demande
Balise XML | Obligatoire | Observation |
|---|---|---|
<xml> | Oui | Balise d’ouverture |
<import table=”NomTable” action=”NomAction” | Oui | NomTable indique le nom de la table dans la base de données ERP à importer. NomAction indique l’action:
|
<fields name=”NomDuChamp1”>ValeurChamp1</fields> <fields name=”NomDuChamp2” value=ValeurChamp2/> | Oui | L’attribut name indique le NomDuChamp à importer La valeur peut être donnée soit par la balise (cf ValeurChamp1) soit par l’attribut value(cf ValeurChamp2. |
</xml> | Oui | Balise de clôture |
NOTE 1 : Ce sont les propriétés de l’objet métier associé à chaque table qui indique si la suppression est autorisée. Voir la page technique pour plus d’informations
Exemples de fichiers
Exemple de fichier pivot pour import de données (pivot_impxml.dhub)
| Bloc de code |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<DataHub DataSetType="IMPEXPXML">
<Source>EXTERNE</Source>
<Dossier>998</Dossier>
<Etablissement></Etablissement>
<FichierPrincipal>import.xml</FichierPrincipal>
</DataHub>
|
Exemple de fichier pivot pour export de données (pivot_expxml.dhub)
| Bloc de code |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<DataHub DataSetType="IMPEXPXML">
<Source>EXTERNE</Source>
<Dossier>998</Dossier>
<Etablissement></Etablissement>
<FichierPrincipal>export.xml</FichierPrincipal>
</DataHub>
|
Exemple de fichier principal pour un import de données (import.xml)
Cas d’une modification du nom d’une client
| Bloc de code | ||
|---|---|---|
| ||
<XML>
<import table="CLI" action="update">
<field name="DOS" value="998"/>
<field name="TIERS" value="C0001010"/>
<field name="NOM" value="NOM MODIFIE PAR DATAHUB"/>
</import>
</XML> |
Cas d’une modification de l’encours de deux clients
| Bloc de code | ||
|---|---|---|
| ||
<XML>
<import table = "CLI" action= "update">
<field name = "TIERS" value= "C0000001"/>
<field name = "ENMAX(1)" value= "250000,00"/>
</import>
<import table = "CLI" action= "update">
<field name = "TIERS" value= "C0000003"/>
<field name = "ENMAX(1)" value= "250000,00"/>
</import>
</XML>
|
Exemple de fichier principal pour un export de données (export.xml)
Cas d’un export de tous les code opérations avec tous les champs
| Bloc de code | ||
|---|---|---|
| ||
<XML>
<export table="T025">
<field name="ALL"/>
</export>
</XML> |
Cas d’un export de tous les clients avec les champs DOS, TIERS et TEL, avec indication du typage dans la réponse
| Bloc de code | ||
|---|---|---|
| ||
<XML>
<export table="CLI" datatype=true>
<field name="DOS"/>
<field name="TIERS"/>
<field name="TEL"/>
</export>
</XML> |