OnSessionStart Action

Use the OnSessionStart action to handle this System event that occurs in the following situations:

On the first request after a session has been created;
After an end-user logs in to the application;
On the first request after an end-user logs out of the application.

As an example, you can design this action to prepare session variables of the eSpace after an end-user logs in to the application.

You're allowed to design the OnSessionStart action in any eSpace of your application and this way handle the System event in the context of each eSpace; this action is executed when an element of the eSpace is used by the application: a web screen, an action, etc.; if no usage occurs the action is not executed.

Because Web Services and Timers don't create sessions, the OnSessionStart action is not executed when accessing these elements.

The OnSessionStart action has no input parameters nor output parameters but you can create local variables.

Single Sign-On Scenario

In a Single Sign-On scenario the session is shared among all of the unified eSpaces: the User Provider eSpace and User Subscriber eSpaces. In this case, the OnSessionStart action of the User Provider eSpace is executed before executing the OnSessionStart action of a User Subscriber eSpace.

Persistent Login

If you're using Persistent Login and an end-user is implicitly logged in to the application, the UserId and the persistent Roles for that end-user are already loaded when the OnSessionStart action is executed.