2022.2

merge
InControlScripts,therootlevelinstanceoftheobjectmergeistheentrypointfromwhereyoucan
queryandchangethewaycontextsaremerged.Itgivesaccesstothetemplatewithallitscontextsand
sections.
FormoreinformationaboutControlScripts,see"ControlScripts"onpage398and"ControlScriptAPI"
onpage815.
SomeoftheobjectsarealsousefulinPostPaginationScripts;see"PostPaginationScripts"on
page410and"PostPaginationScriptAPI"onpage840.
Forsamplescripts,followthelinkstotherespectiveobjects.
Field Type Description
channel
"Channel"on
page837
Thefinaloutputchannel:EMAIL,PRINTorWEB.Thechanneldoesn'tchangewhentheoutputconsistsofdif-
ferentcontexts.Whengeneratinganemail,forexample,thechannelisEMAIL,evenwhenmergingthePrint
contexttoattachittotheemail.
"context"on
page842
Context Thecontextrenderedbythismergerun.Ifforonerecord,differentcontextsneedtobeoutput(forexample,
whenthePrintcontextisattachedtoanemail)arecordismergedmultipletimes:oncepercontext.Per
mergerun,merge.contextshowswithwhichcontexttherecordismerged.
pagination
"Pagination"on
page857
ContainsthetotalpagecountandsheetcountofallsectionsinthePrintcontextafterpagination.
"section"on
page848
Section InStandardScripts,thisobjectdefinesthesectionthatisbeingmerged.
Note!InControlScripts,merge.sectionisnotavailable.
ToretrieveanysectioninaControlScript,use:merge.tem-
plate.contexts.ContextType.Section['Section name'];(forexample:merge.tem-
plate.contexts.PRINT.sections["Section EN"]).
InPostPaginationScripts,onlyPrintsectionsareavailable.
"template"on
page835
Template Thisobjectcontainsthetemplateandallofitscontexts.Itcanbeusedtofindoutwhichcontextsareavailable
inthetemplate,usingmerge.template.contexts(see"context"onpage842)andtomanipulatethesec-
tionsinthosecontexts(see"section"onpage848).
resource()
Theresource()functionreturnsinformationaboutanimageresource.Thisfunctionisusefulina
ControlScript,forexampletocheckthenumberofpagesorthepageheightandwidthbeforesettingit
asabackground(see"ControlScript:SettingaPrintsection'sbackground"onpage404).
Thisfunctioncanalsobeusedtocheckifafileexists.Itreturnsnullifthefiledoesnotexist.Thereis
noneedtoexplicitlycheckfornull;achecktoseeifaresourceexistscansimplybewrittenas:
var info = resource(path);
if (!info) {
Page 820