Partage d'un asset sur un contrat
Le partage d'asset permet de partager un asset avec un ou plusieurs tiers afin qu'il puisse récupérer ses informations et vous y transmettre des données (interventions, documents, alertes, etc.). Pour partager un asset, la modélisation d'un contrat est nécessaire. L'asset sera partagé sur un contrat qui a une date de début, une date de fin et votre/vos partenaire(s)
Cas d'usage gestionnaire
Initialisation d'un contrat : Je viens de contractualiser avec une société sur le marché de maintenance multi-technique. Sur le contrat qui nous lie, je lui partage le référentiel patrimoine dont il a la gestion.
Acquisition d'un nouveau bâtiment : Je viens d'acquérir un nouveau bâtiment. Celui-ci rentre dans le contrat de maintenance globale de mon prestataire multi-technique. Je viens compléter le périmètre du contrat en ajoutant le bâtiment au contrat.
Fonctionnement
Le partage se fait en indiquant, dans une requête PATCH assets, la référence de l'asset et la référence du contrat sur lequel l'asset doit être partagé.
Qu'est ce qui est partagé ?
- Lorsque vous partagez un asset de type bâti, vous le partagez ainsi que tous ses éléments parents, mais ses éléments fils. (cf image ci dessous - exemple vert et violet)
- Lorsque vous partagez un équipement, si l'équipement dispose d'un lien d'installation (
installationReference), l'équipement est partagé ainsi que ses éléments parents (cf image ci dessous - exemple jaune). Si l'équipement n'a pas de lien d'installation, uniquement l'asset équipement est partagé.
Quand partager un élément de patrimoine ?
Vous pouvez partager un asset :
- lors de sa création dans la requête création POST assets
- à tout moment avec une requête de modification PATCH assets
Méthodes
PATCH /api/assets/v1/assets/{reference}
{"contracts": [{"operation": "add","value": "contract1"}]}
ou dès sa création, en ajoutant
"contracts":["ref_contrat"]POST /api/assets/v1/assets
{"type": "building","category": "Logement","parentPath": "/01/BDR/01/09","code": "LOGEMENT_021","label": "Logement 2ème étage porte 1","tags": {"intent_type": "logement","intent_reference": "LOGEMENT_020","intent_commissioning_date": "2017-02-25T22:49:20+02:00","intent_address_way": "4 Rue Dubois de Fosseux","intent_address_city": "Arras","intent_address_country": "FR","intent_address_zip": "62000","intent_longitude": 2.7876941,"intent_latitude": 50.2916859,"intent_surface": 53,"intent_contacts": "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT ;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"","date de construction": "2017","type isolation": "laine de verre"},"contracts": ["contract1"]}
Rendu visuel sur intentPlatform
Lorsqu'un asset est partagé sur un contrat, vous pouvez le voir sur sa fiche détail dans l'encadré "Partages"
