Launching Reports

Top  Previous  Next

When a report is launched, AggreGate Server evaluates its Source Data Expression, uses the data it returns to fill a report template, and shows the prepared report using the Show Report UI procedure.

A report can be launched in one of two ways:

Directly, using the Show Report action of the Report Context. For relative reports, this method evaluates the Source Data Expression relatively to the context specified by Default Context report property.
Using the Launch Report action (see below). For relative reports, this method evaluate the Source Data Expression relatively to the context from which the Launch Report action has been launched.

Launch Report Action

This action may be found in every context for which the report's validity expression is true. For example, if an Attendance Report is created for a Card Holder context (meaning, its Validity Expression is {.#type} == 'cardholder'), an action called Attendance Report will appear in the context of every cardholder. Its description is the same as that of the report itself. Actions that are used to start reports may be easily recognized by a cm_report icon. Please, check References article for details on how the {.#type} reference works.

Here is what a Launch Report action looks like in a context menu within AggreGate Client:

ls_reports_launch_action

For this action to be available, the user must have an effective permission level of User in two contexts:

Report context of the actual report being launched
The context on which the report operates, i.e. the one where Launch Action is defined