Tipos de activos

Los tipos de activos en RealityTwin son plantillas predefinidas que se usan para definir el conjunto de propiedades que un activo tendrá al crearse. Al asignar un tipo de activo a un activo, todas las propiedades predefinidas asociadas se vinculan automáticamente, garantizando la coherencia y habilitando potentes capacidades de búsqueda y filtrado. Por ejemplo, si “Bomba” se define como un tipo de activo, más tarde podrías buscar todas las bombas de tu proyecto simplemente filtrando por ese tipo.

---

Configurar tipos de activos y categorías

Para configurar los tipos de activos:

1. Ve a Organization settings → Asset settings

2. Crea un nuevo tipo de activo/categoría o edita uno existente.

3. Después de hacer los cambios, haz clic en Publish para aplicarlos.

Categorías

Los tipos de activos se pueden agrupar en categorías para una mejor organización.
Las categorías son puramente estructurales: no tienen propiedades por sí mismas, pero ayudan a organizar los tipos de activos relacionados.

Ejemplo:

• Mecánica (Categoría)

  • Bomba (Tipo de activo)

  • Motor (Tipo de activo)

  • Válvula (Tipo de activo)

Puedes crear una nueva categoría pulsando el botón “New” en la parte superior derecha de la página de tipos de activos.

Organizar las propiedades en secciones

Dentro de un tipo de activo, las propiedades se pueden agrupar en secciones para mejorar la claridad y la entrada de datos.
Cada sección puede contener una o más propiedades relacionadas.

Ejemplo:

• Identificación:

• Especificaciones técnicas

• Monitoreo e instrumentación

• Mantenimiento y ciclo de vida

Definición de propiedades

Cada propiedad definida en un tipo de activo incluye:

• Key — El nombre/identificador de la propiedad.

• Value Type — El formato de los datos que contendrá la propiedad, como:

  • Número (consulta más detalles más abajo)

  • Texto corto

  • Adjunto

  • Enlace URL

  • Interruptor (booleano)

  • Menú desplegable (opciones predefinidas, consulta más detalles más abajo)

  • Campo de integración (vinculado a un sistema externo)

Nota

Los tipos de activos no almacenan los valores reales de estas propiedades.
Solo definen la estructura. Los valores se proporcionan cuando se crea un activo en RealityTwin y se le asigna un tipo de activo.

Configurar unidades para campos numéricos

Al crear una nueva propiedad con el Value Type establecido en Number, puedes definir opcionalmente unidades.

• El campo de unidades es un campo de texto libre donde puedes introducir cualquier etiqueta (por ejemplo, mm, °C, kg).

• La definición de la unidad forma parte de la configuración del tipo de activo y se aplica a todos los activos que usan ese tipo.

• Las unidades actúan como un sufijo cuando el valor se muestra en el panel de metadatos del activo.

Configurar las opciones del menú desplegable

Al crear una nueva propiedad con el Value Type establecido en Dropdown, aparecerá un panel en el lado derecho de la pantalla que te permitirá definir las opciones del menú desplegable.

• Introduce cada opción en una línea separada (pulsa Enter después de cada entrada).

• Puedes volver a editar estas opciones en cualquier momento haciendo clic en el menú de desbordamiento junto a la propiedad y seleccionando Edit dropdown options.

Conectar propiedades con una integración externa

Al igual que en la configuración regular de tipos de activos, es posible crear secciones de datos, o campos individuales, que se asignan a consultas de integración. La idea general es que, cada vez que se carga un activo de un tipo específico, se generará un conjunto de consultas de integración si existen enlaces. Cuando se ejecutan las consultas de integración, el resultado se organizará en secciones o campos dentro del tipo de activo.

Antes de asignar propiedades en los tipos de activos, la integración ya debe estar completamente configurada. Esto incluye configurar el servidor de integración y establecer una conexión con el sistema externo.

Para obtener instrucciones paso a paso, consulta nuestra Documentación de configuración de integraciones.

Acerca de las secciones y campos de integración

Los tipos de activos admiten integraciones para vincular y rellenar automáticamente propiedades desde sistemas externos (por ejemplo, ERP, CMMS). Hay dos formas principales de configurar las integraciones: Section from integration e Integration field.

Es posible asignar una sección entera de una consulta de integración a una sección de un tipo de activo. Por ejemplo, una consulta que devuelve este objeto:

{
  "TankLevel": {
    "value": 73.84190097508079,
    "uom": "%",
    "_p3d_type": "urn:primitive:obj:numeric"
  },
  "TankTemperature": {
    "value": 89.4061043417307,
    "uom": "degC",
    "_p3d_type": "urn:primitive:obj:numeric"
  }
}

Se puede asignar automáticamente a una sección de un tipo de activo para que se vea así:

Si es necesario, también se puede extraer un solo valor de una consulta y asignarlo a un solo campo. Por ejemplo, una consulta que podría devolver una presión de 834 se puede representar así, y mezclarse con los campos regulares del tipo de activo:

Secciones de configuración desde una integración

Puedes crear una sección entera que se obtiene directamente de una integración:

• Selecciona From Integration al añadir una nueva sección.

• Elige el Integration Link deseado.

• Introduce el JSONPath para definir qué parte de la carga útil de la integración debe vincularse a esta sección (consulta Asignación de JSONPath para más detalles).

• La sección se rellenará automáticamente con todas las propiedades recuperadas de la integración vinculada.

• Cualquier actualización de la integración se reflejará en los datos del activo según la configuración de sincronización.

Campos de integración de configuración

En lugar de importar una sección entera, puedes asignar propiedades individuales a una integración:

• Añade una nueva propiedad y establece el Value Type en Integration field.

• Elige el Integration Link deseado.

• Introduce el JSONPath para definir qué parte de la carga útil de la integración debe vincularse a esta sección (consulta Asignación de JSONPath para más detalles).

• Solo esa propiedad se sincronizará con el sistema externo.

Asignación de JSONPath

Tanto las secciones From Integration como los Integration fields requieren un JSONPath para seleccionar datos de la carga útil JSON devuelta por el Integration Link.

• From Integration (JSONPath a nivel de sección):
  Introduce un JSONPath que resuelva al objeto que quieres vincular a toda la sección.
  Ejemplo: $.Identification vincula todo el objeto Identification de la carga útil a tu sección del tipo de activo.

• Integration fields (JSONPath a nivel de propiedad):
  Introduce un JSONPath que resuelva a un único valor escalar (cadena/número/booleano/fecha).
  Ejemplo: $.Identification.serialNumber

Reglas y consejos

• JSONPath sigue la sintaxis estándar (hay más información sobre la sintaxis de JsonPath disponible en el RFC oficial)

• Prevu3D no admite objetos complejos ni arreglos para campos individuales. Si tu ruta devuelve un objeto/arreglo, refínala a un solo valor (por ejemplo, $.items[0].name) o cambia a una sección From Integration si necesitas un objeto completo.

• Asegúrate de que el JSONPath coincida con la estructura de la carga útil de tu integración; de lo contrario, el campo/sección vinculado aparecerá vacío.

Advertencia

Si el esquema de tu integración cambia, revisa y actualiza el JSONPath para mantener las asignaciones sincronizadas.

Publicar cambios

Publicar cambios afectará inmediatamente a todos los RealityAssets existentes que usen ese tipo de activo.

Por ejemplo:

• Renombrar una propiedad la actualizará para todos los activos vinculados.

• Eliminar una propiedad eliminará su valor de todos los activos vinculados.

Precaución

Procede con cuidado para evitar la pérdida involuntaria de datos.

Control de acceso

De forma predeterminada, solo los Super Admins pueden gestionar los tipos de activos.
Mediante la personalización de roles, estos privilegios administrativos se pueden conceder a miembros adicionales si es necesario.

Beneficios de usar los tipos de activos

• Coherencia — Todos los activos del mismo tipo comparten la misma estructura de propiedades.

• Capacidad de búsqueda — Permite consultas como “Muéstrame todas las bombas”.

• Organización — Las categorías y las secciones mantienen la información clara y accesible.

• Escalabilidad — Actualiza con facilidad las definiciones de propiedades para todos los futuros activos de un tipo.