Adding or modifying events
Use this procedure to add events to a report or modify an existing event. Only the report owner or an administrator can add or modify an event.
- Open the Tools dashboard and select My Reports. The Reports screen is displayed.
- Click the report's details. The Report Details screen is displayed.
- Click Events to open the Events screen.
-
Select the event type that you want to add to the report.
Reporting Services is delivered with four standard event types. You cannot add additional event types to the system. Reporting Services processes events in the order in which they appear below.
- Report Request Received: Use this event to initiate a program or process when Reporting Services receives the report request. For example, you might want to begin a logging program that tracks the total time it takes to run a report. For more information about writing a Report Request Received event program and defining its URL value, see Creating a report request received event URL.
- Parameter Selection: Use this event to direct Reporting Services to a program that selects the report parameters and their values for the specific report and user requesting to view the report. For more information about writing a Parameter Selection event program and defining its URL value, see Creating a parameter selection event URL.
- Parameter Validation: Use this event to direct Reporting Services to a program that validates the report parameters and their values for the specific report and the user requesting to view the report. For more information about writing a valid Parameter Validation event program and defining its URL value, see Creating a parameter validation event URL.
- Report Request Complete: Use this event to complete the program or process that you specified in the Report Request Received field. For example, you might want to end a logging program that tracks the total time it takes to run a report. For more information about writing a valid Report Request Complete even program and defining its URL value, see Creating a report request complete event URL.
-
If you are adding a Report Request Received event or a Report Request
Complete event, use the Frequency field to specify when you want Reporting Services to run the event.
Note: If you are adding either a Parameter Selection or a Parameter Validation event, Frequency displays the Initial Request Only option, only.
-
In the URL field, specify the URL value of
the user-defined program application for the event.
If you are using Reporting Services-defined variables as part of the URL, note the following when specifying variables in the URL:
- Variables are case-sensitive.
- You must use the at sign (@) before the variable. You must
type double angle brackets around the variable. For example,
<<@your_variable>>
. - You can only specify user variables that are defined as the literal type.
- You can specify system variables that are shipped with the Reporting Services product.
- In the Usage field, specify the reports for which you want the events run. Select All Reports to run the event on the published report and all instances of the report. Select Main Reports to run the event on the published report, only. Select History to run the event on all historical instances of the report.
- Click Save.