Report Structure

Description

A Report is divided into several sections with headers and footers. These sections are the Report, Detail, and Groups sections.

The Report Structure

Alpha Anywhere Reports are divided into sections, of which there are three types:

Report section

prints at the beginning and end of the report. The Report section acts as a wrapper for the rest of the Report.

Detail section

prints individual records, and repeats until all records have been printed.

Grouping levels

groups related records together. Grouping levels are sections that you create. They repeat for each group of records.

images/Report_Structure.gif

Within each of these sections, you can have multiple header and footer layout edit regions. Edit regions are where the fields, text, and other objects are placed. The edit regions you use in your Report vary depending on your needs.

Before jumping in and creating a report, it is helpful to first become familiar with the Report Editor. The Report Editor shows the division between sections and edit regions by using dark gray section-title bars and light gray edit region-title bars.

On each of these bars is an outline button which allows you to show or hide edit regions. Clicking the button when it displays the minus symbol (-) hides the edit regions, while clicking the outline button while it displays the plus symbol (+) shows the edit regions. Clicking an outline button on a particular edit region-title bar shows or hides that edit region. Clicking an outline button on a particular section-title bar shows or hides all of the edit regions contained in that section.

These buttons only affect what displays in the Report Editor, they do affect the appearance of the report when it is printed or previewed. You can also display and hide report components by choosing View > Sections, View > Titles, or View > Regions. as you work with the editor, you will find these options helpful in reducing the amount of clutter you see on the screen.

images/Report_Sections.gif

Report Layout Regions

The following sections describe where and when report layout regions appear. A spillover page occurs when the detail section of a group begins on one page and ends on another.

Report Header

Contains the report title, corporate logo, and background information. It is located at the beginning of the report. There is one Report Header per report.

Page Header

Contains the report title and is located at the top of a page. The Page Header is repeated on each page.

Group Header

Contains the field on which the detail records are grouped and detail fields column headings. The Group Header is located at the beginning of each data group and is repeated for each data group. The Report Header, however, is not repeated at the top of spillover pages.

Detail Header

The Detail Header contains field column headings. It is located at the beginning of a detail region. If there are no groups, the Detail Header is only printed once per detail region.

Detail

A Detail contains Field Data. It is a row of data generated for each record.

Detail Footer

Graphics that separate the detail section from the following group (if any). The Detail Footer is located at the end of the detail region. It is printed once per detail region for the report.

Group Footer

The Group Footer is where you can add summary calculations for the group. It is located at the end of each data group and is repeated one time per data group in the report but not at the bottom of spillover pages.

Page Footer

The Page Footer is where you can add a page number, date, or other information you would like printed at the bottom of every page in the report.

Report Footer

The Report Footer can contain summary calculations for the total report. It is located at the bottom of the page, but above the page footer and is generated one time per report.

The Report Section

The Report section is the outermost section of a report. It can have a Report Header and/or Report Footer edit region. The Report Header is the first region to print; the Report Footer is the last. The Report Header typically contains general information about the report, such as its title; the Report Footer contains summary information for the report, such as totals:

images/Report_Header_and_Detail_sections.gif

To insert or remove the Report Header or the Report Footer, select Report > Report Properties. The Report Properties dialog box appears. Choose the Header/Footer tab and check or deselect the Has Report Header and Has Report Footer check boxes.

Another way to insert or remove the Report Header and Report Footer edit regions is by right clicking on the Report section-title bar, and choosing the appropriate edit region from the right-click menu.

The other choices, including Has Page Header, Has Continuation Header, refer to special headers and footers you can create. Information about these special headers and footers can be found in Special Headers and Footers.

The Detail Section

When you run a report, each edit region prints sequentially from top to bottom until the Detail region is reached. The fields and objects placed in the Detail region then print repeatedly for each record in the report, until the report either runs out of records, or a group break occurs (explained in the section Grouping Related Records later in this chapter). After all the records are printed, all of the edit regions below the Detail region are printed sequentially:

images/Report_Detail_Processing.gif

Along with the Detail region, the Detail section can also contain a Detail Header and a Detail Footer. These edit regions appear before and after the Detail region. Typically, the Detail Header is used to display column titles for fields listed in the Detail region, and the Detail Footer is used to print summary information about the Detail region data. On any page that records from the Detail edit region print, the Detail Header and Detail Footer edit regions appear (provided you have created them).

Expanding the Detail Section

You may expand the Detail section vertically to place multiple fields above or below each other. In the first picture, note how the cursor changes to a double-headed arrow when it is above a boundary that can be moved.

images/Detail_Section_Before.gif

In this second picture, note how the designer stretched down the Detail section and place the new Phone field below the Lastname field.

images/Detail_Section_After.gif

Edit Regions

Fields, text, and other objects are placed in the edit regions of the report in the same way as they are placed on forms.When placing fields and objects into an edit region, often it is helpful to adjust the edit region's size. This can be done using the mouse. Move the mouse to the lower edit region-title bar. When the cursor-shape changes to a double arrow, you can click and drag the edit region up or down to make it smaller or bigger.

images/Report_Resize_Section.gif

To prevent too much space from being wasted when the report prints, make the edit region as small as Possible. Some objects, such as Rich Text Objects, Rich Text Fields, and Memo Fields can automatically expand when they are printed, and frames placed around these objects can automatically expand as well.

Inserting and Removing Edit Regions

To add or remove the Detail Header edit region or the Detail Footer edit region:

  1. Select Report > Detail Properties.

  2. The Detail Properties dialog box appears.

  3. Display the Header/Footer tab.

  4. Check or deselect the Has Header and Has Footer check boxes. The other controls, including Has Header and Records with Header are used to create special headers and footers, and to keep a certain number of records together with each of these edit regions.

You can right click on the Detail-section title-bar to open the Detail Properties dialog box. Also, you can right click the Detail section title-bar and choose the appropriate section from the right-click menu.

You can also remove every edit region in the Detail section including the Detail edit region. This is useful if you are interested in viewing totals or other summary information, but you do not to see the actual records. To remove the Detail edit region:

  1. Select Report > Report Properties.

  2. The Report Properties dialog box appears.

  3. Display the Report tab.

  4. Clear the Has detail section check box. The Detail edit regions disappear, but the Detail section-title bar does not.

Report Properties

The Report Properties control the behavior of spillover data and what sections, headers, and footers are available in the report.

Name
Description
Report Region Properties

Properties relating to the report region.

Report Properties

Report properties, head/foot properties, page properties, printer properties, window properties, and menu and toolbar properties.

Report Group Properties

Group, region, and head and foot properties.

Detail Properties

region, head/foot, and records properties.

See Also