2020.1

section
The section object can be used to query and modify how the section (and the related context)
will be outputted. It is one of the most important objects in Control Scripts (see "Control Scripts"
on page412 and "Control Script API" on page871).
Retrieving a section
A section can be retrieved using merge.template.contexts.ContextType.sections["section
name"], for example: merge.template.contexts.PRINT.sections["Section EN"].
A section can also be retrieved via merge.context.sections['section name']. Remember,
however, that when several contexts need to be merged (for example, when the Print context is
attached to an email), the script needs to check if the current context is of the type that contains
the desired section (for example: if (merge.context.type == ContextType.PRINT) {}). When
sections in different contexts have the same name, it is safer to use
merge.template.contexts.ContextType.sections["section name"].
Fields
Field Type Description
"background" on
page889
Background Print sections only. Used to set a PDF
background on a Print section. See "Control
Script: Setting a Print section's background"
on page420 and "BackgroundResource" on
page900.
enabled Boolean Enables or disables this section for output
(see "Examples" on page919). Note that
even if a Print section is disabled, the part
and restartPageNumber fields are still
effective to define the parts division and page
numbering over multiple sections when
applicable.
The default enabled state for sections (before
any control script runs) is as follows:
Page 915