Gecontextualiseerde acties

2026-03-11Laatst bijgewerkt

Voor op gebeurtenissen gebaseerde automatiseringen kunt u gegevens van de activerende gebeurtenis gebruiken om de responsacties in context te plaatsen. Met gecontextualiseerde acties kan één enkele automatisering meerdere automatiseringsscenario's verwerken.

Verwijzen naar de bronentiteit

De volgende acties kunnen verwijzen naar de bronentiteit van de gebeurtenis die de automatisering heeft geactiveerd:
  • Geldt voor alle entiteiten:
    • Entiteiten delen
  • Geldt voor gebieden:
    • Perimeterdeuren expliciet ontgrendelen
  • Geldt voor camera's:
    • Bladwijzer toevoegen
    • Video blokkeren en deblokkeren
    • Opname starten
    • Opname stoppen
    • Momentopnamen e-mailen
    • Vervangen met gebeurtenisopnamekwaliteit
    • Omschakelen naar manuele opnamekwaliteit
    • Opnamekwaliteit als standaardconfiguratie
  • Geldt voor kaarthouders:
    • Een antipassback-schending vergeven
  • Geldt voor deuren:
    • Een zoemer uitschakelen
    • Een zoemer inschakelen
    • Een deur uitdrukkelijk ontgrendelen
    • Deuronderhoudsmodus instellen
  • Geldt voor deuren en liften:
    • Een lezer doorverbinden
  • Geldt voor units:
    • Een unit opnieuw opstarten
    • De onderhoudsmodus van de entiteit instellen
Het argument dat u in context kunt plaatsen, wordt vaak weergegeven met een schakel tussen de volgende twee opties:
Bron
Gebruik de bronentiteit die de gebeurtenis heeft gegenereerd.
Specifiek
Selecteer specifieke entiteiten op basis van het actietype.
Verwijzen naar de bronentiteit bij het selecteren van specifieke entiteiten.

Voor bepaalde actietypen, zoals Entiteiten delen, hebt u extra opties:

De actie "Entiteiten delen" configureren met de optie "In de buurt van een gebeurtenis".
In de buurt van een gebeurtenis
Selecteer alle camera's binnen een opgegeven straal van de locatie van de gebeurtenis.
Met deze optie kunt u uw bewaking richten door automatisch live video van camera's in de buurt van de locatie van de gebeurtenis te delen.
Een kaart met een straal van 1 km rond een markering en zeven camerapictogrammen binnen de straal.
LET OP!:
De triggergebeurtenis moet een locatie hebben, anders wordt de actie Entiteiten delen genegeerd.

Verwijzende entiteiten die aan de bronentiteit zijn gekoppeld

Voor bepaalde actietypen houdt contextualisering niet op bij de bronentiteit. Als een actietype een ander entiteitstype vereist dan de bronentiteit, kan de actie worden toegepast op de entiteiten die aan de bronentiteit zijn gekoppeld, mits het entiteitstype overeenkomt met wat de actie vereist.

Laten we het volgende voorbeeld bekijken:
Automatisering op basis van de gebeurtenis 'Deur geforceerd open' die een reactie activeert op camera's.
De automatisering wordt geactiveerd door de gebeurtenis Deur geforceerd open. De bron van een dergelijke gebeurtenis is een deurentiteit. We hebben twee responsacties:
  • Een zoemer laten klinken op de bronentiteit
  • Een bladwijzer toevoegen aan bronentiteit
De eerste actie, Een zoemer laten klinken, vereist een deurentiteit als argument. Omdat de actie is geconfigureerd op de bronentiteit, zal de actie de zoemer laten klinken op de deur waarvoor de gebeurtenis Deur geforceerd open is geactiveerd.

De tweede actie, Een bladwijzer toevoegen, vereist een camera-entiteit als argument. De actie wordt ook geconfigureerd op de bronentiteit, die een deur moet zijn. In dit geval wordt de actie toegepast op de camera-entiteiten die aan de deur zijn gekoppeld. Als er twee camera's aan de bronentiteit zijn gekoppeld, wordt aan beide camera's een bladwijzer toegevoegd.

Als u een actie op de bronentiteit configureert en het actietype een entiteitstype vereist dat niet kan worden gekoppeld aan de bronentiteit of een van de bijbehorende entiteiten, ontvangt u een waarschuwingsbericht, zoals in het volgende voorbeeld:
Reactie van automatisering met een waarschuwing en het tonen van de knopinfo.

Verwijzen naar de gebeurtenisgegevens

De volgende acties kunnen verwijzen naar de gebeurtenisgegevens als variabelen in hun tekstargumenten:
  • Bladwijzer toevoegen
  • Verstuur een bericht
  • Een e-mail versturen
  • Rapport e-mailen
  • Momentopnamen e-mailen

De argumenten waar variabelen kunnen worden gebruikt, worden gevolgd door de knop Variabele x.

De pagina Automatiseringen toont een gecontextualiseerde actie die is geconfigureerd om de naam van de bronentiteit te gebruiken in een bladwijzerbericht.
Als u een variabele in een tekstveld wilt opnemen, plaatst u de cursor op de plek waar u de variabele wilt invoegen, klikt u op de knop Variabele x. en selecteert u de gewenste variabele. De positie van de variabele in de tekst wordt aangegeven met accolades: {VariableName}. De meest voorkomende zijn:
  • {Source.Id}: De unieke identificator (GUID) van de bronentiteit.
  • {Source.Name}: De naam van de bronentiteit.
  • {Source.Description}: De beschrijving van de bronentiteit.
  • {EventDescription}: Het bericht dat bij de gebeurtenis hoort. De opgenomen gegevens variëren afhankelijk van het gebeurtenistype.
LET OP!:
Er is een activerende gebeurtenis vereist om gecontextualiseerde acties uit te voeren. Wanneer u handmatig een automatisering met gecontextualiseerde acties activeert, kan het gedrag onvoorspelbaar zijn. Wanneer u een automatisering uitvoert in reactie op een andere automatisering, is de context van de aanroepautomatisering ook de context van de aangeroepen automatisering.