Cada activo tiene un tipo (qué es), un código (un nombre corto y único que se usa en las rutas) y puede contener atributos (sus propios datos clave-valor). Esta página explica las reglas de cada uno y dónde importan.
Tipos
La lista Tipo del formulario de activo ofrece:
| Tipo | Uso típico |
|---|---|
| Site | Una planta, una estación, un depósito: un lugar de nivel superior con una ubicación |
| Building | Un edificio de un site |
| Floor | Una planta de un edificio |
| Room | Una sala, una cámara frigorífica, una sala de máquinas |
| Area | Una zona de una planta o de un patio |
| Line | Una línea de producción o de proceso |
| Machine | Una máquina o una pieza de equipo |
| Other | Cualquier otra cosa |
También puede usar su propio tipo: elija Another kind e escriba un Kind name, por ejemplo PUMP_STATION, TANK o KITCHEN. Un nombre de tipo tiene de 1 a 24 caracteres: primero una letra, después letras, dígitos y _. Se guarda en mayúsculas. Plant, Region, Zone y Depot también se muestran con un nombre traducido.
Un nuevo activo de nivel superior empieza como Site; un nuevo hijo empieza como Building. Cámbielo antes de guardar.
Dónde importa el tipo
| Lugar | Efecto |
|---|---|
| Sites & Assets | La insignia de tipo y el filtro Kind |
| Plantilla de panel Sites | «Sites» son activos de tipo Site; The sites of one type los reduce aún más |
| Tablas de desglose (Status under an asset) | Only nodes of these kinds y Only nodes with a node of these kinds below filtran por tipo, por ejemplo ROOM,FLOOR |
| Tinte de estado en 3D | Los elementos se tiñen según los activos Room y Area, emparejados por código |
| Flujos (Related data) | El ajuste kinds conserva solo los activos de los tipos indicados, por ejemplo el SITE tres niveles arriba |
| Soluciones listas | Algunas usan sus propios tipos, por ejemplo zonas de tipo ZONE en el seguimiento de personal |
Los tipos no limitan el árbol: cualquier tipo puede estar bajo cualquier otro.
Códigos
El Código nombra un activo en su ruta. Reglas:
| Regla | Detalle |
|---|---|
| Caracteres | letras, dígitos, ., _, -; el primero es una letra o un dígito; nunca / |
| Longitud | De 1 a 32 |
| Mayúsculas | Se guarda en mayúsculas: bld-a se convierte en BLD-A |
| Único | Entre los activos de su organización: «Another asset already uses this code.» |
| Vacío | Se genera a partir del nombre: sin acentos, en mayúsculas, otros caracteres convertidos en -, como máximo 24 caracteres, y -2, -3, … si ya está en uso. «Compressor room» se convierte en COMPRESSOR-ROOM. |
La ayuda del formulario: «Letters, digits, . _ – (at most 32). Leave empty to derive it from the name; changing it later rewrites the paths below.»
Rutas
La Path de un activo son los códigos desde arriba hacia abajo, unidos por /:
/IST/BLD-A/GF/COMPRESSOR-ROOMLa ruta se muestra en Overview del panel lateral y se usa para encontrar todo lo que hay bajo un activo. Cambiar un código reescribe en el mismo paso las rutas de todos los activos inferiores. Una ruta puede tener como máximo 1.024 caracteres.
Elija códigos duraderos
- Use códigos cortos y estables: un número de site, una letra de edificio, un número de sala (
IST,BLD-A,R101). - En las escenas 3D, las salas y áreas se emparejan con los elementos de la escena por código. Si cambia un código, cambie también la clave del elemento.
- Escriba los códigos en cualquier forma: se guardan en mayúsculas, así que
r101yR101son el mismo código.
Atributos
Los atributos son sus propios datos clave-valor de un activo: un área, un centro de costes, un número de contrato, una dirección de imagen de plano. La sección Attributes del panel lateral los muestra, solo de lectura. Se escriben a través de la 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 con attributes reemplaza todo el objeto de atributos: envíe cada clave que quiera conservar. Véase Sites and assets API.
| Regla | Valor |
|---|---|
| Claves | primero una letra, después letras, dígitos, ., _, -; hasta 64 caracteres |
| Número de claves | como máximo 100 |
| Tamaño | como máximo 16 KiB de JSON en total |
| Valores | números, texto, booleanos, objetos, listas |
Dónde se usan los atributos
- Boards: la consulta One asset (nombre, tipo, recuentos, atributos) los muestra, por ejemplo en la cabecera de un site.
- Flows: el bloque Related data lee los atributos de un activo, por ejemplo la tarifa del site en el que está un contador. Véase IoT data blocks.
- Ready solutions: por ejemplo la imagen de plano de una región de sensores, o la baliza de una zona de seguimiento de personal.
Los activos no almacenan telemetría. Los valores en vivo pertenecen a los dispositivos; un activo muestra los valores y el estado de los dispositivos que tiene debajo.
Otros campos
| Campo | Se define en | Uso |
|---|---|---|
| Description | Formulario | Hasta 1.000 caracteres, se muestra en el panel lateral |
| Time zone, Latitude, Longitude | Formulario | Véase Locations and time zones |
Dirección (addressJson) | API | Hasta 12 campos de texto; la cabecera de página de un site lo muestra cuando el site no tiene activos por encima |
Panel predeterminado (defaultDashboardId) | API | El botón Open dashboard del panel lateral lo abre |