Aller au contenu principal

Les Assets, la brique de base de votre patrimoine

Cette section est un peu plus technique que le reste du guide, mais elle peut être très utile à ceux qui créent des maquettes numériques, par exemple dans Autodesk Revit, pour lequel nous avons développé un connecteur vers la plateforme sous la forme d'un add-in, et à ceux qui veulent créer les éléments de leur patrimoine par API.

Comme toute plateforme ou tout logiciel qui décrit un bâtiment, Stonal en représente les éléments : des niveaux, des pièces, des équipements… Mais chaque outil les conçoit à sa façon, selon ce qu'il cherche à apporter : un logiciel de conception, par exemple, les décrit pour concevoir et construire. C'est ce qui fait la valeur propre de chacun.

Notre plateforme, elle, décrit les éléments du bâti au service de ce qu'elle apporte : la gestion du patrimoine, sa maintenance, et les outils développés autour de ces processus. C'est pourquoi ses composants portent des caractéristiques pensées en ce sens. Dans le reste de ce guide, on les appelle des composants ; dans le langage de Stonal, on les appelle des Assets.

Dans cette section, nous garderons ce terme d'Asset, et nous montrerons à quoi il ressemble et dans quel format on le crée. Mais encore une fois, un Asset, c'est simplement un composant du patrimoine. Voici quelques exemples de nos Assets :

Quelques exemples d'Assets : Bâtiment, Niveau, Zone, Lot, Espace, Équipement… et bien d'autres.

Chaque Asset est une fiche unique dans la base de données de la plateforme. Ensemble, ces Assets constituent votre patrimoine.

Plusieurs sources alimentent un Asset​

Un Asset peut être créé, modifié ou supprimé par plusieurs sources :

  • une saisie manuelle dans la plateforme, depuis la fiche patrimoniale ou le DQC (contrôle des données) ;
  • une requête avec l'outil Requêteur ;
  • un relevé de terrain avec notre application EDIT ;
  • l'API Stonal ;
  • un import en masse depuis l'ERP du client ;
  • une maquette numérique Revit, avec l'Add-in Stonal Connector ;
  • et d'autres encore.

Les sources ne sont pas cloisonnées : une maquette Revit peut compléter des Assets créés par une autre source, par exemple importés depuis l'ERP ou saisis à la main dans la plateforme. Et inversement, un Asset créé depuis Revit peut ensuite être enrichi, modifié ou supprimé par une autre source.

Quelle que soit la source, le même Asset​

Qu'il soit saisi dans la fiche patrimoniale, importé par CSV ou créé depuis une maquette Revit, un Asset est toujours écrit de la même façon, dans un format appelé JSON.

Un format, c'est simplement une manière d'organiser des informations, comme le texte d'un document ou les colonnes d'un fichier CSV. Le JSON les écrit sous forme de texte, lisible à la fois par les logiciels et par les personnes : chaque information a un nom entre guillemets, suivi de sa valeur, et les accolades { } regroupent les informations qui vont ensemble.

Et pourtant, vous vous dites peut-être : « Je crée et je modifie des Assets, et je n'ai jamais vu ce JSON. J'appuie simplement sur des boutons, dans Revit pour créer mes éléments, ou dans les outils et les applications de la plateforme. Alors pourquoi en parler ? » Tout simplement parce que toutes ces applications savent écrire ce JSON à partir de vos actions, et l'envoyer à la plateforme, qui crée ou modifie alors l'Asset. C'est pareil pour Revit : c'est l'Add-in Stonal Connector qui se charge de convertir vos manipulations sur les éléments Revit en Assets, au format JSON. Regardons-le ensemble, pour comprendre comment cela fonctionne.

Pas de panique

Si vous n'avez jamais vu de JSON, ce format peut sembler inhabituel. Nous allons le décortiquer simplement et brièvement, en construisant ensemble, dans la section suivante, l'Asset d'une salle de bain avec ses différentes caractéristiques, simplifiées.

Afficher le JSON de la salle de bain
📄 Une salle de bain (exemple simplifié)
{
"type": "SPACE|SDB",
"uid": "4f2c9a1e-…-3a24",
"externalIds": {
"REVIT": "839dbc5b-…-002d76ad",
"ERP": "LGT101-SDB"
},
"properties": {
"simple": {
"DATE_RELEVE": "2026-03-12",
"ETAT_SOL": "Bon",
"COMMENTAIRE": "Joints à reprendre"
}
},
"parent": { "uid": "a00bcf8b-…" },
"groupedBy": [{ "uid": "77d1e3c0-…" }],
"representations": {
"outlines": [[
{"x":0,"y":0}, {"x":260,"y":0},
{"x":260,"y":170}, {"x":160,"y":170},
{"x":160,"y":240}, {"x":0,"y":240}
]]
}
}

Ce qui compose un Asset​

Chaque Asset est décrit par plusieurs caractéristiques : son type, ses identifiants, ses propriétés, ses relations avec les autres Assets et, optionnellement, une représentation. Construisons la salle de bain, une caractéristique à la fois.

Le type​

Le type dit ce qu'est l'Asset, du plus général au plus précis. D'abord SPACE : c'est un espace. Puis le sous-type SDB, plus précis : une salle de bain. Cliquez sur « Ajouter "type" » pour le lui donner.

Les identifiants​

Un Asset a toujours un identifiant unique, le uid, attribué par Stonal. Il peut aussi porter des identifiants externes (externalIds) qui le relient à vos autres outils : ici l'UniqueId de la pièce dans la maquette Revit, et son identifiant dans l'ERP du client. Cliquez sur « Ajouter "uid", "externalIds" » pour les lui donner.

Les propriétés​

Les propriétés (properties) décrivent l'Asset : ici la date du relevé, l'état du sol et un commentaire. Cliquez sur « Ajouter "properties" » pour les lui donner.

Les relations​

Les relations situent l'Asset parmi les autres. Son parent (parent) dit où il se trouve physiquement : ici le niveau R+1, qui contient la pièce. Ses groupes (groupedBy) sont des regroupements logiques : ici la zone Logement 101, qui regroupe plusieurs pièces. Cliquez sur « Ajouter "parent", "groupedBy" » pour les lui donner.

Un Asset alphanumérique​

Avec les quatre caractéristiques que nous venons d'ajouter, nous avons créé ce qu'on appelle un Asset alphanumérique, signalé par le symbole α dans la plateforme. Il est déjà pleinement utilisable, car il indique que ce composant existe dans votre patrimoine : il apparaît dans l'arborescence de sa résidence, avec toutes ses informations. On peut l'interroger avec le Requêteur, contrôler certaines de ses données avec le contrôle des données, le compléter sur le terrain avec EDIT, ou continuer à le faire évoluer avec d'autres sources. Ses informations sont faites de lettres et de chiffres : c'est pour cela qu'on parle d'Asset alphanumérique.

Dans l’arborescence, la salle de bain est rangée sous le bâtiment A, le niveau R+1 et la zone Logement 101. C’est un Asset alphanumérique : ses informations sont là, mais aucune représentation, elle n’est dessinée sur aucun plan.

Ce qui lui manque, en revanche, c'est un état graphique : sa forme et sa taille. C'est ce qui permet par exemple de le dessiner sur un plan, ou de faire sur lui des opérations et des calculs géométriques, comme calculer sa surface à partir de sa forme. Cet état graphique est bien sûr optionnel : certains clients n'ont qu'un patrimoine alphanumérique, et cela leur suffit. Voyons maintenant ce qui distingue un Asset alphanumérique d'un Asset graphique.

La touche finale : la représentation​

Un Asset graphique, c'est exactement le même Asset, avec une seule différence : il porte en plus une représentation, c'est-à-dire sa géométrie. Pour une pièce, c'est son contour. Cliquez sur « Ajouter "representations" » pour la lui donner et révéler le JSON complet.

Cette représentation fait l'objet de la page suivante : Les représentations.

Pour aller plus loin

Bien entendu, cette page simplifie plusieurs concepts : elle cherche à faire passer les idées générales, ce qu'est un Asset et ce qui le compose. Vous n'avez pas besoin d'écrire ce JSON vous-même, ni de le gérer : l'objectif est de comprendre, même sommairement, comment cela fonctionne derrière.

Pour aller plus loin, et pour ceux qui veulent par exemple créer des Assets directement au format JSON, pour utiliser l'API, la documentation de l'API est beaucoup plus précise sur ce sujet. Vous y trouverez par exemple l'arbre des relations entre Assets.