Section Level Events

This table describes the events that are available at the section level:

Event

Description

Advance Section

Occurs each time you perform a fetch from the database. Use this event if you need to perform processing on objects before the fetch. If the section does not have a business view attached, then this event is processed only once.

After Last Object Printed

Occurs after a record is printed to an output file. Use this event to process information after a record has been output.

Before Level Break

Occurs before a level break is processed. Use this event to perform processing after a fetch but before any level breaks are checked.

Do Balance Auditor

Valid only for tabular sections. Use this event for the Drill Down feature.

Do Section

Occurs following an Advance Section event, after values have been assigned to print to a printer or an output file. Occurs before any information for the current record is written to the PDF and before the Do Cell (if tabular cells exist), Do Variable, or Do Constant events. In a tabular section, this event processes after the level break.

Do Tabular Break

Valid only for tabular sections. Occurs when the value changes for a business view field defined as a level break. Use this event to perform processing that requires a change of values in any of the level break fields.

End Break Section

Occurs after a level break finishes processing. Use this event to perform processing immediately after a level break.

End Lvl Brk Footer Section

Occurs after a level break footer. Use this event to do processing immediately after a level break footer.

End Lvl Brk Header Section

Occurs after a level break header. Use this event to do processing immediately after a level break header.

End Section

Occurs after a batch process has completed processing the last set of section values. Use this event to do processing immediately after a section ends. This event is useful for last record and end-of-file procedures.

Init Break Section

Occurs after a level break begins processing. This event initializes a child section that is joined to the parent section on a level break.

Init Lvl Brk Footer Section

Occurs before a level break footer. Use this event to do processing immediately before a level break footer.

Init Lvl Brk Header Section

Occurs before a level break header. Use this event to do processing immediately before a level break header.

Initialize Section

Occurs when a batch process encounters a section for the first time. Use this event to do processing immediately before a section begins. This event is useful for working with global variables or performing other preparatory procedures. For conditional sections, this event is processed each time the section is called. For subsection joins, this event is only processed the first time the child section is processed.

Refresh Section

Occurs subsequent to all but the first time a child section is processed. The first time the batch engine encounters a child section, it issues an initialize section event. Each subsequent time the child section is processed, the batch process uses Refresh Section. At this point, the internal structures and pointers for the child section are established and the batch engine prepares to select a new group of records for the child section. This logic also works for the level break sections. Use this event to set the object values of level-two sections based on the parent section. You can also use this event to reset or modify data selection and data sequencing for the child section.

Suspend Section

Occurs when information exceeds the space available on a page. This event temporarily stops the section processing. Use this event to do processing when a page break occurs.