Introduction to Server Events

This section explains how to create Events Handlers that run custom code when reports are executed.

Event Handlers

Event Handlers provide code that Exago can execute when certain events happen during the report execution process. This code can either come from a .Net Assembly method or within Exago configuration.

All existing Event Handlers are listed in the Main Menu under Server Events. All the Event Handlers you are adding or editing will be displayed in a Tab entitled Server Events.

Each Event Handler has the following properties:

NOTE. System.dll does not need to be listed as a reference as it is already available.
NOTE. The Assembly’s dll will be locked by Exago when it is first accessed. To replace the dll, unlock it by restarting the IIS App pool.
NOTE. If you want to utilize the sessionInfo object that is passed to all Event Handlers the Assembly must include a reference to WebReportsApi.dll. For more information see SessionInfo.
NOTE. All methods used as Event Handlers must be static.

Ex. Selecting OnReportExecuteStart from this dropdown will cause the Event Handler to be called whenever any Report Execution begins.

Custom Code

Event Handler custom code can be saved directly in Exago via the Administration Console. There are two objects that custom code can utilize to access information relevant to an Event.

.Net Assemblies

Event Handlers can also reside in .Net Assemblies. The following are important details for using .Net Assemblies as Event Handlers.