La migration permet de déplacer un asset bâti dans le hiérarchie patrimoniale.
Cas d'usage gestionnaire : J'ai une hiérarchie sur 6 niveaux (Société, Agence, Résidence, Bâtiment, Partie commune, Lot). Une résidence change d'affectation d'agence. Elle est maintenant gérée par une autre agence. J'effectue une requête de migration (PATCH) pour migrer l'asset sur la bonne agence.
Les équipements liés, flux, watched elements, sont censés être modifiés en conséquence d'une migration. En cas de partage les copies doivent être modifiées également.
En revanche les opérations ne sont pas modifiées pour l'instant, cela nécessite une tâche de support.
Fonctionnement
La migration s'effectue sur l'élément hiérarchique de plus haut niveau qui est à migrer. Les éléments fils, de l'élément migré, suivront automatiquement. Par exemple, si je migre la "résidence 1" sur l'agence 2, j'effectue 1 requête de migration de l'asset "résidence 1". Les bâtiments, parties communes et lots qui lui sont attachés suivront automatiquement.
La migration consiste à modifier le champ parentPath de l'élément à migrer et donc de lui attribuer un nouvel élément parent.
La migration 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 la migration dans la même requête de modification des informations d'un asset. Une requête spécifique pour la migration est donc fortement conseillé car elle représente une action spécifique.