Skip Headers

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

# 8
Building a Master/Master Report

#### Figure 8-1 Master/Master report output

Text description of the illustration Masterb_fin1.gif

Text description of the illustration Masterb_fin2.gif

A master/master report displays at least two sets of data which are not directly related--that is, the records constituting the data are fetched using at least two separate queries. A master/master report (also called a parent/parent report) contains two or more queries with no links (parent/child relationships).

#### Concepts

- Although the data may be conceptually related, the queries make no attempt to relate it by the manner in which it is fetched. To select the data for a master/master report, create two or more unrelated queries. Reports Builder will create all other necessary data objects by default.

- This report uses the default tabular layout style. You'll move the layout objects associated with the second query to insert more space between the information fetched by the two queries and make your report easier to read.

- For this report you'll create a format mask and change some of the default column labels to clarify their meanings.

#### Example Scenario

Suppose that you want to create a master layout that lists department names, numbers, and locations followed by another master layout that lists all of your employees with their job, titles, and salaries.

To see a sample master/master report, open the examples folder named `masterb`, then open the Oracle Reports example named `masterb.rdf`. For details on how to access it, see "Accessing the example reports" in the Preface.

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

Feature | Location
--- | ---
Create a new, empty report. | Section 8.2, "Create a new report manually"
Create queries | Section 8.3, "Use the Data Wizard to create two queries"
Layout the data | Section 8.4, "Use the Report Wizard to layout the data"
Add white space | Section 8.5, "Use the Paper Layout view to add white space"
Format monetary values | Section 8.6, "Format a field"

## 8.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.

## 8.2 Create a new report manually

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:

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

2. In the Welcome or New Report dialog box, select Build a new report manually, then click OK.

## 8.3 Use the Data Wizard to create two queries

When you create a report with multiple queries, it is typically easier to create all of the queries with the Data Wizard first and then create the layouts with the Reports Wizard.

#### To create the queries:

1. In the Data Model view, choose Insert > Query to display the Data Wizard.

2. If the Welcome page displays, click Next.

3. On the Query page, type `Q_Dept` for the Query name and click Next.

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

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

       SELECT DEPARTMENT_ID, DEPARTMENT_NAME, LOCATION_ID
       FROM DEPARTMENTS

   Note: You can enter this query in any of the following ways: Copy and paste the code from the provided text file called `masterb_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 8.1, "Prerequisites for this example" describes the sample schema requirements for this example.

  1. On the Groups page, click Next.

  2. Click Finish to display the data model for your report in the Data Model view.

  3. Repeat the steps above for a second query, but this time name your query `Q_Emp` and use the following SELECT statement:

         SELECT LAST_NAME, FIRST_NAME, JOB_ID, SALARY
         FROM EMPLOYEES
         ORDER BY LAST_NAME, FIRST_NAME

  #### Figure 8-2 Data model with two unrelated queries

  Text description of the illustration Masterb_dm.gif

  ## 8.4 Use the Report Wizard to layout the data

  Once your data model is complete, you need to create a layout for the data objects to display in the report output. The Report Wizard enables you to create layouts for your data model.

  Tip: When you have multiple queries in your data model, make sure that you check the names of the groups associated with each query prior to entering the Report Wizard. The Report Wizard requires you to choose data for the layout by group name.

  #### To create the layout:

  1. In the Data Model view, right-click on the canvas, then choose Report Wizard.

  2. In the Report Wizard, on the Report Type page, select Create Paper Layout only.

  3. On the Style page, select Tabular.

  4. On the Groups page, ensure that both groups from your data model appear in the Displayed Groups list.

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

  6. 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 8-3 Paper Design view for the Master/Master report

  Text description of the illustration Masterb_pd.gif

  ## 8.5 Use the Paper Layout view to add white space

  If you scroll down in the Paper Design view, you will notice that the field labels from the second query, Q_Emp, are located directly below the fields from the first query, Q_Dept. In fact, they are almost touching each other. For this report, you'll move all of the layout objects belonging to Q_Emp down the page to create some white space between the two layouts.

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

  1. Move and resize the Report Editor window such that you can easily view it and the Object Navigator simultaneously.

  2. Click the Paper Layout button in the toolbar of the Report Editor window to display the Paper Layout view.

  3. In the Object Navigator, expand the Paper Layout node, then the Main Section node, then the Body node.

  4. Click the frame named M_G_LAST_NAME_GRPFR. Note that it is also now selected in the Paper Layout view.

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

  6. Press the down arrow key a few times to move the frame and all of its objects down the page about a quarter of an inch.

     Notice that you have moved not only M_G_LAST_NAME_GRPFR but also all the layout objects within it. Here you take advantage of Confine mode, the default mode for the Paper Layout view. With Confine mode on, an object cannot be moved outside of or placed behind its parent. Such a situation renders the layout invalid and no output is produced.

     Sometimes moving an object outside of its parent is a valid action. If you need to do so, you can turn off Confine mode by clicking the Confine Off button in the toolbar.

  #### Figure 8-4 Paper Layout view with two layouts and white space added

  Text description of the illustration Masterb_pla.gif

- Save your report.

- Click the Paper Design button in the toolbar to preview your output again. Notice the additional space between the two layouts now.

  ## 8.6 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, select the first number value underneath the Salary label in the second layout. Notice that all of the values are immediately selected, indicating that you can change their properties simultaneously.

     Tip: If you are familiar with format mask syntax, you could now right-click the field values, choose Property Inspector, and choose or manually type a value for the Format Mask property.

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

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

  3. Click the Align Right tool. All of the values are immediately right aligned.

  4. Save your report.

  #### Figure 8-5 Paper Design view with monetary values formatted

  Text description of the illustration Masterb_pd2.gif

  ## 8.7 Summary

  Congratulations! You have successfully created a master/master report. You now know how to:

  - create queries with the Data Wizard.

  - layout the data with the Report Wizard.

  - create white space in the Paper Layout view.

  - format fields in the Paper Design view.

  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