Ad Hoc User Interface Components

The following figure illustrates the main components of the Ad Hoc Editor when you're working with data from a Topic or Domain. These components appear in all view types:

User Interface Components of the Ad Hoc Editor



Data Selection panel

This panel shows the list of fields available for adding to any bar in the Layout Band and measures – summarized values that can't be added as groups. Typically, measures are created from numeric fields in the Topic or Domain, but sometimes it makes sense to use string fields when summarized as a count. For example, you might want to display the number of unique customers that made purchases in a given quarter.

Use the icon beside the set name to expand or collapse a set of fields or measures. To hide this panel, click the icon in the top left corner; click the same icon on the minimized panel to expand it.

Change source
Select fields

Use this menu to select a different Topic or Domain for your view. All data and formatting are lost when you select a different Topic or Domain. When creating a view from a Domain, you can also select different fields to change the list that appears in this panel.

Create Calculated Field/Measure

Click to open the New Calculated Field/Measure dialog and define a calculated field or calculated measure.

The names of calculated fields are bold in the Data Selection panel; calculated fields in use are shown as bold and italic.

Use the text search fields in the panel to find a specific field or measure.

Tool bar

The tool bar at the top of the canvas provides access to many of the Ad Hoc Editor’s functions like saving the view or creating a report from the view, undoing and redoing changes, and changing the view’s sort order. For more information, refer to the JasperReports Server User Guide.

Data mode menu

Click to select the amount of data displayed from the menu. Use Sample Data or No Data to design a view more quickly, or use Full Data to see all your data used in the same view. When you choose display mode, full data is displayed regardless of the selection shown in the editor.

View type menu

Click Chart, Table, or Crosstab to change your data view. Changes to data in one view apply in all views.

Title bar

The top portion of the canvas; click to add or edit the title of the view. To remove the title, point to the Properties menu and select Toggle the Title Bar.

Layout band

Drag and drop fields and measures from the Data Selection panel to add them here. You can change the order of the selected fields by dragging them to a different location in the layout band. The boxes have different labels and functions, depending on the type of view; see the section for the individual view types for more information.

To hide the layout band, point to the Properties menu and select Hide Layout Band.


The canvas shows your data subject to the constraints you've created. This is also a sample of how your data will appear in any report you create from the view. To see the view without interface components, click for design mode.

Filters panel

This panel displays any filters defined for the view. You can set filter values and see the resulting change in the canvas. To hide the filters panel, click the icon in the top left corner of the panel. Click the same icon on the minimized panel to expand it again.

Filter controls

Control the display of filters. The menu on the filter panel lets you collapse all filters or remove all filters. The menu on each filter lets you view the filter operation, for example “is one of,” or delete the filter. To minimize the view of an individual filter, click the icon beside its name.