For the complete documentation index, see llms.txt. This page is also available as Markdown.

Motor de reglas

Motor de reglas BPMN visual — convierte los datos de sensores en alarmas, acciones y enriquecimiento con compilación y reversión seguras.

El motor de reglas es un sistema de automatización visual basado en BPMN (Business Process Model and Notation) para supervisar dispositivos IoT en tiempo real. Cuando los datos de los sensores cumplen las condiciones que defines, el motor actúa automáticamente — activando alarmas, enriqueciendo datos de otros sensores antes de tomar una decisión, y enviando comandos directamente de vuelta a tus dispositivos.

Esa última capacidad cambia lo que significa la automatización aquí. Una regla ya no solo avisa a una persona para que actúe — puede tomar la acción por sí misma, en el instante en que se cumple una condición. Un sensor de fuga solía disparar una alarma y una carrera hacia la válvula de cierre; ahora la misma regla cierra la válvula automáticamente y activa la alarma en la misma evaluación. Detectar, decidir, actuar — de extremo a extremo, sin nadie en el circuito. Ver Ejecución de comandos en dispositivos.

Cómo funciona

Las reglas son flujos de trabajo BPMN 2.0: diagramas de flujo visuales donde cada nodo realiza una tarea específica. Conectas los nodos con flujos (flechas) para construir la lógica. El motor ejecuta una regla desplegada cuando su Evento de inicio recibe la fuente seleccionada: ya sea una lectura de un sensor o una activación de una condición de disparo guardada.

A rule on the visual editor canvas — a Start event flowing into a Gateway that branches into two paths ending at End events

Cada regla sigue un ciclo de vida gestionado:

Los cambios que haces en el editor visual permanecen como borrador hasta que los compilas y despliegas explícitamente. El paso de compilación valida tu regla — comprobando la estructura del diagrama, verificando todas las expresiones y confirmando que cada ruta esté completa. Solo después de una compilación exitosa puedes desplegar la regla para comenzar a procesar su sensor seleccionado o fuente de disparador.

Qué puedes crear

Una regla comienza con un Evento de inicio. Elige Lectura del sensor para ejecutarla cada vez que un sensor seleccionado informe, o Condición de disparo para ejecutarla cuando una condición guardada se active para uno o más dispositivos. Un disparador puede actuar de inmediato o esperar a que la condición siga siendo verdadera. Cada vez que se activa la fuente seleccionada, la regla se ejecuta. Dentro de la regla, puedes:

  • Evaluar condiciones con Pasarelas exclusivas — redirigir el flujo a distintas ramas según expresiones CEL

  • Transformar datos con Tareas de script — calcular valores derivados, clasificar lecturas o preparar indicadores para decisiones posteriores

  • Obtener datos de otros sensores con nodos de enriquecimiento — comparar la temperatura interior frente a la exterior, correlacionar la humedad con la ocupación o comprobar una lectura de referencia antes de decidir

  • Generar alarmas con nodos de Establecer alarma — activar definiciones de alarma con mensajes de motivación dinámicos, iniciando políticas de escalado y notificaciones

  • Actuar sobre dispositivos con nodos Ejecutar comando — enviar un comando (cerrar una válvula, establecer un punto de consigna, conmutar un relé) directamente a un dispositivo cuando se cumplen las condiciones, de modo que la regla contenga el problema en lugar de solo informarlo. Ver Ejecución de comandos en dispositivos

  • Manejar errores con elegancia con Eventos de error de borde — si un paso falla (por ejemplo, un sensor está desconectado durante el enriquecimiento), capturar el error y dirigirlo a una ruta de respaldo en lugar de detener toda la regla

Todas las condiciones y los cálculos usan CEL (Common Expression Language) — un lenguaje de expresiones seguro y aislado, diseñado para evaluar condiciones. CEL no puede acceder a archivos, hacer llamadas de red ni ejecutar bucles. Solo evalúa expresiones sobre los datos que proporcionas.

Ese equilibrio es deliberado. La mayoría de las reglas del día a día se ensamblan arrastrando nodos al lienzo y rellenando formularios. CEL aparece en puntos concretos donde la regla necesita lógica precisa: condiciones de pasarela, Tareas de script, mensajes dinámicos de alarma, búsquedas de enriquecimiento y asignaciones de entrada/salida. A través de CEL, la lógica de la regla puede volverse muy sofisticada — condiciones anidadas, clasificaciones de severidad calculadas, cálculos de diferencias entre varios sensores y rutas de decisión dinámicas que van mucho más allá de simples alertas por umbral. No estás obligado a usar scripts arbitrarios, pero tampoco estás limitado a condiciones básicas de "si valor > X".

Seguridad y control

El motor de reglas está diseñado para entornos en los que los cambios de automatización no gestionados no son aceptables:

  • Bloqueos de edición — Solo una persona puede editar una regla a la vez. Las demás ven quién tiene el bloqueo y cuándo expira. Los propietarios de la organización pueden forzar el desbloqueo si es necesario.

  • Guardado automático — Tu trabajo se guarda automáticamente mientras editas, con retroalimentación visible del estado ("Guardando...", "Guardado", "Error del guardado automático").

  • Historial de versiones — Cada guardado crea una versión. Las versiones pueden renombrarse, consultarse y restaurarse. Si un cambio provoca un comportamiento inesperado, puedes revertir a cualquier versión anterior.

  • Compilar antes de desplegar — El paso de compilación detecta errores estructurales, expresiones inválidas y conexiones faltantes antes de que tu regla llegue a producción.

  • Artefactos — Cada compilación produce un artefacto con nombre con marcas de tiempo, autor y comentarios opcionales. La pestaña Artefactos muestra exactamente qué está desplegado en todas tus reglas.

  • Papelera y recuperación — Eliminar una regla la mueve a la papelera, no la borra permanentemente. Puedes restaurar reglas desde la papelera.

  • Seguridad de emergencia — El sistema supervisa el estado de ejecución de las reglas y detiene automáticamente las reglas que encuentran errores persistentes, evitando fallos en cascada.

Contenido de la sección

Página
Qué cubre

La página principal de Rules Engine — pestañas, acciones y cómo navegar

Cómo crear una nueva regla desde cero

Condiciones guardadas, temporización, selección de dispositivos y cómo conectar un disparador a una regla

El lienzo BPMN — paleta, panel de propiedades y barra de herramientas

Recorre una regla paso a paso antes de desplegarla — puntos de interrupción, variables, observaciones, efectos secundarios

Cada tipo de nodo con detalles de configuración y ejemplos

El nodo Ejecutar comando — haz que una regla actúe sobre un dispositivo, no solo alerte

Tipos, operadores y patrones del lenguaje de expresiones

Bloqueo, desbloqueo forzado, inactividad y guardado automático

Seguimiento de versiones, nombres, visualización y restauración

Compilación de reglas, pestaña Artefactos, despliegue y detención

Eliminación temporal, vista de la papelera y restauración de reglas

Patrones de automatización empresarial con ejemplos de CEL

Errores de compilación, problemas comunes y límites

Última actualización