Skip Headers

Oracle Reports Building Reports 10g (9.0.4) Part Number B10602-01 |
Home | Contents | Index

# 10
Building a Single-Query Group Report

#### Figure 10-1 Group report output

Text description of the illustration grp_lft2_fin.gif

Group left and group above reports divide the rows of a report into "sets," based on common values in one or more of the columns, such as the department number in the example above. Notice that each department number prints only once. If the report above was not a group report, the department number would print once for each employee in the department rather than just once for the whole department.

Note: In earlier releases, this type of report was commonly referred to as a break report or a master/detail report.

#### Example Scenario

Suppose that you want to create a group left report that lists employees with their jobs and salaries by department.

##### Table 10-1 Features demonstrated in this example

Feature | Location
--- | ---
Create a data model with a break group and default the layout | Section 10.2.1, "Create a data model with a break group and group left layout"
Format a field | Section 10.2.2, "Format a field"
Add white space between records | Section 10.2.3, "Use the Property Inspector to add white space"
Add another column to the break group | Section 10.3, "Group report with two break columns"
Add a second break group | Section 10.4, "Group report with two break groups"

## 10.1 Prerequisites for this example

To build the example in this chapter, you must have access to the sample schema provided with the Oracle9i database. If you don't know if you have access to this sample schema, contact your database administrator. You should have access to the "Human Resources" portion of the schema to complete this example.

To see a sample across report with control breaks, open the examples folder called `break`, then open the Oracle Reports example report named `grp_lft2.rdf`. For details on how to open it, see "Accessing the example reports" in the Preface.

## 10.2 Group report with one break column

The most basic case of a group left or above report is to have one break group with one break column in it. This means that a single master field value will print once for many detail field values.

To see a sample group left report with one break column, open the examples folder named `break`, then open the Oracle Reports example named `grp1col_lft1.rdf`. For details on how to access it, see "Accessing the example reports" in the Preface.

#### Concepts

- Create a group left (or above) report when you want to prevent a column from repeatedly displaying the same value while other column values in the rows change.

- You can build a group left or above report with either a single-query or multiple queries. A single-query report typically runs faster than a multiquery report.

- You'll need to make sure your SELECT statement includes a column, called a break column, containing at least one value which repeats over multiple records (e.g., department number in the example report above). With the break column, you'll create a second group, called a break group, to create the breaks in the data.

- This report uses a default tabular format. You'll improve the readability of the report by changing the vertical spacing for a repeating frame to insert a space between each set of department information (e.g., between the last record of Department 10 and the first record of Department 20, as shown in the example report above). You'll also add a format mask.

### 10.2.1 Create a data model with a break group and group left layout

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:

1. Launch Reports Builder (or, if already open, choose File > New > Report)

2. In the Welcome or New Report dialog box, select Use the Report Wizard, then click OK.

3. If the Welcome page displays, click Next.

4. On the Report Type page, select Create Paper Layout Only, then click Next.

5. On the Style page, type a Title for your report, select Group Left, then click Next.

6. On the Data Source page, click SQL Query, then click Next.

7. On the Data page, enter the following SELECT statement in the Data Source definition field:

       SELECT EMPLOYEE_ID, FIRST_NAME, LAST_NAME,
       JOB_ID, SALARY, DEPARTMENT_ID
       FROM EMPLOYEES

Note: You can enter this query in any of the following ways: Copy and paste the code from the provided text file called `across_code.txt` into the Data Source definition field. Click Query Builder to build the query without entering any code manually. Type the code in the Data Source definition field.

- Click Next.

  Note: If you are not already connected to a database, you will be prompted to connect to the database when you click Next. Ensure that you connect to a database that has the appropriate schema for this example. Section 10.1, "Prerequisites for this example" describes the sample schema requirements for this example.

  1. On the Groups page, click DEPARTMENT_ID and click the right arrow (>) to move this field to the Group Fields list, then click Next.

  #### Figure 10-2 Groups page of the Report Wizard

  Text description of the illustration grp1col_lft1_break.gif

  1. On the Fields page, click the double right arrows (>>) to move all of the fields to the Displayed Fields list.

  #### Figure 10-3 Fields page of the Report Wizard

  Text description of the illustration grp1col_lft1_disp.gif

  1. Click Next until you reach the Template page of the Report Wizard.

  2. On the Template page, select Predefined Template and click Beige, then click Finish to display your report output in the Paper Design view. It should look something like this:

  #### Figure 10-4 Paper Design view for the single-query group left report

  Text description of the illustration grp1col_lft1_out1.gif

  ### 10.2.2 Format a field

  In the Paper Design view, notice the Salary field. The values are neither aligned nor displayed as monetary amounts. You can quickly rectify this in the Paper Design view.

  #### To assign a format mask to monetary values:

  1. In the Paper Design view, click the first number value underneath the Salary label. Notice that all of the values are immediately selected, indicating that you can change their properties simultaneously.

  2. Click the Currency button in the toolbar. A currency symbol immediately appears next to all of the values.

  3. Click the Add Decimal Place tool twice. Two decimal places are added to the right of the decimal point.

  4. Resize the fields. Click and drag the rightmost handle of the cell value under the Salary label about 0.5 inches to the left.

  5. Shift-click on the Salary label.

  6. Click the Align Right tool in the tool bar.

  7. Click in an open area of the Paper Design view to deselect all of the objects.

  8. Save your report.

  #### Figure 10-5 Salaries formatted

  Text description of the illustration grp1col_lft1_out2.gif

  ### 10.2.3 Use the Property Inspector to add white space

  If you examine your report output in the Paper Design view, you will notice that it can be difficult to distinguish where one department's data ends and the next department's data begins. To make the report more readable, you want to add some white space between the departments, but you want to retain the same spacing between employee rows. For this report, you'll change a repeating frame property for the master repeating frame to create some white space between the department records.

  #### To create white space between the departments:

  1. In the Paper Design view, click the first number value underneath the Department Id label. Notice that all of the department numbers are immediately selected.

  2. Click the Select Parent Frame button in the toolbar. Notice how the border of the repeating frame that contains the Department Id field is now highlighted.

  3. Choose Tools > Property Inspector to display the Property Inspector, and set properties:

  - Under Repeating Frame, set the Vert. Space Between Frames property to 0.25.

  #### Figure 10-6 Property Inspector for master repeating frame

  Text description of the illustration grp1col_lft1_pi.gif

  1. Click the title bar of the Report Editor to make it the active window again.

  2. Save your report.

  #### Figure 10-7 Paper Design view after white space is added

  Text description of the illustration grp1col_lft1_out3.gif

  ## 10.3 Group report with two break columns

  #### Figure 10-8 Group left report output with two break columns

  Text description of the illustration grp2col_lft1_out.gif

  The report above looks similar to the group left report you built in Section 10.2, "Group report with one break column". However, notice that DEPARTMENT_ID values sometimes print more frequently than they did in the previous report. The DEPARTMENT_ID value repeats for each unique value of JOB_ID within the department. This behavior occurs because DEPARTMENT_ID is now grouped with JOB_ID and must print with JOB_ID. While DEPARTMENT_ID values may repeat several times, not until the position of PU_CLERK in department 30 does a job repeat, and not until that point can the break group actually break.

  #### Concepts

  - You can specify that your report break on certain combinations of information by varying the columns you include in the break group.

  - You can modify your previous report by moving JOB_ID into the break group, so that your report has two break columns instead of one.

  - After changing the data model, redefault the layout to incorporate your changes, then specify the format mask again.

  To see a sample group left report with two break columns, open the examples folder named `break`, then open the Oracle Reports example named `grp2col_lft1.rdf`. For details on how to access it, see "Accessing the example reports" in the Preface.

  ### 10.3.1 Modify the data model

  The first task in changing your previous report is to modify the data model by placing an additional column in the break group.

  #### To add a column to the break group:

  1. Open the report you created in the previous section.

  2. In the Object Navigator, double-click the view icon next to the Data Model node to display the Data Model view.

  3. In the Data Model view, click the break group, G_DEPARTMENT_ID, then click and drag the handle on the bottom center of the G_DEPARTMENT_ID group box down about a quarter of an inch to resize it.

  4. Click and drag on the JOB_ID column in the G_EMPLOYEE_ID group and move it into the G_DEPARTMENT_ID group, underneath the DEPARTMENT_ID column.

  #### Figure 10-9 Data model with two break columns

  Text description of the illustration grp1col_lft1_dm.gif

  ### 10.3.2 Redefault the layout

  In order for your data model change to be reflected in your output, you need to redefault the layout for your report using the Report Wizard.

  #### To redefault the layout with the Report Wizard:

  1. Click the title bar of the Report Editor to make it the active window. The Report Editor must be the active window in order for you to access the Report Wizard.

  2. Choose Tools > Report Wizard.

  3. Select Create Paper Layout only.

  4. Click Finish. Notice the changes to the output in the Paper Design view. Also note how the formatting of the Salary field and the additional spacing between records is retained. When possible, Reports Builder will retain your manual modifications between uses of the Report Wizard.

  5. Save your report.

  ## 10.4 Group report with two break groups

  #### Figure 10-10 Group left report output with two break groups

  Text description of the illustration grp_lft2_fin.gif

  The figure above shows a further modification of your group left report. In this version, DEPARTMENT_ID prints only once for each department. JOB_ID also prints only once when more than one employee in a department has the same job. Both columns are now in separate break groups and DEPARTMENT_ID is in the higher group. Hence, it does not repeat for each unique value of JOB_ID within a department any more.

  #### Concepts

  - You can also create reports that include multiple break groups and assign one or more columns to each break group.

  - You'll further modify the data model to include two break groups: G_DEPARTMENT_ID and G_JOB_ID.

  - After changing the data model, redefault the layout to incorporate your changes, then specify the format mask again.

  To see a sample group left report with two break groups, open the examples folder named `break`, then open the Oracle Reports example named `grp_lft2.rdf`. For details on how to access it, see "Accessing the example reports" in the Preface.

  ### 10.4.1 Modify the data model

  The first task in changing your previous report is to modify the data model by creating another break group.

  #### To add another break group:

  1. Open the report you created in the previous section.

  2. In the Object Navigator, double-click the view icon next to the Data Model node to display the Data Model view.

  3. In the Data Model view, click and drag the group, G_EMPLOYEE_ID, down about a quarter of an inch.

  4. Click the JOB_ID column in G_DEPARTMENT_ID and drag it to a spot somewhere in between G_DEPARTMENT_ID and G_EMPLOYEE_ID. Another break called G_JOB_ID is created.

  ### 10.4.2 Redefault the layout

  In order for your data model change to be reflected in your output, you need to redefault the layout for your report using the Report Wizard.

  #### To redefault the layout with the Report Wizard:

  1. Click the title bar of the Report Editor to make it the active window. The Report Editor must be the active window in order for you to access the Report Wizard.

  2. Choose Tools > Report Wizard.

  3. Select Create Paper Layout only.

  4. Click Finish. Notice the changes to the output in the Paper Design view.

  5. Save your report.

  ## 10.5 Summary

  Congratulations! You have successfully created a single-query group report. You now know how to:

  - create a data model and layout with the Report Wizard.

  - format fields in the Paper Design view.

  - add white space between records with the Property Inspector.

  - add another column to the break group and redefault the layout.

  - add another break group and redefault the layout.

  For more information on any of the wizards, views, or properties used in this example, refer to the Reports Builder online help, which you can access in two ways:

  - From the Oracle Technology Network (`http://otn.oracle.com/products/reports/`), click Documentation and navigate to the Reports Builder Online Help for the most recent, hosted online help.

  - From Reports Builder, choose Help > Help Contents.

    Note: You can replace your Reports Builder online help with the most recent update by downloading the latest online help set available on the Oracle Technology Network (http://otn.oracle.com/docs/products/reports/). Instructions for replacing your help file are included in the readme.txt in the download file.

| Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
Home | Contents | Index