Esquemas de disparadores

Los esquemas de disparadores organizan cuándo comprobar, qué condiciones evaluar y qué acciones ejecutar en reglas reutilizables.

Estructura del esquema

Un esquema puede contener varios disparadores, cada uno con condiciones y acciones. Las condiciones pueden combinarse mediante AND / OR. El esquema puede habilitarse o deshabilitarse y tener un intervalo global de fechas de vigencia.

Condición	Uso
CRON	Ejecución según una programación de calendario
TIME_POINT	Ejecución a una hora diaria concreta, combinable con el intervalo de fechas del esquema
TIME_PERIOD	Comprobación durante un periodo determinado
INTERVAL	Comprobación a intervalos fijos
DATA_CHANGE	Evaluación al cambiar un punto; admite datos compartidos

Los scripts de condiciones de datos devuelven un booleano. Comprueba explícitamente los datos ausentes o conviértelos primero con tonumber, para no tratarlos como observaciones válidas.

Acciones y valores de retorno

Las acciones pueden escribir en puntos escribibles, planes por franjas horarias, variables agregadas o dispositivos remotos, así como registrar alarmas, enviar observaciones de alarma y publicar MQTT.

Esquema o escenario	Retorno del script
Esquema EXPRESSION	Array de acciones con índice inicial 1
Escritura de un punto en MIXED	Valor único del punto correspondiente
Condición de cambio de datos	true / false

Por ejemplo, para actualizar una variable de ejecución agregada en una acción EXPRESSION:

return {buildGeneralWriteMap("Aggregation", "demo_state", "ready", false)}

Sustituye el punto de ejemplo por uno configurado realmente. La función solo construye una acción pendiente; no indica que el dispositivo la haya ejecutado correctamente.

Reglas de alarma

Las notificaciones sencillas pueden generar registros individuales. Cuando se necesita recuperación y seguimiento del tratamiento, utiliza eventos de alarma: informa continuamente de observaciones ACTIVE, NORMAL o UNKNOWN, no solo cuando haya una anomalía.

Posprocesamiento y registros de ejecución

Las acciones admiten posprocesamiento mediante needPostProcess / postProcessContent. La validación del script comprueba la estructura de retorno, pero también evalúa la expresión; revisa primero los efectos secundarios de scripts que contengan llamadas directas.

Los registros de disparadores permiten comprobar condiciones, resultados y errores. Al controlar equipos, consulta también los registros de control de dispositivos y la lectura posterior de puntos para distinguir entre una solicitud enviada y una ejecución real.

Dispositivos dinámicos y activación de esquemas

Las consultas por prefijo, sufijo y otros criterios permiten manejar cantidades variables de dispositivos. Las consultas por lotes devuelven tablas cuyas claves son dataKey; recórrelas con pairs(). Verifica que las dependencias estén completas cuando los patrones de consulta se construyan dinámicamente. El esquema permite configurar puntos afectados y mostrar sus valores actuales en los detalles para facilitar la comprensión de la estrategia.

Los esquemas deshabilitados, eliminados o fuera de vigencia descargan sus tareas de ejecución, y se comprueba el estado del esquema padre antes de ejecutar. Las órdenes ya enviadas al dispositivo siguen requiriendo verificación de su resultado. Limita la frecuencia de las estrategias rápidas cuando sea necesario para reducir envíos repetidos.

Consulta Referencia de acciones de disparadores y Referencia de Lua. Para configurar mediante un agente, utiliza la Skill de esquemas de disparadores.