Devis travaux (V10.5)

Owned by Bertrand Littel
Last updated: 14/12/2023
7 min read

Type de dataset

Devis travaux

DatasetType (7)

IMPDTR

Nature de fichier joint

DATAHUB_IMPDTR

Code chemin

DATAHUB_JOINT_DTR

Fichier pivot

Simple : les données à importer sont dans le fichier principal au format XML

Fichier compagnon

Oui, format XML contenant les données du devis

Fichier trace

Oui

Règles de gestion

  • Tous les champs saisissables en devis travaux peuvent être déclarés dans le fichier XML d’import

  • Les données du devis sont dans le fichier compagnon principal

  • Possibilité d’importer une arborescence dans le devis (chapitre et poste) en utilisant le champ CE1 (valeur 2 pour un chapitre, valeur 1 sinon)

  • Une seule balise IMPORT par fichier, donc un seul entête de devis par fichier

  • Des fichiers joints au devis peuvent être importés

Détails du fichier pivot

Le tableau suivant indique le format de balisage XML attendu

Les types traités sont :

  • valeurChaine indique une valeur de type chaîne de caractères alphanumériques

  • valeurDate indique une valeur de type date au format YYYYMMDD

  • valeurNum indique une valeur numérique sans séparateur de milliers

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

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: IMPDTR pour indiquer qu’il s’agit d’un flux intégration devis travaux

<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

Le tableau suivant indique le format de balisage XML attendu

Les types traités sont :

  • valeurChaine indique une valeur de type chaîne de caractères alphanumériques

  • valeurDate indique une valeur de type date au format YYYYMMDD

  • valeurNum indique une valeur numérique sans séparateur de milliers

La colonne indique si la balise et sa valeur sont obligatoires ou non. 'Rec' signifie 'Recommandé' pour un traitement total automatique

Le traitement des texte et notes sont disponibles à partir de la version 10.6

Balise XML

Obligatoire

Observation

Balise XML

Obligatoire

Observation

<XML>

<Import table = "DTRENT" action="insert">

Oui

Balise principale entête devis travaux

<Field name="XXXX" value= "xxxx" />

Oui

Champs de DTRENT

Name = mnémonique du champ dans le dictionnaire

Value = valeur de la donnée

Liste des champs à renseigner obligatoirement : TICOD ; TIERS ; OP

<Joint value="doc/d1.png" natureJointCod='' motCle='DTRENT_IMG' />

Non

Fichiers joints du devis travaux.

Attribut value = chemin complet du fichier joint

natureJointCod = nature de fichier joint

<Text txttyp="1" txtformat="1" txtval=="Contenu texte" />

(A partir de la version 10.6)

Non

Textes et notes de l’entête

Txttyp :

·         1 : note de l’entête

·         2 : texte de l’entête

·         3 : texte du pied

Txtformat :

·         1 : texte

·         2 : rich text encodé en base 64

Txtval : contenu du texte

<Record table = "DTRMOUV ">Non

Sous-niveau DTRMOUV*

Non

Sous balise table. Une seule table possible : DTRMOUV 

</Import>

</XML>

 

 

 

 

 

Balise Record table=DTRMOUV

 

 

<Record table = "DTRMOUV">

Non

Balise mouvement devis travaux

Une balise <Record table= « DTRMOUV »> peut en contenir une ou plusieurs autres en sous niveaux, cela représente l’arborescence du devis travaux.

Un chapitre peut contenir des chapitres, des ouvrages, des articles. Un ouvrage peut contenir des ouvrages et des articles.

<Field name="XXXX" value="X" />

Oui

Champs de DTRMOUV

Liste des champs à renseigner obligatoirement : CE2 ; REF ; OUVCOD

<Text txttyp="1" txtformat="1" txtval=="Contenu texte" />

(A partir de la version 10.6)

Non

Textes et notes de l’entête

Txttyp :

·         1 : note du mouvement

·         2 : texte du mouvement

Txtformat :

·         1 : texte

·         2 : rich text encodé en base 64

Txtval : contenu du texte

 

Exemples de fichiers

Exemple de fichier pivot pour création devis travaux (pivot_impdtr.dhub)

<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="IMPDTR"> <Source>EXTERNE</Source> <Dossier>998</Dossier> <Etablissement></Etablissement>     <FichierPrincipal>Dtr1.xml</FichierPrincipal> </DataHub>

 

Exemple de fichier principal de devis travaux simple avec 1 chapitre et 1 mouvement (Dtr1.xml)

<XML entity="IMPDTR"> <Import table = "DTRENT" action="insert"> <Field name="PIDT" value= "20200301" /> <Field name="PINOTIERS" value= "votre piece" /> <Field name="TIERS" value="C0000001" /> <Field name="TICOD" value="C" /> <Record table = "DTRMOUV"> <Field name="CE2" value="2" /> <Field name="DES" value="CHAPITRE 1" /> <Record table = "DTRMOUV"> <Field name="CE2" value="1" /> <Field name="REF" value="ALB0001" /> <Field name="DES" value="ALBUM avec désignation perso" /> <Field name="QTE" value="10.000" /> </Record> </Record> </Import> </XML>

 

Exemple de fichier principal de devis travaux avec plusieurs chapitres et poste (Dtr2.xml)

<XML entity="IMPDTR"> <Import table = "DTRENT" action="insert"> <Field name="PIDT" value= "20200501" /> <Field name="TICOD" value= "C" /> <Field name="TIERS" value= "C0000001" /> <Field name="OP" value= "C" /> <Field name="PINOTIERS" value= "TEST DATAHUB" /> <Record table = "DTRMOUV"> <Field name="CE2" value= "2" /> <Field name="DES" value= "Chapitre 1" /> <Record table = "DTRMOUV"> <Field name="CE2" value= "2" /> <Field name="DES" value= "Niveau 1" /> <Record table = "DTRMOUV"> <Field name="CE2" value= "1" /> <Field name="REF" value= "ALB0001" /> <Field name="QTE" value= "5,000" /> </Record> <Record table = "DTRMOUV"> <Field name="CE2" value= "1" /> <Field name="REF" value= "ALB0002" /> <Field name="QTE" value= "2,000" /> </Record> </Record> <Record table = "DTRMOUV"> <Field name="CE2" value= "2" /> <Field name="DES" value= "Niveau 2" /> <Record table = "DTRMOUV"> <Field name="CE2" value= "1" /> <Field name="REF" value= "ALB0001" /> <Field name="QTE" value= "3,000" /> </Record> </Record> </Record> <Record table = "DTRMOUV"> <Field name="CE2" value= "2" /> <Field name="DES" value= "Chapitre 2" /> <Record table = "DTRMOUV"> <Field name="CE2" value= "1" /> <Field name="REF" value= "ALB0001" /> <Field name="QTE" value= "2,000" /> </Record> </Record> <Record table = "DTRMOUV"> <Field name="CE2" value= "2" /> <Field name="DES" value= "Chapitre 3" /> <Record table = "DTRMOUV"> <Field name="CE2" value= "1" /> <Field name="REF" value= "ALB0001" /> <Field name="QTE" value= "2,000" /> </Record> <Record table = "DTRMOUV"> <Field name="CE2" value= "1" /> <Field name="REF" value= "ALB0001" /> <Field name="QTE" value= "2,000" /> </Record> </Record> </Import> </XML>

 

Exemple de fichier principal de devis travaux avec plusieurs chapitres et poste et fichier joints (Dtr3.xml)

 

Exemple de fichier principal de devis travaux avec ouvrages (Dtr4.xml)