Previous Page Next Page

Developing Reports from HDS

When you use hierarchical data sources to create reports, you need to be aware of its limitations and unique features. For example, reports created from an HDS are automatically grouped, and an HDS cannot be directly used to create charts and crosstabs. That is to say, if you want to create a chart or crosstab from an HDS, you will need to put it in a banded object, which is created on the HDS, and make the chart/crosstab inherit the dataset of the banded object.

Hierarchical data sources can only be used to create page reports.

The following are two specific examples about developing reports from HDS.

Example 1: Developing a report from an HDS with dynamic XML URI

Example 2: Developing a report from a parallel HDS

Example 1: Developing a report from an HDS with dynamic XML URI

1. Open the catalog file SampleReports.cat in <install_root>\Demo\Reports\SampleReports.
2. In the Catalog Manager, expand the data source to which to add the HDS.
3. Right-click the Parameters node and select New Parameter from the shortcut menu.
4. In the New Parameter dialog, enter a name for the parameter, choose String as the Value Type, and in the Prompt Values box, type in the URI of the XML file from which you HDS will be imported (for details, see Creating a Parameter).
5. Right-click the data source node in the Catalog Manager, and then select New XML Hierarchical Data Source. The New XML Hierarchical Data Source dialog appears.
6. In the XML URI box, type in @ParameterName. For example, if you named the parameter in step 2 as XML_URI, here you should type in @XML_URI. In the XSD URI box, specify the URI of the corresponding XSD file. Then click OK (for details, see Importing the XML format HDS to a catalog).
7. Create a page report with the imported HDS. When you view the report, type in the URI of the XML file which matches the XSD file in the parameter. The report will then display the corresponding data.

In addition, you can also use another way to develop report with dynamic XML URI as explained below:

1. In the Catalog Manager, import an XML HDS with an XSD file, and then create a report with the imported HDS.
2. Create a parameter using the above method.
3. In the Catalog Manager, go to the node of the imported HDS, expand the Properties sheet, and then change the property URI to @ParameterName.
4. Now you can view the report with dynamic XML file.

Example 2: Developing a report from a parallel HDS

The method for developing a report from a parallel HDS is the same as from a general HDS. However, take note of the following when building reports from parallel HDSs.

Groups in parallel HDS

When you insert a group-by field, its children will also be inserted.

The parallel structure in the parallel HDS is represented as groups in JReport Designer. So, when you develop a report from a parallel HDS, it will automatically be grouped. By default, JReport Designer will use the first found field as the group-by field. Note that you can neither add a new group-by field nor remove the group-by fields that are automatically added. However, if there is more than one field available to with which to group the sub-tables, you can replace the group-by field with one of the other available fields.

Rules for inserting an object

• Objects in different branches should be placed in the banded object panel they belong to. That is, a banded object panel cannot hold objects which belong to different branches.
• The children of a branch, including the columns, formulas, summaries, sub-branches, and children of the sub-branches, can be inserted into any of their parent panels. If the parent panel is shared by more than one branch, that is, if the parent panel works as a trunk (global panel), it can be shared by the children of all the branches it holds. However, note that each instance of a panel, such as a report/page/group header/footer panel, and detail panel, can only hold the children from the same branch. If you want to insert the children of different branches into the shared global panel, you will have to create as many instances of this panel as per the number of branches, and then insert the children of each branch into these panels.
• Where a formula/summary can be inserted depends on the branch attributes of the formula/summary. Generally speaking, when a formula/summary creates relationships with a column, it will obtain the same branch attributes as those of the related column, and it can be placed in the panels where the column can be placed.

  A global formula, which is not associated with any branch columns, can be placed to any position of the report.

  • When you remove a branch using the report wizard, the related panel will also be removed.
  • A chart based on a field can only be placed in its own panels, which include most of the global panels, except for the detail panel.
  • A crosstab must be built upon data of the same branch, and it should be placed in the location where the branch data resides.
  • Where a text box object can be inserted depends on the branch attributes of the columns (formulas/summaries) that it contains. A text box object can hold only the data of the same branch.

Previous Page Next Page