Skip to main content
Version: 24.3

The Report Builder

The Report Builder is a comprehensive and flexible interface designed to build full-featured reports.

Note: The Report Builder is not designed to build or modify dashboards.

Hover the mouse over the Add button and select Report from the dropdown list to access the Report Builder.

Navigating the Report Builder

Following is a high level overview of the Report Builder and the various components and options. The details of each component are covered elsewhere in this document.

The core steps in the building of a report involve:

  • selecting a report template
  • selecting a source of the data for the report,
  • selecting the display elements,
  • configuring the display elements, and
  • reviewing the output.

These steps will be exercised in this section just to show the navigation options.

After clicking the Add / Report option, a template selection dialog will be presented.

Template Section Dialog

Six templates are included in addition to the Blank template The Blank template is initially selected. Click on a template and then click on the OK button.

The Select or Modify Data Source dialog will be presented to allow the user to determine the data objects on which the report will be based.

Select or Modify Source Dialog

The Add/Remove tab allows the user to select all of the data objects that form the basis of the report. Until data objects have been selected for the report the other tabs will be disabled. The Calculated Columns tab allows the user to create custom columns. The Statistical Columns tab may be selected to do cursory analysis of the data. The Sort tab determines the initial sort sequence of the data returned from the reporting database. The Filter tab allows the user to specify filter criteria for the data.

The list of data objects available to the user may be filtered by the Data Objects in dropdown list. These are categories of data objects.

The data objects tree identifies the data objects available. As objects are selected the tree will be refreshed to show the related data objects. The columns of a data object can be viewed by expanding the data object. Sample data for the object can be displayed by clicking on the Magnifying Glass Icon

The Information panel will display any helpful descriptions of the data object or column that the mouse is on.

The Preview Selected Data button will display a report dialog based on the data objects selected. From this dialog the selections can be confirmed and all of the dialogs dismissed.

The OK button saves the currently selected data objects and dismisses the dialog.

Once the data objects for the report have been selected, the full Report Builder interface is available.

Report Builder Interface

Across the top of the page is the breadcrumb trail, a series of links to the pages and folders recently visited.

Bread Crum Trail

The tabbed function ribbon follows with File, Insert, and Settings tabs.

File tab

Insert tab

Settings tab

The File options are generally related to the report definition files. From this set of options you can create a new report, open an existing report, save the report definition, save the report definition by a new name or preview the current report.

The Insert options are related to display elements. The options presented in this ribbon are configurable by the administrator. The display elements may be added to the report by either clicking on the display element or drag-and-drop to a location in the Report Layout panel.

The Settings options allow the user to control the paging aspects of the report as well as select the stylesheet to be used to render the report.

Quick shortcuts are provided to save the current report definition and preview the report via the Save-icon Save and Magnify Magnify-icon icons, respectively.

On the left side of the page below the function ribbons are the Report Layout and Data Source panels.

Report Layout and Data Source

The Report Layout panel displays thumbnails of the display elements in the sequence defined in the report. Display elements may be removed by clicking on the red delete-icon icon. Display elements may be added or rearranged by drag-and-drop methods. Clicking on the display element in the Report Layout panel will open the configuration page for the display element.

The Data Source panel displays the defined sources of data for the report. Data objects, calculated columns and statistical columns are listed. The Modify Data Source button will display the Select or Modify Data Source dialog.

Either panel may be collapsed or expanded by clicking on the appropriate Arrow icon.

Centered on the page is the tabbedConfigurationpanel. Each tab allows the end user to configure some aspect of a display element. Every display element will have at least one configuration tab associated with it.

Tabular Columns

As display elements are added to the report, the number of configuration tabs will grow. When the number of tabs exceeds the page width, the tabs become scrollable.

Configuration Tabs

The Previous Step and Next Step buttons will display the contents of the previous or next configuration tab in the Configuration panel. Hovering the mouse over the buttons will display a tooltip describing the action.

Note: After an extended period of inactivity, the web server will end a browser session and work may be lost. It is a good idea to save report modifications often to avoid this scenario.

Custom reporting and Data Mart