Event actions

Overview

Event actions are automated actions, performed by the system, when a set of conditions is met or a certain event is triggered (updating of a product, changing an order's status, creating a new invoice...).

image.png

Event actions are used for a variety of automated tasks, such as sending email notifications,  updating statuses, performing hook calls...

Event actions are managed by ERP administrators.

Create new event action

This action requires the "create event action" permission.

To add a new event action, navigate to the "Add new action" form, by pressing the "+" button in the top right corner above the table.

output.gif

Event actions should only be added by administrators with access to the code base, due to class names and their full paths being mandatory when creating new event actions. That information is only available to developers.

image.png

The creation form consists of several fields, required for creation of a new event action:

With the name set, the event that triggers the event action and the action that is performed by the event action need to be defined.

image.png

With the name, event and action defined, the three top switches can be toggled on/off.

image.png

Event actions can also be used to call external services via API calls when conditions are met.

image.png

Arguments and conditions (currently) need to be written in JSON format.

image.png

image.png

AVAILABLE CONDITION OPERATORS:

"=" or "==="  Check if the field and value are the same. (strict comparison by value and by type)
"=="  Check if the field and value are the same.
"!==" Check if the field and value are not the same. (strict comparison by value and by type)
"!=" Check if the field and value are not the same.
"<" Check if the field is less than the value.
">" Check if the field is mode than the value.
"<=" Check if the field is less  than or equal to the value.
">=" Check if the field is more than or equal to the value.
IN Check if field is one of values in array. Value must be array here.
NOT IN Check if field is not one of values in array. Value must be array here.
CONTAINS Check if field contains the value.
DOES_NOT_CONTAIN Check if field does no contains the value.
IS_TABLE Check if the record's table is equal to value.
STARTS_WITH Check if the field starts with value. Field and value must be strings in this case
ENDS_WITH Check if the field end with value. Field and value must be strings in this case

Update existing event action

Existing event actions should currently never be updated by anyone else but the developers. When a need arises for a different functionality, a new event action should be created, deactivating the old one.

Delete event action

Existing event action should never be deleted, instead being deactivated.