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

Inclure pageUDI107:Dataset création de devis travaux (V10.5)UDI107:Dataset création de devis travaux (V10.5)

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
<?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

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" />	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" />	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)

Bloc de code

language	text

<?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)

Bloc de code

language	text

<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)

Bloc de code

language	text

<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)

Bloc de code

language	text

<XML entity="IMPDTR">
<Import table = "DTRENT" action="insert">
      <Joint value="C:\DIVALTO\Doc\1.png" natureJointCod='' motCle='DTRENT_IMG' />
      <Joint value="C:\DIVALTO\Doc\2.png" natureJointCod='' motCle='DTRENT_IMG' />
      <Field name="PIDT" value= "20200301" />
      <Field name="PINOTIERS" value= "Référence du tiers" />
      <Field name="TIERS" value="C0000001" />
      <Field name="TICOD" value="C" />
      <Record table = "DTRMOUV">
            <Field name="CE2" value="2" />
            <Field name="DES" value= "Chapitre1" />
            <Record table = "DTRMOUV">
                  <Field name="CE2" value="2" />
                  <Field name="DES" value= "Sous-Chapitre1" />
                        <Record table = "DTRMOUV">
                             <Field name="CE2" value="1" />
                             <Field name="REF" value= "ALB0001" />
                             <Field name="QTE" value= "2,000" />
                             <Field name="PCOD(1)" value="4" />
                        </Record>
                        <Record table = "DTRMOUV">
                             <Field name="CE2" value="1" />
                             <Field name="REF" value= "ALB0002" />
                             <Field name="QTE" value= "2,000" />
                             <Field name="PCOD(1)" value="4" />
                        </Record>
                  <Field name="DES" value="CHAPITRE 1" />
            </Record>
            <Record table = "DTRMOUV">
                  <Field name="CE2" value="2" />
                  <Field name="DES" value= "Sous-Chapitre2" />
                  <Record table = "DTRMOUV">
                        <Field name="CE2" value="1" />
                        <Field name="REF" value= "ALB0001" />
                        <Field name="QTE" value= "2,000" />
                        <Field name="PCOD(1)" value="4" />
                  </Record>
                  <Record table = "DTRMOUV">
                        <Field name="CE2" value="1" />
                        <Field name="REF" value= "ALB0002" />
                        <Field name="QTE" value= "2,000" />
                        <Field name="PCOD(1)" value="4" />
                  </Record>
                  <Record table = "DTRMOUV">
                        <Field name="CE2" value="2" />
                        <Field name="DES" value= "Sous-Chapitre2.1" />
                        <Record table = "DTRMOUV">
                             <Field name="CE2" value="1" />
                             <Field name="REF" value= "ALB0003" />
                             <Field name="QTE" value= "10,000" />
                             <Field name="PCOD(1)" value="4" />
                        </Record>
                        <Record table = "DTRMOUV">
                             <Field name="CE2" value="1" />
                             <Field name="REF" value= "ALB0004" />
                             <Field name="QTE" value= "20,000" />
                             <Field name="PCOD(1)" value="4" />
                        </Record>
                  </Record>
                  <Record table = "DTRMOUV">
                        <Field name="CE2" value="2" />
                        <Field name="DES" value= "Sous-Chapitre2.2" />
                  </Record>
            </Record>
      </Record>
</Import>
</XML>

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

Bloc de code

language	text

<XML entity="IMPDTR">
<Import table = "DTRENT" action="insert">
	<Field name="PIDT"  value= "20201217" />
	<Field name="TICOD"  value= "C" />
	<Field name="TIERS"  value= "C0000001" />
	<Field name="SITECOD"  value= "SIEGENEB" />
	<Field name="PINOTIERS"  value= "TEST DATAHUB" />
	<Field name="PIREF"  value= "VOTRE REFERENCE" />
	<Field name="OP" value="C" />	
	<Record table = "DTRMOUV">
		<Field name="CE2"  value= "2" />
		<Field name="DES"  value= "BATIMENT 1" />
		<Record table = "DTRMOUV">
			<Field name="CE2"  value= "2" />
			<Field name="DES"  value= "Bureau chargés d'affaires" />
			<Record table = "DTRMOUV">
				<Field name="CE2"  value= "1" />
				<Field name="OUVCOD"  value= "ENSEMBLE_14S" />
				<Field name="QTE"  value= "1" />
				<Field name="DES"  value= "Ensemble climatisation bureau des chargés d'affaires" />
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10001S" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10010S" />
					<Field name="QTE"  value= "2" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10051" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10061" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10062" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10085" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10084" />
					<Field name="QTE"  value= "1" />
				</Record>
			</Record>
		</Record>
		<Record table = "DTRMOUV">
			<Field name="CE2"  value= "2" />
			<Field name="DES"  value= "Bureau d'études" />
			<Record table = "DTRMOUV">
				<Field name="OUVCOD"  value= "ENSEMBLE_36S" />
				<Field name="QTE"  value= "1" />
				<Field name="DES"  value= "Ensemble climatisation bureau d'études" />
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10002S" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10011S" />
					<Field name="QTE"  value= "6" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10052" />
					<Field name="QTE"  value= "1" />
				</Record>
				<Record table = "DTRMOUV">
					<Field name="CE2"  value= "1" />
					<Field name="REF"  value= "IM10084" />
					<Field name="QTE"  value= "6" />
				</Record>
			</Record>
		</Record>
	</Record>
	<Record table = "DTRMOUV">
		<Field name="CE2"  value= "2" />
		<Field name="DES"  value= "Chapitre 2" />
	</Record>
</Import>
</XML>

Comparaison des versions

Ancienne version 6

Nouvelle version 7

Légende

Règles de gestion

Détails du fichier pivot

Détails du fichier principal

Exemples de fichiers

Comparaison de pages

Comparaison des versions

Ancienne version 6

Nouvelle version 7

Légende

Règles de gestion

Détails du fichier pivot

Détails du fichier principal

Exemples de fichiers