The New Parameters of SECTION

1. Problem

The PrintBOS engine executes scripts:

• For InputFields while reading data from the JOB.
• For OutputFields while calculating section objects.

Thus, scripts have no way to get the real coordinates of OutputFields.

2. Solution

It is necessary to provide the ability to assign and execute scripts for SECTION(s):

• Run script(s) after each iteration of the DATA subsection.
• Run script(s) after each iteration of the entire section.

3. Implementation

3.1 Designer

The Designer must provide the ability to assign a script and define its execution type for a SECTION object (Templates & Subtemplates).

The following new parameters are introduced:

• "Script" – item for the "script selection" dialog popup.
• "Run Script Type" – combobox with execution options:
  • After whole section (default) – value 0
  • After each iteration of DATA – value 1

3.2 Engine

The PrintBOS engine must handle SECTION script execution based on the defined parameters.

4. Configuration Example

When saving a template or subtemplate, these parameters are stored as follows:

[Block 5]
…….
Name=Footer
………………..
Script=_SetFooterIfWeb
RunScript=0
………………….

5. Summary

• The new SECTION parameters allow better script execution control.
• Scripts can now run after each DATA iteration or after the entire section.
• This update resolves the issue of retrieving real coordinates for OutputFields.