Documentación: Nodo Alarma (Alarm)¶

Descripción General¶

El Nodo Alarma (Alarm) es un nodo de acción que permite armar o desarmar uno o varios paneles de alarma registrados en la plataforma directamente desde un flujo de automatización (por ejemplo, paneles de intrusión Ajax, centrales de alarma perimetral, etc.).

Al ejecutar esta acción, la orden se envía al driver del panel de alarma correspondiente, cambiando su estado operativo de forma remota. Esto te permite integrar la seguridad física dentro de tu lógica de automatización IoT: armar el perímetro de una planta industrial a una hora determinada, desarmar una zona cuando un operador valida su acceso, o re-armar un panel tras detectar que quedó desactivado fuera de horario.

¿Cuándo usar este nodo?¶

Utiliza este nodo cuando necesites:

Armar automáticamente uno o varios paneles de alarma (por ejemplo, al cierre nocturno de una bodega o planta industrial mediante un disparador de horario).
Desarmar paneles de alarma de forma controlada (por ejemplo, al inicio del turno de mañana o cuando un lector de acceso valida a un supervisor autorizado).
Aplicar la misma orden de armado/desarmado a múltiples paneles a la vez (por ejemplo, todos los paneles de un conjunto de naves industriales).
Reaccionar a eventos del entorno IoT armando o desarmando la seguridad física como parte de un flujo más amplio.

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 Alarma

Vista Formulario¶

1. Acción (Action) *Requerido¶

Define la operación que se realizará sobre los paneles seleccionados. Se elige mediante dos tarjetas visuales:

Arm (Armar): Activa el sistema de alarma. Al seleccionar esta opción se habilita el campo Arm mode (Modo de armado).
Disarm (Desarmar): Desactiva el sistema de alarma. Al seleccionar esta opción, el campo Arm mode se oculta y se limpia, ya que no aplica al desarmar.

2. Paneles de Alarma (Alarm panels) *Requerido¶

Permite seleccionar uno o más paneles de alarma sobre los que se aplicará la acción.

Haz clic en el botón Select alarm panels para abrir el modal del selector.
El selector está filtrado automáticamente para mostrar únicamente objetos de tipo panel de alarma (alarm_panel). Puedes navegar por la pestaña Devices (Dispositivos) y expandir cada equipo para localizar el panel deseado.
Marca la casilla de verificación de cada panel que quieras incluir y confirma con Done.

Modal de selección de paneles de alarma

Una vez seleccionados, los paneles se muestran como tarjetas debajo del botón, indicando su nombre y su ID único. Puedes quitar cualquiera con el ícono de papelera.

3. Modo de Armado (Arm mode) *Condicional¶

Este campo solo aparece cuando la acción es Arm. Define con qué modo se armará el panel.

Es un campo de tipo autocompletado: muestra los modos de armado disponibles para el panel seleccionado (por ejemplo, Arm para armado total). También puedes escribir manualmente el valor de un modo si tu integración lo soporta.

NOTA: Los modos de armado disponibles dependen del tipo y la marca del panel de alarma. Algunos paneles solo exponen un modo único de armado, mientras que otros pueden ofrecer modos como armado total, armado nocturno o armado parcial.

Formulario configurado del nodo Alarma

Vista Editor de JSON¶

En la pestaña Editor de JSON (JSON Editor) puedes visualizar y editar directamente la representación estructurada del nodo. Es útil para configuraciones rápidas, para parametrizar con variables dinámicas o para copiar configuraciones entre nodos:

Vista JSON Editor del nodo Alarma

Estructura JSON (Parámetros de entrada)¶

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

{
  "action": "arm",
  "objects_id": [
    "ajax_enterprise_api.alarm_panel.ajax_hub.001EF05F"
  ],
  "arm_mode": "arm"
}

Campos del JSON¶

Campo	Tipo	Descripción
`action`	string	Operación a realizar. Valores: `arm` (armar) o `disarm` (desarmar).
`objects_id`	array (string)	Lista con los ID únicos de los paneles de alarma sobre los que se aplica la acción. Admite uno o varios.
`arm_mode`	string	Modo de armado a aplicar cuando `action` es `arm` (por ejemplo, `arm`). Se ignora / queda vacío al desarmar.

Output: Dónde viene la data del nodo¶

El Nodo Alarma es una acción de tipo comando (envía la orden de armar/desarmar al driver del panel). Cuando la acción se ejecuta correctamente, el nodo finaliza marcado como exitoso (borde verde) pero no expone un payload de datos estructurado en su salida; su efecto se refleja en el cambio de estado real del panel de alarma.

Por lo tanto, para verificar el resultado debes observar:

El estado de ejecución exitoso del nodo en la pestaña Ejecuciones.
El nuevo estado del panel de alarma en Settings ▸ Objects o en los Dashboards / Sinópticos donde esté representado el panel.

TIP: Si necesitas encadenar lógica que dependa de confirmar el estado del panel después de armarlo o desarmarlo, utiliza un nodo Obtener estado de objeto (Get object state) posterior para leer su estado actualizado.

Ejemplos de uso¶

Ejemplo 1: Armar el perímetro de una planta industrial al cierre nocturno¶

Caso de uso: Cada día a las 22:00, al finalizar la jornada productiva, se arma automáticamente el panel de alarma perimetral de la planta para proteger las instalaciones durante la noche.

Disparador (Trigger): Nodo de horario (Schedule) programado a las 22:00 de lunes a domingo.
Acción (Action): Arm
Alarm panels: Panel de alarma perimetral de la planta (CMI INTRADE NETSOCS)
Arm mode: arm

JSON de configuración:

{
  "action": "arm",
  "objects_id": [
    "ajax_enterprise_api.alarm_panel.ajax_hub.001EF05F"
  ],
  "arm_mode": "arm"
}

Ejemplo 2: Desarmar la alarma al inicio del turno de mañana¶

Caso de uso: A las 06:00, antes de que ingrese el personal del primer turno, se desarma el panel de alarma para permitir el acceso normal a la planta sin generar falsas alertas.

Disparador (Trigger): Nodo de horario (Schedule) programado a las 06:00.
Acción (Action): Disarm
Alarm panels: Panel de alarma perimetral de la planta

JSON de configuración:

{
  "action": "disarm",
  "objects_id": [
    "ajax_enterprise_api.alarm_panel.ajax_hub.001EF05F"
  ],
  "arm_mode": ""
}

Validación y errores¶

El nodo realiza validaciones antes de enviar la orden al panel:

Selección de paneles: Se debe haber seleccionado al menos un panel de alarma en objects_id.
Acción válida: El campo action debe ser arm o disarm.
Conexión del driver: El driver del panel de alarma debe estar conectado para que la orden se aplique sobre el dispositivo físico.

Errores comunes¶

Condición	Causa / Solución habitual
Ningún panel seleccionado	Abre el selector con `Select alarm panels` y marca al menos un panel de alarma.
El panel no cambia de estado	Verifica que el driver del panel esté conectado y en línea. Un driver desconectado impide que la orden llegue al hardware.
Modo de armado no aceptado	El `arm_mode` ingresado no es soportado por ese panel. Selecciona uno de los modos que ofrece el autocompletado del panel.

Buenas prácticas¶

Nombrar el nodo descriptivamente: Cambia el nombre del nodo en el lienzo a algo legible (ej. "Armar perímetro planta") para identificarlo fácilmente dentro del flujo.
Combinar con condiciones de horario: Para evitar armar o desarmar fuera de los horarios deseados, antecede este nodo con un nodo condicional de fecha/hora.
Confirmar el estado tras la acción: Cuando la operación sea crítica, encadena un nodo de Obtener estado de objeto o una notificación para confirmar que el panel quedó efectivamente armado o desarmado.
Agrupar paneles: Si gestionas varios paneles que siempre deben armarse juntos, selecciónalos todos en un mismo nodo para mantener el flujo simple y consistente.