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

You can configure Axxon One 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, and so on. To perform such actions, you need macros.

Types of macros

There are three types of macros:

1. Event rules (1). These macros can run automatically on detecting the specified events or initiated manually by the operator. When started, the actions in the macro are executed once.
2. Automatic rules (2). These macros run every time when the detection tool generates an event.

3. Cycle rules (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 Axxon-domain (alphabetical order) available at the time of starting 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 started at a specified time interval, or at a random moment within the specified time interval. In this case, all actions in the macro are executed once.

   If, during the response of a cycle macro to a certain event, another event that must also be processed by this macro occurs, it will be skipped.  If another event occurs during an event-driven macro response, this event is processed according to the specified parameters.

Unless the macro has wait 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 Start conditions (1). These are the events in the system that start a macro (see Configuring start conditions).

2. Specify the system actions (2). These are the actions that the system must perform after an event occurs (see Settings specific to actions). Several system actions can be configured.

There is also a setting section in cycle macros. It specifies 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 when working with face lists.