Pour importer du patrimoine hiérarchique en masse, un fichier d'import au format .csv peut être utilisé.Un exemple est présenté ci-dessous. Le fichier d'exemple est disponible sur demande (serviceclient@intent.tech).
On retrouve dans le fichier d’import les 3 familles d'attributs :
Les path (cellule orange)
Les intent tags (cellule verte)
Les tags libres (cellule bleue)
path
path
path
path
path
path
path
path
path
path
tag
tag
tag
tag
tag
tag
tag
tag
tag
tag
tag
tag
tag
tag
tag
HO1
Agence
HP1
Résidence
HP2
Bâtiment
HP3
Entrée
UG
Logement
intent_reference
intent_type
intent_address_way
intent_address_zip
intent_address_city
intent_address_country
étage
porte
intent_surface
intent_latitude
intent_longitude
date_construction
niveau_amiante
logement_PMR
note_DPE
01
NORD
01
01
NORD
ALT
ALOUETTES
01-ALT
01
NORD
ALT
ALOUETTES
01
BAT 1
ALT-01
collective_residential_building
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
ALT-01-03
collective_residential_building
48.3216969
-4.299535
1990-12-01
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
20071
RdC, Porte 01
ALT-01-03-20071
dwelling
IMPASSE DES ALOUETTES
59000
LILLE
FRANCE
rdc
1
59.95
48.3216969
-4.299535
1990-12-01
1
PMR
C
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
20072
RdC, Porte 02
ALT-01-03-20072
dwelling
IMPASSE DES ALOUETTES
59000
LILLE
FRANCE
rdc
2
59.95
48.3216969
-4.299535
1990-12-01
1
C
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
20073
RdC, Porte 03
ALT-01-03-20073
dwelling
IMPASSE DES ALOUETTES
59000
LILLE
FRANCE
rdc
3
44.15
48.3216969
-4.299535
1990-12-01
1
C
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
20074
1er Etage, Porte 11
ALT-01-03-20074
dwelling
IMPASSE DES ALOUETTES
59000
LILLE
FRANCE
r+01
11
60.05
48.3216969
-4.299535
1990-12-01
3
C
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
20075
1er Etage, Porte 12
ALT-01-03-20075
dwelling
IMPASSE DES ALOUETTES
59000
LILLE
FRANCE
r+01
12
60.05
48.3216969
-4.299535
1990-12-01
3
C
01
NORD
ALT
ALOUETTES
01
BAT 1
03
ENT 3
20076
1er Etage, Porte 13
ALT-01-03-20076
dwelling
IMPASSE DES ALOUETTES
59000
LILLE
FRANCE
r+01
13
44.00
48.3216969
-4.299535
1990-12-01
3
C
01
NORD
BDR
BOIS ROCHE
01-BDR
01
NORD
BDR
BOIS ROCHE
04
BAT 4
BDR-04
collective_residential_building
01
NORD
BDR
BOIS ROCHE
04
BAT 4
09
ENT 9
BDR-04-09
collective_residential_building
9 RUE DU PARADIS
59118
WAMBRECHIES
FRANCE
48.377953
-4.297238
2010-09-16
01
NORD
BDR
BOIS ROCHE
04
BAT 4
09
ENT 9
30075
RdC, Porte A
BDR-04-09-30075
dwelling
9 RUE DU PARADIS
59118
WAMBRECHIES
FRANCE
rdc
A
68.35
48.377953
-4.297238
2010-09-16
2
PMR
A
01
NORD
BDR
BOIS ROCHE
04
BAT 4
09
ENT 9
30076
RdC, Porte B
BDR-04-09-30076
dwelling
9 RUE DU PARADIS
59118
WAMBRECHIES
FRANCE
rdc
B
41.70
48.377953
-4.297238
2010-09-16
1
PMR
A
01
NORD
BDR
BOIS ROCHE
04
BAT 4
09
ENT 9
30077
RdC, Porte C
BDR-04-09-30077
dwelling
9 RUE DU PARADIS
59118
WAMBRECHIES
FRANCE
rdc
C
67.10
48.377953
-4.297238
2010-09-16
1
PMR
A
01
NORD
BDR
BOIS ROCHE
04
BAT 4
09
ENT 9
30078
RdC, Porte D
BDR-04-09-30078
dwelling
9 RUE DU PARADIS
59118
WAMBRECHIES
FRANCE
rdc
D
68.50
48.377953
-4.297238
2010-09-16
3
A
01
NORD
BDR
BOIS ROCHE
04
BAT 4
09
ENT 9
30079
RdC, Porte E
BDR-04-09-30079
dwelling
9 RUE DU PARADIS
59118
WAMBRECHIES
FRANCE
rdc
E
41.70
48.377953
-4.297238
2010-09-16
3
A
Dans le fichier ci-dessus, il est modélisé l'import d'un patrimoine sur 5 niveaux hiérarchiques avec :
1 Agence (Nord)
2 Résidences (Alouettes et Bois Roche)
2 Bâtiments (BAT 1 et BAT 4)
2 Entrées (ENT 3 et ENT 9)
11 Logements
Le niveau 1 a pour code = HO1 et label = Agence. Le niveau 5 a pour code = UG et label = Logement.
Conseils pour construire son fichier
1ere étape : Déterminer le nombre de niveau hiérarchique. Si nécessaire vous souhaitez ajouter un niveau hiérarchique, ajouter 2 colonnes (code + label) par niveau hiérarchique supplémentaire. A l'inverse pour en retirer.
2ème étape : Compléter la ligne 2 du fichier pour les PATH en indiquant le nom de chaque code (ex: UG) et du label d’affichage (ex: Logement).
3ème étape : Si nécessaire, ajouter des colonnes à la fin du fichier pour créer vos tags libres. Le nom de la ligne 1 sera toujours “tag”. Indiquer le label de votre tag libre en ligne 2 (ex: niveau_amiante).
4ème étape : Remplissez les lignes de votre fichier. Chaque ligne du fichier correspond à la création d’un asset.
intent_reference : Cette référence est utilisée dans les APIs d’intentPlatform pour toute recherche, publication et association de données (cf API Reference). Elle correspond à la référence du bâti.
Remarque
1- Lors de sa création, si un élément hiérarchique n’a pas d’intent_reference, IntentPlatform lui attribuera son fullPath, c’est à dire la concaténation des références code des éléments parents et de la sienne.
2- Le champ intent_reference est indexé dans le moteur de recherche d’intentPlatform. Vous pourrez donc rechercher vos assets par leur référence.
Pour un logement, IntentPlatform ne prend pas automatiquement l’adresse de l’élément Parent. Si vous indiquez une adresse pour une Entrée ou un Bâtiment, elle ne sera pas automatiquement attribuée aux logements qui leur sont rattachés.
Caractères interdits
Les codes ne doivent pas contenir de "/"
Les labels ne doivent pas contenir de "/"
Les clés des tags ne peuvent pas contenir des "."
Nous déconseillons l'utilisation de caractère spéciaux (@;#;&;^;*,etc.) et d'espace.
Organisation de son fichier
Il est conseillé de construire son fichier de 2 manières :
En escalier
En groupant les références
En escalier : (méthode utilisé dans le fichier exemple ci-dessus)