Décomissionner un asset
Le décomissionnement permet d'indiquer qu'un équipement n'est plus en service, par exemple lors de son remplacement ou d'indiquer qu'un logement ou bâtiment n'existe plus ou qu'il ne vous appartient plus, démolition ou vente.
Le décommissionnement peut être vu comme un archivage de l'asset. Il sera toujours accessible sur les interfaces web et mobile ainsi que par l'API.
Cas d'usage gestionnaire : Le bâtiment A vient d'être vendu, je n'en suis plus le gestionnaire. J'effectue une requête de décomissionnement (PATCH) sur chaque asset du bâtiment.
Cas d'usage prestataire : Je remplace une chaudière individuelle pour le compte de mon client. J'effectue une requête de décomissionnement (PATCH) pour indiquer que l'équipement 1 n'est plus en service, je viens de le démonter. J'effectue ensuite une requête de création (POST) pour créer l'équipement 2 que je viens de poser et mettre en service.
Fonctionnement
Le décomissionnement se fait unitairement asset par asset. Si je décomissionne un bâtiment, les équipements et logements qui lui sont attachés ne sont pas décomissionnés automatiquement.
Le décomissionnement utilise le même type d'appel API que la modification, à savoir un PATCH sur l'API Assets. Il est fortement déconseillé d'inclure le décomissionnement dans la même requête de modification des informations d'un asset. Une requête spécifique pour le décomissionnement est donc fortement conseillé car elle représente une action spécifique.
Une fois la date de décomissionnement passée, il n'est plus possible de faire de modification sur l'asset, de lui ajouter des flux de données, d'y publier des interventions ou d'y ajouter des documents. Si toutefois vous avez indiqué par erreur une date de décomissionnement, vous pouvez la supprimer et l'asset redeviendra "actif".
Méthodes
PATCH /api/assets/v1/assets/{reference}
{"tags": [{"operation": "add","name": "intent_decommissioning_date","value":"2020-07-01T10:00:00"}]}
Supprimer une date de décomissionnement
{"tags": [{"operation": "remove","name": "intent_decommissioning_date"}]}
Rendu visuel intentPlatform
Lorsqu'un asset est décomissionné sur intentPlatform, il apparait en "grisé"
