Basic report elements

The layout designer provides a drag-and-drop interface to add labels or images to your report or manipulate the design properties of the elements. You can edit the labels and change the properties using scripts if you wish.

The basic view of the Layout Designer consists of:

  1. Report design box

  2. Toolbar

  3. Properties

  4. Expressions

  5. Basic data structure tree in aqua

  6. Report tree

The toolbar on the left allows you to drag and drop new elements, such as labels, images or charts, into the report design field.

The properties ribbon on the right gives you the ability to easily manipulate the design of an element and add some scripting functionality to an event that is triggered by the element during report generation. Expressions can define short statements for fields, e.g. to manipulate strings or colours when certain conditions are met.

The aqua project element tree on the right can be used to associate a label with a particular element. The text value of the label is then set to the value of the element. The element tree of the report is intended to be used for better orientation within the report.


Bands are sections that can be bound to some data pools, and then the bands are printed once for each element in the data pool. In aqua, for example, this data pool might only consist of test cases within the selected project folder/subfolder.

A detailed report can be added within a band. For example, for test cases, a detail report could be bound to all related requirements. Then, when the report is printed for each test case, it will iterate through all related requirements of that test case before printing the next test case and its related requirements. Typical bands within a report are:

  • PageHeader

  • ReportHeader

  • PageFooter

  • ReportFooter

Control elements

Control elements are any layout elements within a report, such as a label, image, chart, pivot table, lines, numbers, borders, etc.

These elements can be bound to a particular tree element value of the report.

For example, if you bind a label to the name value of the test case report, then the text value of this label will be set to the name of the test case currently being processed for each band iteration. During report generation, these control elements trigger various events, such as before or after print events. When these events are triggered by the element, you can define a script method to be executed. This method is available for each type of control, both charts and labels.

Last updated