Subreports

Subreports can be used to have several reports embedded into one main report.

Each subreport should be attached to the main report by creating a record at the Subreports property of a Report. This property has the following fields:

Field Description

Field Name

Name. Unique name of the subreport. By this name the subreport will be referenced from parent report template.

name

Template Type. Type of the subreport's template. Static means the template is obtained from the report context selected at the Template field. Dynamic means that the template is evaluated from the Template Expression field.

templateType

Template. A Report context will be used as the subreport template for the Static subreport.

template

Template Expression. An expression that should return a template for the subreport in case of Dynamic template type. It should be evaluated to an XML string.

templateExpression

Data Type. Type of the subreport's source data. Static means the data is obtained from the report context selected in the Template field. Dynamic means that the data is evaluated from the Data Expression field.

dataType

Data Expression. An expression that should return a Data Table will be used as source data for the subreport.

dataExpression

Resolution Environment

Template Expression and Data Expression Resolution Environment:

Default Context

For an absolute report, the report context itself.

For a relative report, a context the report is launched for.

Default Data Table

Report parameters table (if report is parameterized). It means that references in the Value expression may refer to fields defined by the parameters format of the parameterizer source data.

Default Row

0

Environment Variables

Standard variables only.

Using Subreports in Report Editor

As long as Iotellect stores report templates inside its logical structure, there are some peculiarities working with subreports in Report Editor. A special report's STORAGE parameter is used to access subreport templates, data sources and resources. To properly setup a subreport component after adding it to a report template you should set the following properties of the component:

  • Subreport Expression. This expression defines the way the subreport template is obtained. $P{STORAGE}.subReport("<subreportName>") expression should be used where <subreportName> is the name of the subreport from Subreports table property.
  • Connection Type. Should be set to Use a datasource expression. This allows to define a data source expression.
  • Data Source Expression. This expression returns the subreport's data source. $P{STORAGE}.dataSource("<subreportName>") expression should be used. Where <subreportName> is the name of the subreport from Subreports table property.

Was this page helpful?