Page History

General information

In Axxon One, you can create and configure macros. You can create and configure macros on the Programming tab.

To create and configure macros, you must have access permissions to the programming setup (see Roles).

General algorithm to create and configure a macro

...

The Event rules and Cycle rules macros have a common algorithm of creation and configuration. To create a macro, do the following:

1. Go to the Programming tab.
2. Click the Create... button in the Event rules or Cycle rules list.
   Image Added
3. In the Name field, enter the name of a macro. The default name is Macrocommand{sequence number}.
   Image Added
4. From the Working mode drop-down list, select the working mode of a macro:
   

   Working mode	Event rules	Cycle rules
   Never	Can only be run manually

5. Enter the name of the macro (1).
   Image Removed

Select the macro working mode (2):

ModeEvent-driven CyclicNeverManual execution only

6. (see Working with Dialog Board, Macros control)

   Disabled,

manual execution is possible (see

7. can be run manually (Macros control)

 

8. Always

Always on

9. (default)

   Runs always

   Runs always

Always on

10. Time schedule	Runs within the selected time schedule (see Creating schedules).

Manual execution is possible

11. Can be run manually at any time

    Runs within the

specified

12. selected time schedule

info

13. Note title

Note

14. Attention!

When creating

15. If a macro

, the Always mode is used by default.

16. working mode is within a time schedule (see Creating schedules), and a macro start time is outside this time schedule, a macro isn't started.

17. If you need to add a macro to the control menu on
the
18. a layout (see Macros control), set the
corresponding checkbox (3).To configure event-driven macros, click the Image Removed button and
19. Add to menu checkbox.
20. For the Event rules macros, select one or more
trigger events (4,
21. events that initiate macro start by clicking the Image Added button in the Start conditions field (see Configuring start conditions). If you leave the event filter
is left
22. blank,
the macro can be executed
23. you can start this macro only manually.
    
Image Removed


24. Info
    title Note
    To delete an event from the filter, click the Image Modified button. You can run a macro for a group of cameras (see Creating a system of groups and subgroups). You can collapse macro start conditions and each action by clicking the header.

25. Add one or more actions
to the
26. performed by a macro (
5, see Settings specific to actions). Click the Image Removed button to do this
27. see Examples of macros). These are actions that the system must perform after an event occurs. To add an action, click the Image Added button. To delete an action, click the Image Modified button.

Info
title Note
The macro can be executed for a group of cameras (see Creating a system of groups and subgroups).

Info
title Note
To hide the start conditions and action for the macro, click the action name.

A cyclic macro can be launched automaticallyat
28. Click the Apply Image Added button.
    

Created macros are displayed in the corresponding list. When you select the Never working mode for a macro, it is grayed out.
Image Added

Features of configuring the Cycle rules macros

The Cycle rules macros can be run automatically in a specified time interval, or at a random

...

time within

...

a specified

...

interval. To configure this

...

behavior, do

...

the following:

Image Added 

1. In the
Heartbeat Interval
2. Heartbeat interval field, specify the time interval in the HH:MM:SS format
(1)
3. . For example, if you set the interval to 8 hours and leave the Random checkbox clear
(see 6b)
4. ,
the macro will be launched
5. a macro is started every 8
hours strictly
6. hours strictly.
The macro will be launched
7. A macro is started according to cycle settings even if the actions from its previous
launch
8. start are not completed. In this case, several instances of the same macro
will be
9. are executed simultaneously.
   

   Info
   title

Image Removed

10. Note

Set the Random checkbox (2)

11. Starting with Axxon One 2.0.12, the minimumallowed value of the Heartbeat interval field is 1second.

12. Set the Random checkbox, if you need to

launch the

13. start a macro at a random moment

set

14. specified by

the 

15. the Heartbeat interval

 parameter

16.  parameter. For example, if the interval is set to 8 hours, then once every 8 hours at a random moment,

the macro will be launched

17. a macro is started.

Note
title Attention!
If the macro working mode is linked to a time schedule, and the launch time falls out of the schedule, the macro will not be launched.

To save the macro, click the Apply button.

Note
title Attention!
By default, the created macros are available only to the users from the admin group (see Roles).

Editing macros

To edit a macro, do the following:

1. Select the required macro from the list.
2. Change the macro settings if necessary.
3. Click the Apply Image Added button to save the changes. Click the Cancel Image Added button to cancel the changes.

Editing a macro is complete.

Copying macros

To copy a macroThe created macros are displayed in the list. If the Never mode is selected for the macro, it is grayed out.
Image Removed
You can copy macros. To do it, do the following:

1. Select the required macro
to copy
2. from the list.
3. Click
the
4. the Create... button.

A new macro with the similar parameter will be createdMacro is copied.

Removing macros

To delete remove a macro, select it in the list and click the Remove do the following:

1. Select the required macro from the list.
2. Click the Remove Image Added button.
3. Click the Apply Image Added button.

Macro is removedbutton.