Breaking a Document into Parts

Tables and crosstabs display the values returned by objects in a single block.

For example, the following simple table displays revenue per resort per quarter in a solid block, repeating the name of the resort for each quarter's revenue.

Simple table without breaks

You can make a document much more readable by breaking it up into parts. To do this, just apply a break to the Detail object you want to trigger the break.

Example Creating a new block for data concerning each resort

For example, if you apply a break to the Resort object in the table above, you get the following result:

This breaks the data for each resort into separate blocks.

See also:

• Applying a break
• Defining break attributes
• Removing a break
• Creating sections within a document
• Creating a document with sections, subsections and blocks

Return to topic: Formatting Documents

Applying a Break

To apply a break, drag the Break button from the Web Panel toolbar to the object you want to apply the break to.

Note: You cannot apply a break to an object in the Section panel.

A Break icon now appears attached to the object in the Block panel.

If you apply more than one break in a document, each Break icon in the Block panel displays a number (the first break is number 1, the second 2, and so forth).

By default, a break inserts:

• A header consisting of row or column titles at the beginning of each created table or crosstab block
• A blank row or column at the end of each table or crosstab

If you want the break to behave differently, see Defining break attributes.

Return to topic: Breaking a Document into Parts

Return to topic: Formatting Documents

Defining Break Attributes

Once you've inserted a break, you can define a variety of settings for it. For some settings, the result differs depending on whether you're formatting a table or crosstab document.

• Break Header inserts row and/or column headers for each table or crosstab block created by the break. It is checked by default. If only this attribute is checked the result looks like this:

Break Header option's action on table

Break Header option's action on crosstab

• Break Footer inserts a blank row or column at the end of each table or crosstab block created by the break. It is checked by default. If only this attribute is checked, the result looks like this:

Break Footer option's action on table blocks

Break Footer option's action on crosstab blocks

• Remove Duplicates removes all duplicate values from the data you apply the break to, so that each value is only shown once. This attribute is checked by default.
• If the table or crosstab extends over more than one page, check Header on New Page if you want the break header to be repeated on each new page.

How you define a break's attributes differs depending on the type of Web Panel you're using:

• Defining break attributes in the Java Web Panel
• Defining break attributes in the ActiveX Web Panel

Defining break attributes in the Java Web Panel

1. Double-click the Break icon attached to the object in the Section/Block panel. The Break Options dialog opens.

   

2. Check the option(s) you want to apply to the break, then click OK.

Defining break attributes in the ActiveX Web Panel

1. Right-click the Break icon attached to the object. A contextual menu opens.
2. Choose Break. A menu of Break options opens.
3. Check the option(s) you want to apply to the break, then click OK.

Return to topic: Breaking a Document into Parts

Return to topic: Formatting Documents

Removing a Break

To remove a break:

• If you're using the Java Web Panel, select the Break icon attached to the object and press the Del key on your keyboard.
• If you're using the ActiveX Web Panel, right-click the Break icon attached to the object.
  Choose Break from the contextual menu. A menu of Break options opens.
  Choose None.
• In either Web Panel, drag the break out of the Section/Block panel.

Return to topic: Breaking a Document into Parts

Return to topic: Formatting Documents