Overview of System Events

When designing your eSpace, you are allowed to handle System Events of the Agile Platform and execute business rules at specific moments of the application life cycle as, for example, the preparation of session variables when an end-user logs in to the application.

How to Add an Action to Handle a System Event:

In the eSpace tree, under the Logic layer, right-click on the Actions folder, and select the action under Add System Event;

Design the behavior of the system action in the Action flow (Collection of elements that graphically implements the behavior of an action. You can have assign and control elements, exception handlers or you can invoke other actions. The elements are linked through Connectors.), through a specific editor.

Each System event has a specific action that handles it:

OnSessionStart: is executed on the first request after a session is created.

Example: use this action to prepare session variables when an end-user logs in to the application.

Learn more about the OnSessionStart Action.

OnBeginWebRequest: is executed on each web request right before the execution of a Preparation action or Screen actions of Web Screens.

Example: use it to use a custom IP address request validation.

Learn more about the OnBeginWebRequest Action.

OnDeliveryReport: is executed when a delivery report is received for a SMS sent by the application.

Example: use this action to log the delivery status of SMSs that are sent by the application.

Learn more about the OnDeliveryReport Action;

OnMobileOriginatedMessage: is executed when an SMS is received by the application and before it is processed by an SMS Flow.

Example: use this action to log SMSs that are received by the application.

Learn more about the OnMobileOriginatedMessage Action;

OnMobileTerminatedMessage: is executed when an SMS is sent by the application and before it is placed in the SMS Gateway.

Example: use this action to log SMSs that are sent by the application.

Learn more about the OnMobileTerminatedMessage Action;

Explicitly Execute an Action that Handles a System Event

If you want to explicitly execute one of these actions in an action flow simply do one of the following:

Drag the action from the eSpace Tree and drop it on your action flow;
Drag an Execute Action from the Action Flow Toolbox, drop it on your action flow, and choose the action that handles the System Event.