Types d’actifs, codes et attributs

Chaque actif a un type (ce qu’il est), un code (un nom court et unique utilisé dans les chemins) et peut contenir des attributs (vos propres données clé-valeur). Cette page explique les règles de chacun et l’endroit où elles comptent.

Types

La liste Type du formulaire d’actif propose :

Type	Usage courant
Site	Une usine, une station, un dépôt : un lieu de premier niveau avec une localisation
Bâtiment	Un bâtiment d’un site
Étage	Un étage d’un bâtiment
Pièce	Une pièce, une chambre froide, un local technique
Zone	Une zone d’un étage ou d’une cour
Ligne	Une ligne de production ou de process
Machine	Une machine ou un équipement
Autre	Tout le reste

Vous pouvez aussi utiliser votre propre type : choisissez Autre type et saisissez un Nom de type, par exemple PUMP_STATION, TANK ou KITCHEN. Un nom de type comporte de 1 à 24 caractères : une lettre en premier, puis des lettres, des chiffres et _. Il est enregistré en majuscules. Plant, Region, Zone et Depot s’affichent également avec un nom traduit.

Un nouvel actif de premier niveau démarre comme Site ; un nouvel enfant démarre comme Bâtiment. Modifiez-le avant d’enregistrer.

Où le type compte

Emplacement	Effet
Sites & Assets	Le badge de type et le filtre Type
Modèle de tableau Sites	Les « sites » sont des actifs de type Site ; Les sites d’un type les restreint davantage
Tableaux de détail (Statut sous un actif)	Uniquement les nœuds de ces types et Uniquement les nœuds avec un nœud de ces types en dessous filtrent par type, par exemple `ROOM,FLOOR`
Teinte de statut en 3D	Les éléments sont teintés à partir des actifs Pièce et Zone, associés par code
Flux (Données associées)	Le paramètre kinds ne conserve que les actifs des types indiqués, par exemple le `SITE` trois niveaux au-dessus
Solutions prêtes à l’emploi	Certaines utilisent leurs propres types, par exemple les zones de type `ZONE` dans le suivi du personnel

Les types ne limitent pas l’arborescence : n’importe quel type peut se trouver sous n’importe quel autre.

Codes

Le Code désigne un actif dans son chemin. Règles :

Règle	Détail
Caractères	lettres, chiffres, `.`, `_`, `-` ; le premier est une lettre ou un chiffre ; jamais `/`
Longueur	1 à 32
Casse	Enregistré en majuscules : `bld-a` devient `BLD-A`
Unique	Parmi les actifs de votre organisation : « Un autre actif utilise déjà ce code. »
Vide	Généré à partir du nom : accents supprimés, majuscules, autres caractères remplacés par `-`, 24 caractères au maximum, plus `-2`, `-3`, … si déjà pris. « Compressor room » devient `COMPRESSOR-ROOM`.

L’indication du formulaire : « Lettres, chiffres, . _ – (32 maximum). Laissez vide pour le générer à partir du nom ; le modifier ensuite réécrit les chemins ci-dessous. »

Chemins

Le Chemin d’un actif correspond aux codes du haut vers le bas, reliés par / :

/IST/BLD-A/GF/COMPRESSOR-ROOM

Le chemin s’affiche dans la Vue d’ensemble du panneau et sert à retrouver tout ce qui se trouve sous un actif. Modifier un code réécrit en une seule étape les chemins de tous les actifs situés en dessous. Un chemin peut comporter au maximum 1 024 caractères.

Choisissez des codes durables

Utilisez des codes courts et stables : un numéro de site, une lettre de bâtiment, un numéro de pièce (IST, BLD-A, R101).
Dans les scènes 3D, les pièces et les zones sont associées aux éléments de scène par leur code. Si vous renommez un code, renommez aussi la clé de l’élément.
Saisissez les codes dans la casse de votre choix : ils sont enregistrés en majuscules, donc r101 et R101 désignent le même code.

Attributs

Les attributs sont vos propres données clé-valeur sur un actif : une zone, un centre de coûts, un numéro de contrat, l’adresse d’une image de plan. La section Attributs du panneau les affiche en lecture seule. Vous les écrivez via l’API :

PATCH /tenant/<tenantId>/api/iot/assets/<assetId>
{ "attributes": { "area_m2": 42, "cost_centre": "CC-4410", "contract": { "number": "M-77", "until": "2027-06-30" } } }

Un PATCH avec attributes remplace tout l’objet d’attributs : envoyez chaque clé que vous voulez conserver. Voir API des sites et actifs.

Règle	Valeur
Clés	une lettre en premier, puis lettres, chiffres, `.`, `_`, `-` ; jusqu’à 64 caractères
Nombre de clés	100 au maximum
Taille	16 Kio de JSON au maximum au total
Valeurs	nombres, textes, booléens, objets, listes

Où les attributs sont utilisés

Tableaux : la requête Un actif (nom, type, compteurs, attributs) les affiche, par exemple dans l’en-tête d’un site.
Flux : le bloc Données associées lit les attributs d’un actif, par exemple le tarif du site où se trouve un compteur. Voir Blocs de données IoT.
Solutions prêtes à l’emploi : par exemple l’image de plan d’une région de capteurs, ou la balise d’une zone de suivi du personnel.

Les actifs ne stockent pas de télémesure. Les valeurs en direct appartiennent aux appareils ; un actif affiche les valeurs et le statut des appareils qui se trouvent sous lui.

Autres champs

Champ	Défini dans	Usage
Description	Formulaire	1 000 caractères au maximum, affichée dans le panneau
Fuseau horaire, Latitude, Longitude	Formulaire	Voir Localisations et fuseaux horaires
Adresse (`addressJson`)	API	12 champs texte au maximum ; l’en-tête de page d’un site l’affiche lorsque le site n’a aucun actif au-dessus de lui
Tableau de bord par défaut (`defaultDashboardId`)	API	Le bouton Ouvrir le tableau de bord du panneau l’ouvre