Report builder

When you insert or edit a Reporting macro, the Report Builder section displays on the right. This serves as the frame structure (container) for your report, and you can pick and add report blocks as needed. The choice of report blocks depends on the data format and how you want to present a specific value.

In the Report Builder section, you can also configure the type of report you want to generate, set the default text for an empty report, and see a preview of the report.

Adding report blocks

Report blocks are used for selecting values and adding static text, which will be shown later in the report format of your choice.

For example, if you want to view the report as a table, each report block generates one column of results for the table.

To add one or more report blocks, click the dropdown menu, select the type of report block, and click Add.

For information about the different types of report blocks and usage examples, see https://appfire.atlassian.net/wiki/spaces/RFC/pages/477333123.

Choosing a report type

Reporting can generate four different types of reports. You can select a suitable one under Report Type:

Table: The default, most commonly used type of report. Many of the example use cases for Confluence Cloud generate table reports.
List - An alternative to tables, list reports display data in bulleted rows.
Paragraph: Paragraph reports display data in rows without bullets.
Grid: Grid reports group data in three columns.

Filling in the text for empty reports

Your queries may sometimes generate no results. You can add some error handling by filling out the Empty Report section. This text is shown if the report has no results.

For example, you can enter something like No matching pages were found. Please try again later. If left empty, the default text is No Results.

Dynamic preview

The Report Builder includes a dynamic preview of the report you are building. You may need to scroll down to the bottom to view it.

The preview automatically refreshes if you change the report blocks, report type, query, expansions, or filters.