Documentación: Nodo Establecer Reconocimiento de Evento (Set Event Recognition)¶

Descripción General¶

El Nodo Establecer Reconocimiento de Evento (Set Event Recognition) es un nodo de acción que asigna automáticamente un estado de reconocimiento (recognition) a un evento del registro de la plataforma. El reconocimiento es la clasificación o gestión que normalmente un operador aplica manualmente a un evento (por ejemplo: Reconocido, Falsa Alarma, En progreso, Cerrado).

Este nodo permite automatizar la gestión de eventos: en lugar de que un operador deba marcar cada evento, el flujo puede asignar el reconocimiento adecuado según reglas lógicas, reduciendo la carga operativa y manteniendo el log de eventos ordenado.

¿Cuándo usar este nodo?¶

Utiliza este nodo cuando necesites:

Auto-reconocer eventos que cumplen ciertas condiciones (por ejemplo, marcar como Falsa Alarma eventos que un análisis con IA descartó).
Cambiar el estado de gestión de un evento como parte de un flujo de respuesta (marcar En progreso al iniciar un protocolo).
Cerrar automáticamente eventos resueltos por el propio sistema.
Mantener la trazabilidad y el orden del módulo de Eventos / Logs sin intervención manual.

Configuración del Nodo¶

El nodo cuenta con dos pestañas de configuración en la parte superior: Formulario (Form) y Editor de JSON (JSON Editor).

Configuración vacía del nodo Establecer reconocimiento de evento

Vista Formulario¶

1. ID del Evento (Event ID) *Requerido¶

El identificador del evento al que se le aplicará el reconocimiento. Lo habitual es referenciarlo dinámicamente desde un nodo anterior mediante una expresión de plantilla, por ejemplo {{trigger.event_id}} (el evento que disparó la automatización) o {{node_output.event_id}}.

El campo incluye además un botón New recognition que permite crear un nuevo tipo de reconocimiento si fuera necesario.

2. Reconocimiento (Recognition) *Requerido¶

Selecciona, del desplegable, el tipo de reconocimiento a aplicar. Los valores disponibles dependen de la configuración de la instalación; por ejemplo: Closed, Dismissed, False Alarm, Follow up, In progress, Pending, Recognized.

Formulario configurado del nodo Establecer reconocimiento de evento

Vista Editor de JSON¶

En la pestaña Editor de JSON (JSON Editor) puedes visualizar y editar directamente los parámetros del nodo:

Vista JSON Editor del nodo Establecer reconocimiento de evento

Estructura JSON (Parámetros de entrada)¶

A continuación se muestra la estructura del JSON que se genera al configurar el nodo:

{
  "event_id": "{{trigger.event_id}}",
  "recognizer_user_id": "e28aed72-c2b6-4671-9f52-21a7364fe9c8",
  "recognition": "recognized"
}

Campos del JSON¶

Campo	Tipo	Descripción
`event_id`	string	ID del evento a reconocer. Normalmente una expresión de plantilla (ej. `{{trigger.event_id}}`).
`recognizer_user_id`	string	ID del usuario al que se atribuye el reconocimiento. Se completa automáticamente con el usuario de la sesión.
`recognition`	string	Identificador del tipo de reconocimiento a aplicar (ej. `recognized`, `false_alarm`, `closed`).

Output: Dónde viene la data del nodo¶

Cuando la acción se ejecuta correctamente, el evento queda marcado con el reconocimiento indicado en el módulo de Eventos / Logs. El nodo finaliza marcado como exitoso (borde verde); el efecto es visible en la gestión del evento correspondiente.

Ejemplos de uso¶

Ejemplo 1: Descartar automáticamente falsas alarmas validadas por IA¶

Caso de uso: Un flujo analiza con IA la imagen asociada a un evento de movimiento. Si la IA determina que no hay personas (falsa alarma), el evento se marca automáticamente como False Alarm.

Event ID: {{trigger.event_id}}
Recognition: False Alarm

JSON de configuración:

{
  "event_id": "{{trigger.event_id}}",
  "recognition": "false_alarm"
}

Ejemplo 2: Marcar un evento como "En progreso" al iniciar un protocolo¶

Caso de uso: Cuando se dispara una alarma crítica y la automatización inicia el protocolo de respuesta (notificaciones, apertura de dashboard), el evento se marca como In progress para reflejar que está siendo atendido.

Recognition: In progress

Validación y errores¶

Condición	Causa / Solución habitual
`event_id` ausente o inválido	Asegúrate de referenciar un ID de evento válido (por ejemplo, desde el disparador o un nodo anterior).
`recognition` no seleccionado	Selecciona un tipo de reconocimiento del desplegable.
El evento no cambia de estado	Verifica que el `event_id` corresponda a un evento existente en el registro.

Buenas prácticas¶

Referenciar el evento dinámicamente: Usa {{trigger.event_id}} u otra expresión para que el nodo funcione con el evento real de cada ejecución.
Coherencia en los estados: Define una convención clara de qué reconocimiento aplicar en cada situación (descartado, en progreso, cerrado) para mantener el log consistente.
Combinar con IA o condiciones: El mayor valor aparece al automatizar el reconocimiento según el resultado de un análisis (IA, condiciones), reduciendo el trabajo manual del operador.
Nombrar el nodo descriptivamente: Cambia el nombre del nodo en el lienzo (ej. "Marcar falsa alarma") para identificarlo en el flujo.