Chained Reports

Chained Reports combine multiple reports into a single multi-page document. They are a convenient way to bundle related reports into a format suitable for printing or sending to a mailing list.

For example, you could combine a report on total monthly sales over time, product sales for the month, and a report highlighting this month's top selling employee. And you could schedule it to be emailed regularly at the end of every month.

A benefit of Chained Reports is that, unless you want to use collation, they do not need to have anything in common. You could chain entirely disparate reports together without a problem.

Dashboards are also exported in the form of Chained Reports in which each report or visualization tile is displayed on a single page in the report. See Exporting Dashboards for directions on how to export a Dashboard as a Chained Report.

Making a Chained Report

A Chained Report is basically a list of reports, and making a Chained Report is as simple as making a list.

To make a Chained Report:

  1. Click the New Report Add2.png icon and select NewChainedReportItem.png Chained Report. Enter a name for the Chained Report and select a folder where it should live. It does not have to be in the same folder as the reports that it contains.

    Caution: A report name cannot contain the following characters:
    \ / : * ? " < > |
  2. On the Reports panel, add the reports to include in the Chained Report. Supported report types are Advanced Reports, Express ReportsCrosstab Reports, and ExpressViews.

    The order of the reports in the list is the order they will appear in the output. Click the Up MoveGridRowUp.png or Down MoveGridRowDown.png arrows to move a report up or down in the list. Click the Delete DeleteItem.png icon to remove a report from the list.

  3. Click the Save Save.png icon to save the Chained Report.

Note about export types

If one of the reports cannot export to a certain file type, then the Chained Report cannot export to that type. All of the reports must share at least one export type, or else the Chained Report will have no compatible type to run as. Supported types are PDF, RTF (Word), CSV, and XLS (Excel).

Reports with templates

Template reports can be added to a Chained Report. The Chained Report must be exported to the same file type as the template. Multiple templates of the same file type can be chained together, with the exception of Microsoft Word based templates.

Prompting filters and parameters

If one or more reports has prompting filters or parameters, then you can set rules for what should happen when the Chained Report is run or scheduled.

To edit a report's prompting options:

  1. On the Reports panel, click the Report Options Edit.png icon.

  2. For each prompting filter and parameter, the following options are available:

    Common Prompt

    All reports which contain this filter field or parameter will use the specified value. In the Data (Prompt Text or Value) field, enter the text to prompt the user for a value.

    Report Prompt

    Only this report will use the specified value. In the Data (Prompt Text or Value) field, enter the text to prompt the user for a value.

    Assign Value

    The Chained Report will not prompt for a value for this filter or parameter. In the Data (Prompt Text or Value) field, enter the value to use.

Chained Report options

The Options page contains the following options:

Default Export Type

Select the file type to which the Chained Report will export by default. Available types are limited by report export restrictions, and by the Allowed Export Types option. HTML is not supported.


Uses the environment's default export type.

Allowed Export Types

Select which file types the Chained Report is allowed to export to. You must select at least one type.

No Data Qualified Action

If a report has no data, choose what to display:

Show Placeholder

Show the report without any data in it.

Skip Report

Show nothing, and move on to the next report.

Collate Reports on

Select whether to collate the Chained Report, and which data field to use. This option is disabled if the reports have no common data fields. See Collating reports.

Page break after each report

Select whether to start a new page after every report. This only affects PDF and RTF files.

Collating reports

Collation breaks up the reports in the Chained Report by a specified sort field, and then groups together the reports by each instance of the sort. Essentially, this turns a sort field into a common grouping for the reports, working in much the same way a group section would. This can allow you to use individual reports as pieces in a composite report.

Order of reports in a collated Chained Report

Report 1, filtered by group 1

Report 2, filtered by group 1

Report 1, filtered by group 2

Report 2, filtered by group 2

    and so on.

Some common uses for Chained Report collation include:

  • Grouping disparate reports by order number, or employee number, or something else in common

  • Combining mostly identical reports, only with different filters or joins, into a composite report

  • Making a composite report with multiples of a feature which normal reports can only have one of, such as a detail section

Caution: Collation is recommended for advanced users only. Dashboards do not have a collate option.

Hidden Article Information

Article Author
Exago Development
created 2015-12-17 15:42:47 UTC
updated 2018-11-16 21:29:55 UTC

user, collate, wizard, chain, collated, collating,
Have more questions? Submit a request