====== Action Groups ======

Action Groups are collections of actions grouped under a single name

{{ :comfilehmi:user_action_groups:addaction.mp4?800x500 |}}

In the example below, three actions are aggregated under the single name "Initialize". (When executed, they are executed in the order shown.)

{{ :comfilehmi:user_action_groups:useractiongroup.png?nolink |}}

Action Groups are executed in response to some event declared elsewhere in the project.  They are similar in concept to a user-defined function.

When adding an action, you can choose an action group to run by selecting the //Run Action Group// option.  The drop-down list contains a list of any pre-defined action groups.

{{ :comfilehmi:user_action_groups:runuseraction.png?nolink |}}

Therefore, Action Groups can be executed from a [[comfilehmi:multi-action_button:index|Multi-action Button]], [[comfilehmi:globalevent:index|Global Event]], or a [[comfilehmi:screenevent:index|Screen Event]].  Recursion is not supported.

===== Advanced Options =====

In the //Advanced Options//, an action group can be configured for iteration.  Iteration can be configured for a finite number of iterations, or to run indefinitely.

{{ :comfilehmi:user_action_groups:runuseraction2.png?nolink |}}

Delay can be added to the initial execution as well as to each individual iteration in millisecond precision.

{{ :comfilehmi:user_action_groups:runuseraction3.png?nolink |}}

===== Stopping an Iterating Action Group =====

Use the //Stop Iterating Action Group// option to end the execution of any iterating action group.

{{ :comfilehmi:user_action_groups:stoprunuseraction.png?nolink |}}

[[comfilehmi:#Field_Resources:|Back to ComfileHMI]]