Initialiser son patrimoine

Le patrimoine peut s'initialiser de plusieurs manière, par API ou par fichier CSV. Mais la manière la plus rapide reste la définition d'un fichier d'import initial à un format bien défini. Vous trouverez ci-dessous le guide pour créer ce fichier.

[Paramétrage] import du patrimoine Asset - Exemple (12).xlsx
3MB, Uploaded 11 months ago


Construire son fichier

Pour construire cette organisation, les colonnes “path” du fichier d’import de patrimoine sont utilisées pour décrire la hiérarchie patrimoniale sur Intent. 

- La première ligne porte les valeurs “path” pour indiquer qu’on traite l’arbre hiérarchique

- La deuxième ligne décrit l’arbre hiérarchique. Pour chaque paire de colonnes (A et B, C et D…),
-> la première colonne décrit le code du niveau
-> la deuxième colonne décrit l’intitulé du niveau. 

- Chaque ligne décrit ensuite un élément du patrimoine, par ex. ici : 
  • Ligne 3 : l’agence “LILLE” qui porte le code “1”
  • Ligne 4 : la résidence “OISEAUX” qui porte le code “ALT” et qui fait partie de l’agence “LILLE”
Il faut écrire autant de lignes qu’il y a d’éléments de patrimoine.



Référence d'un asset

intent_reference est la valeur unique qui décrit un élément de patrimoine sur Intent. La valeur intent_reference est obligatoire pour créer les éléments de manière explicite dans la plateforme, et pour tous les niveaux de patrimoine.
C’est une valeur unique qui est visualisée sur la fiche d’un élément, par ex. un logement : 

intent_reference est aussi la valeur pivot utilisée pour échanger des informations avec les prestataires. C’est aussi une donnée qui est indexée dans le moteur de recherche. 

C’est en général une valeur métier connue des utilisateurs d’Intent pour identifier le patrimoine. 

Par ex. cette intervention est localisée au niveau d’un logement, repéré par son intent_reference : 


Tags reconnus par IntentPlatform

Certaines données descriptives sont reconnues par IntentPlatform et alimentent des champs mis en avant sur l’interface, par exemple, l’adresse, la surface, le type.

Ces tags ne sont pas obligatoires, mais de part leur mise en avant et leur intérêt pour vos prestataires et autres services, il est fortement recommandé de les renseigner. 

Ils sont indexés et peuvent également être filtrables. Ils facilitent la navigation dans la plateforme.

Au sein du fichier d'import:

La première ligne du tableau d’import indique “tag”. 
La deuxième ligne indique le nom du tag “intent_xxx”. 
  • intent_type: type de l'asset
  • intent_address_way : voie
  • intent_address_complement : complément
  • intent_address_zip : code postal
  • intent_address_city : ville
  • intent_address_country : pays
  • intent_surface : surface
  • intent_latitude / intent_longitude : coordonnées GPS => si laissé vide, la localisation indiquée par IntentPlatform est l’adresse
  • intent_commisionning_date : date de livraison
Il est possible de laisser les cases vides si vous ne souhaitez pas renseigner d’information.

Contacts sur un élément de patrimoine

Pour les contacts, nous recommandons très fortement l'utilisation du format VCARD. Ce dernier est à privilégier car il améliore le rendu, rend possible l’appel direct sur mobile et le fonctionnement d'autres services comme les enquêtes de satisfaction.

Dans le fichier Excel d’import, pour 2 contacts sur un logement, le format de la cellule de la colonne intent_contacts sera par exemple :
BEGIN:VCARD
VERSION:3
FN;CHARSET=UTF-8:Pierre DUPONT
N;CHARSET=UTF-8:DUPONT ;Pierre
TEL;TYPE=WORK,VOICE:0734220902
TEL;TYPE=HOME,VOICE:0685874445
ADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France
ROLE;CHARSET=UTF-8:Gardien
END:VCARD
BEGIN:VCARD
VERSION:3
FN;CHARSET=UTF-8:Jack ROBERT
N;CHARSET=UTF-8:ROBERT ;Jack
TEL;TYPE=WORK,VOICE:0734220902
TEL;TYPE=HOME,VOICE:0685874445
ADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France
ROLE;CHARSET=UTF-8:Locataire
 EMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:j.robert@internet.fr 
END:VCARD


Tags libres

Les tags libres permettent de renseigner des données de description complémentaires sur chaque élément du patrimoine. Les intitulés et les valeurs sont libres. 

Des exemples : années de construction, coûts de construction, accès PMR, etc. 

Ces données sont indexées dans le moteur de recherche. Elles ne sont pas utilisées dans les filtres. 

Au sein du fichier d'import:

La première ligne du tableau d’import indique “tag”. 
La deuxième ligne porte les intitulés libres des tags.

Laisser les lignes vides pour les éléments qui n’ont pas les tags correspondants.