Actions contextualisées

2026-03-11Dernière mise à jour

Pour les automatisations basées sur des événements, vous pouvez utiliser les données de l'événement déclencheur pour contextualiser les actions de réponse. Avec des actions contextualisées, une seule automatisation peut gérer plusieurs scénarios d’automatisation.

Référencer l'entité source

Les actions suivantes peuvent référencer l'entité source de l'événement qui a déclenché l'automatisation :
  • S'applique à toutes les entités :
    • Partager des entités
  • S'applique aux zones :
    • Déverrouiller expressément les portes du périmètre
  • S'applique aux caméras :
    • Ajouter un signet
    • Bloquer et débloquer une vidéo
    • Démarrer l'enregistrement
    • Arrêter l'enregistrement
    • Envoyer des instantanés par e-mail
    • Qualité d’enregistrement selon la configuration sur événement
    • Qualité d’enregistrement selon la configuration manuelle
    • Qualité d’enregistrement selon la configuration standard
  • S'applique aux titulaires de cartes :
    • Pardonner une violation antiretour
  • S'applique aux portes :
    • Désactiver l'avertisseur sonore
    • Activer l'avertisseur sonore
    • Déverrouiller expressément une porte
    • Définir le mode de maintenance de la porte
  • S'applique aux portes et aux ascenseurs :
    • Contourner un lecteur
  • S'applique aux unités :
    • Redémarrer une unité
    • Définir le mode maintenance d'entité
L'argument que vous pouvez contextualiser est souvent affiché avec un commutateur entre les deux options suivantes :
Source
Utilisez l'entité source qui a déclenché l'événement.
Spécifique
Sélectionnez des entités spécifiques en fonction du type d'action.
Faire référence à l’entité source lors de la sélection d’entités spécifiques.

Pour certains types d'action, telles que Partager des entités, des options supplémentaires sont disponibles :

Configuration de l'action « Partager des entités » avec l'option « À proximité d'un événement ».
À proximité d'un événement
Sélectionnez toutes les caméras dans un rayon spécifié de l'emplacement de l'événement.
Cette option permet de concentrer vos efforts de surveillance en partageant automatiquement des vidéos en direct à partir de caméras situées près du lieu de l'événement.
Une carte montrant un rayon de 1 km autour d'une épingle avec sept icônes de caméra dans le rayon.
ATTENTION :
L'événement déclencheur doit avoir un emplacement, sinon, l'action Partager des entités est ignorée.

Référencer des entités associées à l'entité source

Pour certains types d'action, la contextualisation ne s'arrête pas à l'entité source. Si un type d’action nécessite un type d’entité différent de celui de l’entité source, vous pouvez appliquer l’action aux entités associées à l’entité source, à condition que leur type d’entité corresponde à celui requis par l’action.

Prenons l'exemple suivant :
Automatisation basée sur l'événement « Porte forcée » déclenchant une réponse sur les caméras.
L'automatisation est déclenchée par l'événement Porte forcée. La source d'un tel événement est une entité de porte. Nous avons deux actions en réponse :
  • Activer l'avertisseur sonore sur l'entité source
  • Ajouter un signet sur l'entité source
La première action, Activer l'avertisseur sonore, nécessite une entité de porte comme argument. Puisqu'elle est configurée sur l'entité source, l'action activera l'avertisseur sonore sur n'importe quelle porte générant l'événement Porte forcée.

La deuxième action, Ajouter un signet, nécessite une entité caméra comme argument. Elle est également configurée sur l'entité source, qui doit être une porte. Dans ce cas, l’action sera appliquée aux entités caméra associées à la porte. Si deux caméras sont associées à l'entité source, un signet sera ajouté aux deux caméras.

Si vous configurez une action sur l'entité source et que le type d'action nécessite un type d'entité qui ne peut pas être mis en correspondance avec l'entité source ou l'une de ses entités associées, vous recevrez un message d'avertissement, comme illustré dans l'exemple suivant :
Réponse d'automatisation avec un avertissement et affichage de l'infobulle.

Référencer des données d'événement

Les actions suivantes peuvent référencer des données d'événement en tant que variables dans leurs arguments texte :
  • Ajouter un signet
  • Envoyer un message
  • Envoyer un e-mail
  • Envoyer un rapport par e-mail
  • Envoyer des instantanés par e-mail

Les arguments dans lesquels des variables peuvent être utilisées sont suivis par le bouton Variable x..

La page Automatisations affiche une action contextualisée configurée pour utiliser le nom de l'entité source dans un message de signet.
Pour inclure une variable dans un champ de texte, placez votre curseur à l'endroit où vous souhaitez insérer la variable, cliquez sur le bouton Variable x., puis sélectionnez la variable souhaitée. La position de la variable dans le texte est indiquée par des crochets : {VariableName}. Les plus courantes sont :
  • {Source.Id} : identificateur unique (GUID) de l'entité source.
  • {Source.Name} : nom de l'entité source.
  • {Source.Description} : description de l'entité source.
  • {EventDescription} : le message qui accompagne l'événement. Les données incluses varient en fonction du type d'événement.
ATTENTION :
Un événement déclencheur est nécessaire pour exécuter des actions contextualisées. Lorsque vous déclenchez manuellement une automatisation comportant des actions contextualisées, le comportement peut être imprévisible. Lorsque vous exécutez une automatisation en réponse à une autre automatisation, le contexte de l'automatisation appelante est également le contexte de l'automatisation appelée.