Scroll

Advanced Options

The Advanced Options menu is available in Advanced Reports and CrossTab Reports.

advancedoptions_menu.png

Note: If you do not have access to the Advanced Option menu or certain options within it, you may not have permission to do so. Please contact your administrator regarding permissions.

From the Advanced Options menu, the following items may be accessed:

  • The Joins window, allowing advanced users to specify additional information about how the data categories within a report relate to each other.
  • The Events window, allowing advanced users to apply event handlers for the report.
  • The Show Generated SQL option, allowing advanced users to generate and view the constructed SQL that will be sent to the databases prior to execution.

 

Joins

If a report has two or more data categories, then information will only appear if the categories match. Using the Joins window, however, you may specify information you want to display regardless of whether or not it only exists in one of the data categories.

For example, if a report has two data categories, Orders and Customers, then only customers who have made orders will appear. By selecting the appropriate checkbox you can include information on customers that have not made orders.

screen.joins_window.png

The following options are also available within the Joins window:

  • To add a new join click the Add button.
  • To edit a join click the Edit edit.png button.
  • Restore the default joins by clicking the Recreate button.
  • To remove a join click the Delete image006.png button.

 

Editing and Adding Joins

When either editing an existing join or adding a new join between two data categories that are not currently joined, the Report Join menu will appear.

screen.joins_editingexample.png

In this menu you can modify the information of a join or create a new join for the report.

  • A join conditione.g., Customers.CustomerID = Orders.CustomerID—may be deleted from a join using the Delete image006.png button.
  • A join condition may be added to a join using the Add Condition button.
  • Join conditions may be adjusted using their respective Column dropdowns. Within each dropdown is a list of available fields that may be joined.
Caution: There is no restriction on what fields may be joined. Please use careful consideration when joining fields, as improper joins may result in unexpected data output.

 

Events

Event handlers may be applied to the report by advanced users for additional functionality.

screen.events_window.png

The following options are available within the Events window:

  • An event can be removed from a report using the Delete image006.png button.
  • An event can be added to a report using the Add button.
  • The event type can be selected using the Event dropdown.
  • The event action can be selected using the Action dropdown.

Upon triggering the event—e.g., OnReportExecuteStart will be triggered at the start of the report's execution—the associated action will take place.

Note: For more information, please see the Server Events article.

 

Show Generated SQL

As of v2019.1+, advanced users may access the Execution SQL window via the Show Generated SQL option. This window displays the SQL statement that will be sent to the appropriate databases in order to execute the report.

screen.executionsql_window.png

The SQL statement shown in the Execution SQL window is the exact statement that will be sent to the databases. It is generated after applying sorts, filters, parameters, and other items that affect the constructed SQL.


Hidden Article Information

Article Author
Nick
created 2016-01-15 17:19:11 UTC
updated 2019-06-26 17:51:32 UTC

Labels
user settings, advanced joins, advanced,
Have more questions? Submit a request