19 Building a Report that Renumbers Pages by Repeating Frame

19.1 Prerequisites for this example

• To build the example in this chapter, you must have access to the Summit Sporting Goods (SUMMIT) schema. To download the SQL scripts that install the schema, see "Accessing the Data Sources" in the Preface. Only the EMP, CUSTOMER, and SALES tables are required.

• The HTML view of the report that displays the page number technique must be deployed through a report server using the report in JSP or RDF format and HTML as the destination format. For example:

  http://computer_host:port/reports/rwservlet?report=pgnum.rdf &userid=scott/tiger@my_database&destype=cache&desformat=html&server=rep_server
  

19.2 Create a data model and a group above 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 group above 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 both Web and Paper Layout, then click Next.

5. On the Style page, type a Title for your report, select Group Above, 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 ENAME, REPID, CUSTID, NAME, ADDRESS, TRIM(CITY)||',
   '||STATE||'  '||ZIP LOCATION,  AREA||' '||PHONE, CREDITLIMIT 
   FROM EMP, CUSTOMER 
   WHERE EMPNO = REPID 
   ORDER BY REPID
   

   
   

   Note: You can enter this query in any of the following ways: Copy and paste the code from the provided text file called pagenum_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.

   
   

8. 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 19.1, "Prerequisites for this example" describes the sample schema requirements for this example.

   
   

9. On the Groups page, click ENAME in the Available Fields list and click the right arrow (>) to move this field to the Group Fields list.

10. Move REPID to the Group Fields list, too, then click Next.

    Figure 19-2 Selecting group fields in the Report Wizard

    
    Description of "Figure 19-2 Selecting group fields in the Report Wizard"
    
    

11. On the Fields page, click the double right arrows (>>) to move all of the fields to the Displayed Fields list, then click CUSTID and click the left arrow (<) to move it back to the Available Fields list, then click Next.

12. On the Totals page, click Next.

13. On the Labels page, change the labels and field widths as follows, then click Next:

    Fields	Labels	Width
    ENAME	Rep Name	10
    REPID	Rep ID	6
    NAME	Customer Name	20
    ADDRESS	Address	20
    LOCATION	Location	20
    AREA_PHONE	Area Phone	12
    CREDITLIMIT	Credit Limit	8

    
    

    Figure 19-3 Specifying labels and widths in the Report Wizard

    
    Description of "Figure 19-3 Specifying labels and widths in the Report Wizard"
    
    

14. On the Template page, click Finish to display your report output in the Paper Design view.

15. Save the report as pagenum_your_initials.rdf.

19.3 Add a second query

In the Paper Design view, the data is grouped by the Sales Representative with customer data listed below each Sales Representative.

Figure 19-4 Report layout in the Paper Design view

Description of "Figure 19-4 Report layout in the Paper Design view"

All the data will display on one page and the individual sales transactions for each customer is not yet available. You will need an additional query in the Data Model to accomplish this.

To add a new query to the report:

1. Click the Data Model button in the toolbar.

2. In the Data Model view, click the SQL Query tool in the tool palette then click in an open area of the Data Model view, somewhere to the right of query Q_1, to display the SQL Query Statement dialog box.

3. In the SQL Query Statement field, enter the following SELECT statement:

   SELECT CUSTID,PRODNAME,AMOUNT
   FROM SALES
   ORDER BY CUSTID
   
   

4. Click OK to display the new query in the Data Model view.

5. In the Data Model view, click the Data Link tool in the tool palette.

6. Using the cross hairs of the cursor, click CUSTID in the G_NAME group and drag the cursor to custid1 in the G_custid1 group, then release the mouse button to link the CUSTID and custid1 fields between the two groups.

7. Position the Report Editor window to display it alongside the Object Navigator so that you can view both windows simultaneously.

8. In the Object Navigator, under the Data Model node, expand the Groups node. Then, under the Paper Layout node, expand the Main Section node. Compare these two structures and note that even though additional data is made available in the Data Model by adding query Q_2, the Paper Layout will not use this additional data unless modified to do so. We will do this next.

19.4 Redefault the layout

To redefault the layout to use the additional query data:

1. In the Object Navigator, click the report name.

2. Choose Tools > Report Wizard to re-enter the wizard.

3. In the Report Wizard, on the Groups page, click G_custid1 in the Available Groups list and click Down to specify the Print Direction and move this group to the Displayed Groups list.

4. On the Fields page, click prodname and amount in the Available Fields list and click the right arrow (>) to move these fields to the Displayed Fields list.

5. On the Labels page, change the labels and field widths as follows:

   Fields	Labels	Width
   prodname	Product Name	30
   amount	Amount	9

   
   

6. On the Template page, click Finish to display your report output in the Paper Design view. It should look something like this:

Figure 19-5 Revised report layout in Paper Design view

Description of "Figure 19-5 Revised report layout in Paper Design view"

Note that the data is still grouped by the Sales Representative with customer data listed below each Sales Representative. But now, the individual products sold to the customers are listed below each customer. The report now has multiple pages.

19.5 Set properties and format fields

To set properties and format the fields of your report:

1. In the Object Navigator, click the Paper Layout node and click the Expand All button in the toolbar.

2. Double-click the repeating frame icon next to the R_G_ENAME node to display the Property Inspector, and set the following properties:

   • Under Repeating Frame, set the Maximum Records per Page property to 1.

3. In the Object Navigator, double-click the repeating frame icon next to the R_G_CUSTID1 node to display the Property Inspector, and set the following properties:

   • Under Repeating Frame, set the Vert. Space Between Frames property to 0.25 to specify 0.25 inches (0.5 centimeters) of vertical space between instances of the repeating frame; that is, between each customer record.

   • Under General Layout, set the Page Protect property to Yes to specify that the first instance of the repeating frame (that is, the first customer record) must all fit on the same logical page.

4. In the Object Navigator, click the F_CREDITLIMIT node, then Ctrl-click F_AMOUNT to select both nodes.

5. Click the Paper Design button in the toolbar to make the Paper Design view the active window, with the F_CREDITLIMIT and F_AMOUNT fields selected, and make the format changes (you can also click the corresponding buttons in the toolbar):

   • choose Format > Number > Currency

   • choose Format > Number > Add Decimal Place

   • choose Format > Number > Add Decimal Place (again, for two decimal places)

   • choose Format > Justify > Right

6. In the Paper Design view, click the Amount label (column heading), and choose Format > Justify > Right.

19.6 Create new fields

To create new fields for the page numbers of the report:

1. Click the Paper Layout button in the toolbar to display the Paper Layout view.

2. In the Paper Layout view, click the Edit Margin button in the toolbar to display the margin areas of your report. You will be creating two page number fields in the top margin, as shown here:

   Figure 19-6 Page number source fields in top margin of report

   
   Description of "Figure 19-6 Page number source fields in top margin of report"
   
   

3. Click the Field tool in the tool palette and draw a field about two characters long in the center of your margin.

4. Double-click the new field object (F_1) to display the Property Inspector, and set the following properties:

   • Under General Information, set the Name property to F_TOTAL_PAGENO.

   • Under Field, set the Source property to Total Pages, and set the Visible property to No.

   • Under General Layout, set the Horizontal Elasticity property to Variable.

     Hiding both this field and the field you'll create below ensures that they'll appear only where you reference them. Changing the horizontal sizing to Variable ensures that the fields can expand to accommodate large page ranges.

   • Under Field, click the Page Numbering property field to display the Page Numbering dialog box:

     In the Reset at list, click R_G_ENAME, and verify that the Start at and Increment by values are both 1, then click OK.

5. Close the Property Inspector.

6. In the Paper Layout view, click the F_TOTAL_PAGENO field.

7. Choose Edit > Copy, then choose Edit > Paste to create a new field with the same dimensions as F_TOTAL_PAGENO next to F_TOTAL_PAGENO.

8. Drag the new field object (F_TOTAL_PAGENO1) to an open area of the margin.

9. Double-click the new field object (F_TOTAL_PAGENO1) to display its Property Inspector, and make the following changes:

   • Under General Information, set the Name property to F_PAGENO.

   • Under Field, set the Source property to Page Number.

     Because it is a duplicate of F_TOTAL_PAGENO, the Horizontal Elasticity and Visible properties are already set as desired.

   • Under Field, click the Page Numbering property field to display the Page Numbering dialog box.

     In the Reset at list, click R_G_ENAME, and verify that the Start at and Increment by values are both 1, then click OK.

10. Close the Property Inspector.

Next, you will reference these fields in a text box to display page numbers in the format "Page X of Y Pages."

19.7 Reference fields

To reference the page number fields:

1. In the Paper Layout view, click the Line Color tool in the tool palette.

2. In the color palette, click No Line.

3. Click the Text tool in the tool palette.

4. Position the cursor in the top margin where you would like the page number to appear, and click to create a boilerplate object.

5. In the new boilerplate object, type Page &F_PAGENO of &F_TOTAL_PAGENO.

   Figure 19-7 Page number source and reference fields in top margin of report

   
   Description of "Figure 19-7 Page number source and reference fields in top margin of report"
   
   

   In the report output, the current page number will appear where you reference the field F_PAGENO, while the total number of pages for each master will appear where you reference the field F_TOTAL_PAGENO. If you wish, you can resize the page number boilerplate text object to lengthen it to ensure that no values for F_TOTAL_PAGENO get truncated.

6. Save and run your report. Your final report output should look something like this:

   Figure 19-8 Final pages renumbered by repeating frame report output

   
   Description of "Figure 19-8 Final pages renumbered by repeating frame report output"
   
   

19.8 Summary

Congratulations! You have successfully created a report that renumbers pages by repeating frame. You now know how to:

• create a data model with a group above layout.

• add a second query to create a multiquery report, and redefault the layout.

• set properties and format fields.

• create and reference a page number boilerplate object in your layout.

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".