Ir al contenido
JelinaJelina DocumentationDocumentación técnica
Volver al sitio oficial

Modelo de datos y grupos

Edge-EMS Builder clasifica los puntos en cuatro tipos y utiliza dataKey para conectar adquisición, cálculo, estrategias y uso compartido. Los scripts de negocio no necesitan operar directamente sobre registros de dispositivos.

Tipo Origen Usos habituales
Datos originales (Collection) Valores adquiridos y estado de comunicación de CommBridge Tensión, temperatura y estado del dispositivo; los puntos escribibles también permiten control
Datos agregados (Aggregation) Expresiones Lua o valores de ejecución almacenados Sumas de potencia, evaluación de estados y variables de ejecución
Datos por franjas horarias (Customization) Configuración manual o por estrategia con intervalos de vigencia Tarifas, modos de funcionamiento y curvas programadas
Datos compartidos (Share) Otros nodos EMS Builder Cálculo y control entre nodos

Los puntos compartidos se identifican mediante el código del dispositivo de origen y dataKey. La escritura en datos originales o compartidos depende finalmente de la capacidad de escritura y de los permisos del dispositivo de destino; no todos los puntos adquiridos son puntos de control.

Los puntos tienen nombre, alias y unidad, que se sincronizan al compartirlos. Los puntos originales pueden sincronizar el coeficiente de lectura de CommBridge. Si no se configura un coeficiente, o se trata de un punto de estado, el valor puede ser nulo.

CommBridge realiza la conversión inversa mediante coeficientes al escribir en puntos adquiridos; los scripts de Edge-EMS Builder y los clientes no deben repetirla. Los valores leídos y las consignas enviadas deben utilizar las unidades de ingeniería acordadas.

  • DAILY_CHANGE: cada valor entra en vigor durante un intervalo completo de fecha y hora.
  • DAILY_REPEAT: cada valor utiliza una franja diaria, mientras que la configuración define por separado el intervalo global de fechas de vigencia.

Por ejemplo, una tarifa diaria repetida puede fijar un precio de 08:00 a 12:00 y definir las fechas en las que se aplica todo el plan. Antes de sustituir un plan completo, revisa las franjas existentes y sus solapamientos.

Un punto agregado puede calcularse mediante una expresión o utilizar useLatestValue para conservar y leer un valor de ejecución. Al crear una variable de ejecución puede establecerse un valor inicial; si se genera mediante UDE, también puede utilizarse una plantilla de valor inicial.

Los datos ausentes se representan en las fórmulas mediante la cadena __Null__. Utiliza tonumber en cálculos numéricos y define explícitamente cómo tratar las ausencias para evitar confundirlas con cero. Consulta las funciones y ejemplos en Motor de expresiones.

Los cuatro tipos de puntos pueden incorporarse a grupos con relaciones padre-hijo. Es posible ordenar subgrupos y puntos, modificar la información básica y decidir qué hacer con los subgrupos al eliminar un grupo. Consultar o suscribirse a datos por grupo facilita organizar la interfaz por dispositivo, zona o finalidad.

Cuando se repiten muchos equipos del mismo tipo, las plantillas UDE pueden generar grupos y mapeos automáticamente.

Siguientes pasos: Consultas históricas, Esquemas de disparadores, Uso compartido entre dispositivos y Lectura y escritura desde la interfaz.