Referencing to a Sub-Report

Applies to: Kyvos Reporting

In Kyvos Reporting Studio, a sub-report can be referenced instead of embedded. When a sub-report is referenced, only its name and category are stored in the main (parent) report. The actual sub-report is fetched and executed at runtime.

Tip
Use a referenced sub-report when:

The same sub-report is used in multiple parent reports.
The sub-report is expected to undergo frequent changes.
Referencing ensures updates are automatically reflected across all parent reports without requiring individual edits.

Steps to Reference a Sub-Report

Create a sub-report frame in the layout of a report or sub-report.
In the Properties pane, set the SubReportType property to Referenced.
In the Source property, select the required sub-report.
- The CategoryName and ReferencedReportName fields auto-populate based on the selected source report.

Converting an Embedded Sub-Report to a Referenced Sub-Report

You can convert an embedded sub-report to a referenced one directly from the Studio interface.

Select the sub-report frame in the layout.
In the Properties pane, set SubReportType to Referenced.
When prompted with the Confirm Convert dialog box, click Yes.
In the Upload to Server dialog box:
- Specify the Category (report folder on server).
- Specify the Report Name.
Click Upload.
- The embedded sub-report is uploaded to the Kyvos Reporting server and becomes a referenced sub-report.
- The parent report now refers to the sub-report by category and report name.