2022.1

Tip
You could use the resource() function to check the number of pages or for example
the page height and width before setting it as a background (see "resource()" on
page926).
Example
This scripts sets a background on a Print section using absolute positioning.
var activeSection = merge.template.contexts.PRINT.sections['Section
1'];
activeSection.background.source = BackgroundResource.RESOURCE_PDF;
activeSection.background.url = "images/somepage.pdf";
activeSection.background.position = MediaPosition.ABSOLUTE;
activeSection.background.left = "10mm";
activeSection.background.top = "10mm";
You could replace the last three lines of the previous script by the following line to scale the
Print section background to Media size:
activeSection.background.position = MediaPosition.FIT_TO_MEDIA;
Dynamically adding sections (cloning)
This topic explains how to "clone" (copy) a section in a Control Script. Print sections can be
cloned, so that a document can have a dynamic number of sections, based on data. This is
particularly useful when the record set defines one or more PDFs (e.g. insurance policies) per
recipient. Via a Control Script, for each PDF a section can be cloned and each clone can be
given one of the PDFs as background (see "Control Script: Setting a Print section's
background" on page434). For each page in the PDF, a page will be added to the section.
For information about Control Scripts in general, see "Control Scripts" on page425 and
"Control Script API" on page917. If you don't know how to write scripts, see "Writing your own
scripts" on page389.
Note
Clones are only visible in the output, not on the Preview tab.
Page 436