Skip to main content

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:

  • Name:
    • The name of an event actions should be simple and descriptive, making it easy to figure out an event action's function from name alone (eg. Send email to user when new order is created).

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

  • Event full class name:
    • A full path (namespace and class name) of the Event class that needs to be triggered to perform the event action (eg. App\Containers\Product\Events\ProductsStockUpdatedEvent).
  • Action full class name:
    • A full path (namespace and class name) of the Action class that will run once the Event is triggered. (eg. App\Containers\Mail\EventActions\SendEmailAction).

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

image.png

  • Enabled:
    •  Toggle an event action as active or inactive. Inactive event actions will never run.
  • Fail in error: 
    • When this switch is toggled on, the action will be performed as normal, but will stop immediately on encountering an error.
  • Notify on error:
    • When this switch is toggled on, whenever the event action encounters an error, an email is sent to the development team to inform them of a failure when performing the event action.

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

image.png

  • HTTP Method:
    • The method of the API call. Valid call methods include POST, GET, PUT, PATCH, and DELETE.
  • API URL:
    • The URL of the external service API that will be called. Should be in format: https://[service]/[endpoint]

image.png

  • ARGUMENTS:
    • -
  • CONDITIONS:
    • -

Back to top