Acciones contextualizadas

2026-03-11Última actualización

Para las automatizaciones basadas‑en eventos, puede utilizar los datos del evento desencadenante para contextualizar las acciones de respuesta. Con acciones contextualizadas, una sola automatización puede gestionar múltiples escenarios de automatización.

Hacer referencia a la entidad de origen

Las siguientes acciones pueden hacer referencia a la entidad de origen del evento que activó la automatización:
  • Se aplica a todas las entidades:
    • Compartir entidades
  • Se aplica a las áreas:
    • Desbloquee las puertas perimetrales del área explícitamente
  • Se aplica a las cámaras:
    • Agregar un marcador
    • Bloquear y desbloquear video
    • Iniciar la grabación
    • Para de grabar
    • Instantáneas por correo electrónico
    • Anular con calidad de grabación de eventos
    • Anulación con calidad de grabación manual
    • Calidad de grabación como configuración estándar
  • Se aplica a los tarjetahabientes:
    • Perdonar una violación de antipassback
  • Se aplica a las puertas:
    • Silenciar un timbre
    • Suena un timbre
    • Desbloquear una puerta de manera explícita
    • Establecer el modo de mantenimiento de la puerta
  • Se aplica a las puertas y elevadores:
    • Desviar un lector
  • Se aplica a las unidades:
    • Reiniciar una unidad
    • Configurar el modo de mantenimiento de la entidad
El argumento que puede contextualizar a menudo se muestra con un cambio entre las dos opciones siguientes:
Fuente
Usar la entidad de origen que generó el evento.
Específico
Seleccionar entidades específicas según el tipo de acción.
Referencia a la entidad de origen al seleccionar entidades específicas.

Debido a ciertos tipos de acciones, como Compartir entidades, tiene opciones adicionales:

Configuración de la acción “Compartir entidades” con la opción “Cerca del evento”.
En proximidad de eventos
Seleccione todas las cámaras dentro de un radio específico de la ubicación del evento.
Esta opción le ayuda a enfocar sus esfuerzos de monitoreo al compartir de manera automática video en vivo desde cámaras cercanas a la ubicación del evento.
Un mapa que muestra un radio de 1 km alrededor de un pin junto con siete íconos de cámara dentro del radio.
PRECAUCIÓN:
El evento activador debe tener una ubicación; de lo contrario, se ignora la acción de Compartir entidades.

Hacer referencia a entidades asociadas con la entidad de origen

Para ciertos tipos de acciones, la contextualización no se detiene en la entidad de origen. Si un tipo de acción requiere un tipo de entidad diferente al de la entidad de origen, la acción puede aplicarse a las entidades asociadas con la entidad de origen, siempre que su tipo de entidad coincida con lo que requiere la acción.

Consideremos el siguiente ejemplo:
Automatización basada en el evento de “Puerta forzada” que activa la respuesta en las cámaras.
La automatización se activa por el evento de Puerta forzada. El origen de un evento de este tipo es una entidad de puerta. Tenemos dos acciones de respuesta:
  • Hacer sonar un timbre en la entidad de origen
  • Agregar un marcador en la entidad de origen
La primera acción, Hacer sonar un timbre, requiere una entidad de puerta como argumento. Dado que está configurada en la entidad de origen, la acción hará sonar el timbre en cualquier puerta que genere el evento de Puerta forzada.

La segunda acción, Agregar un marcador, requiere una entidad de cámara como argumento. También se configura en la entidad de origen, que debe ser una puerta. En este caso, la acción se aplicará a las entidades de cámara asociadas con la puerta. Si dos cámaras están asociadas con la entidad de origen, se agregará un marcador a ambas cámaras.

Si configura una acción en la entidad de origen y el tipo de acción requiere un tipo de entidad que no puede coincidir con la entidad de origen o cualquiera de sus entidades asociadas, recibirá un mensaje de advertencia, como se muestra en el siguiente ejemplo:
Respuesta de automatización con una advertencia y mostrando la información sobre las herramientas.

Hacer referencia a los datos del evento

Las siguientes acciones pueden hacer referencia a los datos del evento como variables en sus argumentos de texto:
  • Agregar un marcador
  • Enviar un mensaje
  • Enviar un correo electrónico
  • Enviar un informe por correo electrónico
  • Instantáneas por correo electrónico

Los argumentos en los que se pueden utilizar variables van seguidos del botón Variable x.

La página de Automatizaciones muestra una acción contextualizada configurada para usar el nombre de la entidad de origen en un mensaje de marcador.
Para incluir una variable en un campo de texto, coloque el cursor donde desee que se inserte la variable, haga clic en el botón de Variable x. y, a continuación, seleccione la variable que desee. La posición de la variable en el texto se indica entre llaves: {VariableName}. Los más comunes son:
  • {Source.Id}: El identificador único (GUID) de la entidad de origen.
  • {Source.Name}: El nombre de la entidad de origen.
  • {Source.Description}: La descripción de la entidad de origen.
  • {EventDescription}: El mensaje que acompaña al evento. Los datos incluidos varían según el tipo de evento.
PRECAUCIÓN:
Se necesita un evento activador para ejecutar las acciones contextualizadas. Cuando activa de manera manual una automatización que tiene acciones contextualizadas, el comportamiento puede ser impredecible. Cuando se ejecuta una automatización en respuesta a otra automatización, el contexto de la automatización que llama también es el contexto de la automatización llamada.