General information about the macros

Macro is a tool used to configure system responses to certain events. System response may include one or several different actions.

You can configure C-Werk to perform certain actions if any events occur in the system. For example, when a fire is detected—to activate voice notification, when the camera is disarmed—to send an email notification and initiate an alarm, etc. To perform such actions, you need macros.

Types of macros

There are three types of macros:

1. Event-driven (1). These macros can run automatically on detecting the specified events or initiated manually by the operator. When triggered, the actions in the macro are executed once.
2. Automatic Rules (2). These macros run every time when the detection tool triggers.

3. Cycle (3). These macros can run automatically after a set period of time, or at a random time within a set interval.
   Cycle macros are run on the first Server in the Domain (alphabetical order) available at the time of launching the macro. Cycle macros are executed immediately after you save them in the system, unless they have been created outside the time schedule (see Create Macros). After completing all actions, the macro is automatically restarted. Additionally, a cycle macro can be launched at a specified time interval, or at a random moment within the specified time interval. In this case, all actions in the macro will be executed once.

   Attention!

   If, during the response of a cycle macro to a certain event, another event that should also be processed by this macro occurs, it will be skipped. 

   If another event occurs during an event-driven macro response, this event will be processed according to the specified parameters.

Unless the macro has standby commands (see Wait for event, Wait for timeout, Wait till previous action finishes), all actions are performed simultaneously.

Configuring macros

You can create and configure macros on the Programming tab (see Create Macros).

To configure macros, do the following:

1. Specify the green section of the setting Start conditions (1). These are the events in the system that will trigger a macro (see Configuring filters for event-driven macros).

2. Specify the blue section of the setting that is the system actions (2). These are the actions that the system should perform after an event occurs (see Settings specific to actions). Several system actions can be configured.

There is also an orange setting section in cycle macros. It sets the system wait time between the actions. For more information on configuring the cycle macros, see Cycle macros.

You can find examples of macros on these pages: Configuring macros when working with vehicles lists, Examples of macros used for working with face lists.