Oracle® Reports Building Reports
10g Release 2 (10.1.2) B13895-01 |
|
Previous |
Next |
In this chapter, you will learn about nested matrix reports. By following the steps in this chapter, you can generate the report output shown in Figure 26-1.
Concepts
A nested matrix report is a matrix report which contains more than the usual two dimensions (across and down) of a simple matrix.
You can create nested matrix reports with any number of queries. In Section 26.2, "Create a single-query matrix", you'll create the example nested matrix report using one query. In Section 26.3, "Create a multiple-query matrix", you'll use multiple queries. In Section 26.4, "Create a multiple-query matrix with a break", you will use not only group hierarchy to nest one dimension within another, but you'll also create a true parent/child relationship between the relevant groups by explicitly creating a new group and placing it within the cross product and above the other group. This will restrict the records displayed to only those for which data exists.
Notes:
|
This example report uses a matrix with three dimensions, created by including three columns in the cross product. The cross product is capable of displaying every possible value for three dimensions: two down (YEAR and DEPTNO) and one across (JOB). This method does not include rows that have null values because there is a break group within the cross product group in the data model. As mentioned above, this chapter describes how to create a nested matrix with and without a break group inside of the cross product group so that you can see the difference in the output.
The order in which the two down dimensions (YEAR and DEPTNO) will be displayed is based upon the order in which you position their corresponding groups within the cross product; that is, of YEAR and DEPTNO, you'll position YEAR to the left of DEPTNO. This "nests" DEPTNO inside of YEAR and causes all records for DEPTNO to appear for each value of YEAR, regardless of whether that department has any data for that year.
For additional conceptual information, see Section 2.1.7, "About nested matrix reports".
Example Scenario
In this example, you will create a report that cross tabulates salaries by year and department, and by job function. The result is a matrix with job functions listed across the top, years and departments down the side, and sums of salaries in the cells. Thus, you can quickly determine the sum of all of the salaries for clerks in department 20 and compare that value to the one for all clerks in some other department.
As you build this example report, you will:
Create a multiple-query matrix with a break within the cross product group.
To see a sample nested matrix report, open the examples folder named nestedmatrix
, then open any of the Oracle Reports examples named nested1b.rdf
, nested3b.rdf
, or nested4b_brk.rdf
. For details on how to access them, see "Accessing the Example Reports" in the Preface.
To build the example in this chapter, you must have access to the SCOTT sample schema provided with the Oracle Database. If you do not know if you have access to this sample schema, contact your database administrator.
You can build a matrix report with a single-query in the data model. A single-query data model typically performs better than a multiple-query data model.
When you are creating a single-query report, such as this one, you can use the Report Wizard to create the data model and layout simultaneously.
To create a data model and layout:
Launch Reports Builder (or, if already open, choose File > New > Report).
In the Welcome or New Report dialog box, select Use the Report Wizard, then click OK.
If the Welcome page displays, click Next.
On the Report Type page, select Create Paper Layout Only, then click Next.
On the Style page, type a Title for your report, select Matrix, then click Next.
On the Data Source page, click SQL Query, then click Next.
On the Data page, enter the following SELECT
statement in the Data Source definition field:
SELECT TO_CHAR (HIREDATE, 'YY') YEAR, DEPTNO, JOB, SUM (SAL) FROM EMP GROUP BY TO_CHAR(HIREDATE, 'YY'), DEPTNO, JOB ORDER BY TO_CHAR(HIREDATE, 'YY'), DEPTNO, JOB
Note: You can enter this query in any of the following ways:
|
Note: If you are not already connected to a database, you will be prompted to connect to the database when you click Query Builder or Next. Ensure that you connect to a database that has the appropriate schema for this example. Section 26.1, "Prerequisites for this example" describes the sample schema requirements for this example. |
On the Rows page:
Click YEAR in the Available Fields list and click the right arrow (>) to move this field to the Matrix Row Fields list. YEAR should appear under Level 1.
Figure 26-2 First matrix row in the Report Wizard
Click Level 1 in the Matrix Row Fields list. This step ensures that the next column added will be at Level 2 rather than Level 1.
Click DEPTNO in the Available Fields list and click the right arrow (>) to move this field to the Matrix Row Fields list. Notice that it is added under Level 2 rather than Level 1.
Figure 26-3 Second matrix row in Report Wizard
Click Next.
On the Columns page, click JOB and click the right arrow (>) to move this field to the Matrix Column Fields list. JOB should appear under Level 1, then click Next.
On the Cell page, click SUM_SAL and click the right arrow (>) to move this field to the Matrix Cell Fields list, then click Next.
On the Totals page, click Next.
On the Labels page, change the labels and field widths as follows, then click Next:
Fields | Labels | Width |
---|---|---|
YEAR | (no change)
|
4
|
DEPTNO | (no change)
|
(no change)
|
JOB | (no change)
|
10
|
SUM_SAL | <none>
|
10
|
On the Template page, make sure Beige is selected under Predefined Template, then click Finish to display your report output in the Paper Design view. It should look like this:
Figure 26-4 Paper Design view for the nested matrix report
Note: You can set alignment and format monetary values directly in the Paper Design view. Simply click the item, then click the appropriate toolbar button (if you run the mouse over these buttons, hint text displays). If the Paper Design view and the Object Navigator are displayed side-by-side, notice that when you select an item in one, the selection is reflected in the other. |
You can build a matrix report with multiple queries in the data model. A multiple-query data model is typically easier to conceptualize and code than a single-query, but the single-query data model typically performs better.
In this case, it is easier to create the data model and layout separately. Hence, we will create an empty report first, then add the queries, and then create the layouts.
To create a blank report:
Choose File > New > Report.
Select Build a new report manually, then click OK.
When you create a matrix report with multiple queries, it is typically easier to create all of the queries with the Data Wizard first and then create the cross product group and the necessary links in the Data Model view.
To create the queries:
In the Data Model view, choose Insert > Query to display the Data Wizard.
If the Welcome page displays, click Next.
On the Query page, type Q_Year
for the Query name, then click Next.
On the Data Source page, select SQL Query, then click Next.
On the Data page, enter the following SELECT
statement in the Data Source definition field:
SELECT DISTINCT TO_CHAR (HIREDATE, 'YY') YEAR FROM EMP
Note: You can enter this query in any of the following ways:
|
Click Next.
Note: If you are not already connected to a database, you will be prompted to connect to the database when you click Query Builder or Next. Ensure that you connect to a database that has the appropriate schema for this example. Section 26.1, "Prerequisites for this example" describes the sample schema requirements for this example. |
On the Groups page, click Next.
Click Finish to display the data model for your report in the Data Model view.
Repeat the steps above for a second query, but this time name your query Q_Dept
and use the following SELECT
statement:
SELECT DISTINCT DEPTNO FROM EMP
Note: You can enter these queries in any of the following ways:
|
Again, repeat the steps above for a third query, but this time name your query Q_Job
and use the following SELECT
statement:
SELECT DISTINCT JOB FROM EMP
Again, repeat the steps above for a fourth query, but this time name your query Q_Salary
and use the following SELECT
statement:
SELECT TO_CHAR(HIREDATE, 'YY') YEAR, DEPTNO, JOB, SUM(SAL) FROM EMP GROUP BY TO_CHAR(HIREDATE, 'YY'), DEPTNO, JOB ORDER BY TO_CHAR(HIREDATE, 'YY'), DEPTNO, JOB
Tip: The order of the queries is significant in this case. Q_Dept must appear to the right of or below Q_Year in order for the values of DEPTNO to be nested inside of the values of YEAR in the output. |
To create the cross product group:
In the Data Model view, click the Cross Product tool in the tool palette.
Drag a box around G_YEAR, G_DEPTNO, and G_JOB. When you release the mouse button, the cross product group is created. Ensure that it completely surrounds all three groups.
Figure 26-6 Data Model with four queries and a cross product group
To add the data links:
In the Data Model view, click the Data Link tool in the tool palette.
Click and drag from the YEAR column in the G_YEAR group to the YEAR1 column in the G_YEAR1 group.
Repeat steps 1 and 2, but this time drag the link between the DEPTNO column in G_DEPTNO and DEPTNO1 in G_YEAR1.
Again, repeat steps 1 and 2, but this time drag the link between the JOB column in G_JOB and JOB1 in G_YEAR1.
Optionally, move the data model objects around to appear like the above figure.
Once your data model is complete, you need to create a layout for the data objects to display in the report output.
To create the layout:
In the Data Model view, right-click on the canvas, then choose Report Wizard.
In the Report Wizard, on the Report Type page, select Create Paper Layout only.
On the Style page, select Matrix.
On the Groups page, ensure that all of the groups from your data model appear in the Displayed Groups list. G_1 should be Matrix, G_YEAR and G_DEPTNO should be Down, G_JOB should be Across, and G_YEAR1 should be Down.
Figure 26-8 Groups page of the Report Wizard
On the Fields page, ensure that only the following columns appear in the Displayed Fields list:
YEAR
DEPTNO
JOB
SUM_SAL
Figure 26-9 Fields page of the Report Wizard
On the Labels page, change the labels and field widths as follows:
Fields | Labels | Width |
---|---|---|
SUM_SAL | <none>
|
10
|
YEAR | <none> | 4
|
JOB | <none> | 10
|
On the Template page, make sure Beige is selected under Predefined Template, then click Finish to display your report output in the Paper Design view. It should look like this:
Figure 26-10 Paper Design view for the nested matrix output
If you compare the single-query nested matrix output in Figure 26-4, "Paper Design view for the nested matrix report" to the multiple-query output in Figure 26-10, "Paper Design view for the nested matrix output", you notice that the multiple-query case displays all of the departments for every year while the single-query case does not. In the single-query case, only those departments that actually have values in their matrix cells are displayed in the output. To achieve a similar result with multiple queries, you need to have a parent/child relationship between the groups containing YEAR and DEPTNO.
In this case, it is easier to create the data model and layout separately. Hence, we will create an empty report first, then add the queries, and then create the layouts.
To create a blank report:
Choose File > New > Report.
Select Build a new report manually, then click OK.
When you create a matrix report with multiple queries, it is typically easier to create all of the queries with the Data Wizard first and then create the cross product group and the necessary links in the Data Model view.
To create the queries:
In the Data Model view, choose Insert > Query to display the Data Wizard.
If the Welcome page displays, click Next.
On the Query page, type Q_Dept
for the Query name, then click Next.
On the Data Source page, select SQL Query, then click Next.
On the Data page, enter the following SELECT
statement in the Data Source definition field:
SELECT TO_CHAR(HIREDATE, 'YY') YEAR, DEPTNO FROM EMP GROUP BY TO_CHAR(HIREDATE, 'YY'), DEPTNO ORDER BY TO_CHAR(HIREDATE, 'YY'), DEPTNO
Note: You can enter this query in any of the following ways:
|
Click Next.
Note: If you are not already connected to a database, you will be prompted to connect to the database when you click Query Builder or Next. Ensure that you connect to a database that has the appropriate schema for this example. Section 26.1, "Prerequisites for this example" describes the sample schema requirements for this example. |
On the Groups page, click YEAR in the Available Fields list and click the right arrow (>) to move this field to the Group Fields list, then click Next.
On the Totals page, click Next.
Click Finish to display the data model for your report output in the Data Model view.
Choose Insert > Query and follow the steps above to create another query named Q_Job
and use the following SELECT
statement:
SELECT DISTINCT JOB FROM EMP
Again, choose Insert > Query and follow the steps above to create a third query named Q_Salary
and use the following SELECT
statement:
SELECT TO_CHAR(HIREDATE, 'YY') YEAR, DEPTNO, JOB, SUM(SAL) FROM EMP GROUP BY TO_CHAR(HIREDATE, 'YY'), DEPTNO, JOB ORDER BY TO_CHAR(HIREDATE, 'YY'), DEPTNO, JOB
Figure 26-11 Data model with three queries
To create the cross product group:
In the Data Model view, click the Cross Product tool in the tool palette.
Drag a box around G_YEAR, G_DEPTNO, and G_JOB. When you release the mouse button, the cross product group is created. Ensure that it completely surrounds all three groups.
Figure 26-12 Data Model with three queries and a cross product group
To add the data links:
In the Data Model view, click the Data Link tool in the tool palette.
Click and drag from the YEAR column in the G_YEAR group to the YEAR1 column in the G_YEAR1 group.
Repeat steps 1 and 2, but this time drag the link between the DEPTNO column in G_DEPTNO and DEPTNO1 in G_YEAR1.
Again, repeat steps 1 and 2, but this time drag the link between the JOB column in G_JOB and JOB1 in G_YEAR1.
Optionally, move the data model objects around to appear like the above figure.
Once your data model is complete, you need to create a layout for the data objects to display in the report output.
To create the layout:
In the Data Model view, right-click on the canvas, then choose Report Wizard.
In the Report Wizard, on the Report Type page, select Create Paper Layout only.
On the Style page, select Matrix.
On the Groups page, ensure that all of the groups from your data model appear in the Displayed Groups list. G_1 should be Matrix, G_YEAR and G_DEPTNO should be Down, G_JOB should be Across, and G_YEAR1 should be Down.
Figure 26-14 Groups page of the Report Wizard
On the Fields page, ensure that only the following columns appear in the Displayed Fields list:
YEAR
DEPTNO
JOB
SUM_SAL
Figure 26-15 Fields page of the Report Wizard
On the Labels page, change the labels and field widths as follows:
Fields | Labels | Width |
---|---|---|
SUM_SAL | <none>
|
10
|
YEAR | <none> | 4
|
JOB | <none> | 10
|
On the Template page, make sure Beige is selected under Predefined Template, then click Finish to display your report output in the Paper Design view. It should look like this:
Figure 26-16 Paper Design view for the final nested matrix report output
To make your matrix report more readable, you should format the monetary values.
To format monetary values:
On the first page of the report, click one of the cell values. Notice that all of the values are immediately selected, indicating that you can change their properties simultaneously.
Click the Currency button in the toolbar. A currency symbol immediately appears next to all of the values.
Click the Add Decimal Place button in the toolbar twice. Two decimal places are added to the right of the decimal point.
Resize the fields. Click and drag the rightmost handle of the cell value under the SALESMAN label about 0.5 inches (1.5 centimeters) to the left. After you complete this operation, the department summaries from the second page should move onto the first page.
Shift-click the SALESMAN label.
Click the Align Right button in the toolbar.
Click in an open area of the Paper Design view to deselect all of the objects.
Figure 26-17 Nested matrix report output with formatted monetary values
Save your report as nested4b_brk_
your_initials
.rdf
Congratulations! You have successfully created three nested matrix reports. You now know how to:
create a nested matrix report with a single-query data model.
create a nested matrix report with a multiple-query data model.
create a nested matrix report with multiple queries and a break within the cross product group.
format monetary values.
For more information on any of the wizards, views, or properties used in this example, refer to the Oracle Reports online Help, which is available in Reports Builder or hosted on the Oracle Technology Network (OTN), as described in Section 3.1.1, "Using the Oracle Reports online Help".