13.2.3.1. Event Action Properties

In the Event Action Properties window, users can create a new event action for the application.

1. Name: This is a text field that allows users to input the name of the event action. It is a mandatory field.
   • There are the following rules determining the validity of names:
     • A valid name can contain letters, numbers, and the underscore symbol. It cannot, however, contain spaces or other special characters. It also cannot begin with a number.
     • An event action must have a unique name. It cannot have the same name as another event action in the program.
2. Title: This is a text field that allows users to input the title of the event action.
   • Unlike with names, there are no guidelines determining the validity of titles.
3. Active: This is a checkbox which, if selected, allows users to mark the event action out as active.
4. Entity: This is a single-select dropdown field that retrieves the list of entities (from the Entity Designer section of the Entities module). It allows users to select the entity associated with the event action.
5. Scope: This table displays all defined events in the application (as retrieved from the Events section of the Processes module). It allows users to assign a scope to the event action.
   • To select a scope from the table, double-click on it.
     • When a scope is selected from the table, the associated access name will automatically populate the Event Name field.
   • Assigning a scope to an event action is optional. If a scope is assigned, the action will execute automatically when the corresponding event occurs. If not, the action must be executed manually.

*If a scope is assigned, the event action can be linked to a scheduled event. For more information on scheduled events, click here.

6. Event Name: When a scope is selected from the table, the associated access name will automatically populate this field.
   • To remove the event name, click on the button.
7. Process: This is a single-select dropdown field that retrieves the list of processes (from the Process Design section of the Processes module). It allows users to select the process during which the event action will be executed.

*If a process is not selected from this dropdown, the event action will be executed in all processes associated with the chosen entity.

8. Process Version: This is a single-select dropdown field that displays the list of versions associated with the selected process. It allows users to select the version of the process during which the event action will be executed.
   • Depending on the process selected, the process versions displayed in this dropdown may vary.
     • If -1 is selected as a process version, the event action will be executed in all versions of the selected process.

*If a process version is selected from this dropdown, the event action will be triggered only for that particular version of the process.

9. State Name: This is a single-select dropdown field that displays the list of states in the selected process. It allows users to select the state during which the event action will be executed.
   • Depending on the process and process version selected, the states displayed in this dropdown may vary.

*If a state is not selected from this dropdown, the event action will be assigned to all states associated with the chosen process.

Event Action Execution:

*To save changes, click on the Apply button. To save changes and exit the Event Action Properties window, click on the OK button. To cancel changes or exit the window, click on the Cancel button or the Exit (X) button.