Editor visual
Diseña reglas de automatización en el lienzo BPMN visual de Kilo IoT — arrastra nodos, dibuja flujos, configura cada paso en el panel.
El editor visual es donde diseñas flujos de trabajo de automatización. Presenta un lienzo BPMN 2.0 donde colocas nodos, los conectas con flujos y configuras cada paso mediante un panel de propiedades.
Este es un editor centrado en lo visual, no un generador de reglas solo de arrastrar y soltar. La mayor parte del trabajo ocurre mediante la colocación de nodos y campos de formulario, mientras que CEL se usa en campos de expresión específicos donde la regla necesita lógica precisa.
Cómo llegar
El editor se abre cuando:
Haz clic en Añadir regla para crear una nueva regla (en
/rules/create)Haz clic en Editar en una regla de la lista de Reglas (en
/rules/:id/edit/editor)Cambia el selector de modo de Visualización a Edición mientras visualizas una regla
Diseño del editor
El editor tiene cuatro áreas principales:
Barra de herramientas / Paleta — A la izquierda. Contiene tipos de nodos arrastrables y herramientas del lienzo.
Lienzo — El área central. Tu diagrama BPMN vive aquí.
Panel de propiedades — A la derecha. Se abre cuando seleccionas un nodo y muestra sus campos de configuración.
Barra de encabezado — En la parte superior. Muestra el nombre de la regla, el selector de modo, el estado de guardado automático y los botones de acción.
Paleta
La paleta proporciona herramientas y elementos arrastrables que puedes colocar en el lienzo.
Herramientas
Herramienta mano
Desplaza el lienzo sin seleccionar nada
Herramienta lazo
Dibuja un cuadro de selección alrededor de varios elementos
Herramienta espacio
Crea o elimina espacio entre elementos
Herramienta de conexión global
Dibuja una conexión (flujo) entre dos nodos
Elementos arrastrables
Evento de inicio
Punto de entrada de la regla: comienza desde un sensor de un dispositivo o una condición de activación guardada. Se coloca uno automáticamente en una regla nueva.
Evento de fin
Termina una ruta de flujo
Compuerta exclusiva
Punto de decisión: enruta a una rama según las condiciones
Tarea de script
Evalúa una expresión CEL para transformar o clasificar datos
Establecer alarma
Activa una definición de alarma con un mensaje dinámico
Ejecutar comando
Envía un comando a un dispositivo cuando se activa la regla: controla el hardware, no solo genera una alerta
Enriquecimiento
Recupera la lectura más reciente de otro sensor
Evento de error de borde
Se adjunta a una tarea para capturar errores y enrutar a una ruta de respaldo
Arrastra un elemento desde la paleta al lienzo para añadirlo. Cada tipo de elemento y su configuración completa se documentan en Referencia de nodos.
Trabajar con el lienzo
Añadir nodos
Arrastra elementos desde la paleta al lienzo. Colócalos en el orden en que quieres que se ejecute la regla.
Conectar nodos
Usa la Herramienta de conexión global desde la paleta, o pasa el cursor sobre un nodo hasta que aparezcan los tiradores de conexión, luego arrastra de un nodo a otro. Esto crea un flujo de secuencia — una flecha que muestra el orden de ejecución.
Reglas para las conexiones:
Los eventos de inicio y los nodos de tarea pueden tener un flujo saliente
Las compuertas exclusivas pueden tener varios flujos salientes (uno por rama)
Todo flujo de una compuerta (excepto el predeterminado) debe tener una expresión de condición
Los eventos de fin no tienen flujos salientes
Seleccionar y configurar nodos
Haz clic en un nodo para seleccionarlo. El panel de propiedades se abre a la derecha y muestra campos específicos de ese tipo de nodo. Configura el nodo y luego haz clic en Guardar en la parte inferior del panel de propiedades para aplicar tus cambios.
Eliminar nodos
Selecciona un nodo y pulsa la tecla Supr, o usa el menú contextual para eliminarlo. Eliminar un flujo de compuerta requiere confirmación, ya que también elimina la conexión correspondiente del lienzo.
Panel de propiedades
Cada tipo de nodo tiene su propio panel de propiedades con campos específicos. Cuando haces clic en un nodo, el panel se abre en el lado derecho del editor.
Campos comunes en la mayoría de los tipos de nodo:
Nombre — Una etiqueta descriptiva para el nodo
Muchos tipos de nodo también exponen secciones de Entradas y Salidas basadas en CEL para un modelado avanzado de datos. Los campos específicos de cada nodo se tratan en detalle en Referencia de nodos.
Después de editar las propiedades, haz clic en Guardar en la parte inferior del panel para aplicar los cambios. Haz clic en Cancelar para descartar.
Barra de encabezado
Nombre de la regla
Haz clic en el nombre de la regla en la parte superior para cambiarlo en línea (máx. 60 caracteres). El nombre se guarda cuando haces clic fuera o presionas Enter.
Selector de modo
Un menú desplegable que muestra el modo actual:
Edición — Acceso completo al lienzo y a las propiedades. Adquiere un bloqueo de edición.
Visualización — Vista de solo lectura del diagrama. No se adquiere ningún bloqueo.
Cambiar de Visualización a Edición adquiere el bloqueo de edición (si está disponible). Cambiar de Edición a Visualización navega a la ruta de solo lectura. Si tienes cambios sin guardar en el diagrama, la plataforma te pide que confirmes el desbloqueo de la regla y, en los flujos normales de salida, intenta persistir el último estado del diagrama antes de liberar el bloqueo.
Indicador de guardado automático
Muestra el estado actual del guardado:
Guardando... — Hay un guardado en curso (con indicador giratorio)
Guardado — Los últimos cambios se han guardado
Error en el guardado automático — El guardado automático falló. Un diálogo ofrece reintentar o volver atrás.
Menú de acciones
El menú de tres puntos (⋮) ofrece:
Cambiar nombre — Abre el editor de nombre en línea
Editar descripción — Abre un diálogo para editar la descripción de la regla (máx. 1.000 caracteres)
Duplicar regla — Crea una copia de la regla
Botones de acción
Guardar — Guarda manualmente el estado actual. Crea una nueva versión. Deshabilitado cuando no hay cambios sin guardar.
Compilar — Abre la barra lateral de compilación para validar y crear un artefacto de compilación. Consulta Compilaciones, artefactos y despliegue.
Pestañas
Cuando editas una regla existente, aparecen dos pestañas debajo del encabezado:
Editor — El lienzo BPMN (predeterminado)
Historial — La tabla del historial de versiones. Consulta Historial de versiones y restauración.
Estas pestañas solo se muestran mientras editas una regla existente guardada. No aparecen en el modo de visualización ni al crear una regla nueva sin guardar.
Última actualización