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).
template
Thetemplateobjectrepresentsthetemplatewithallitscontextsandsections.Itisusedfrequentlyin
ControlScripts(see"ControlScripts"onpage398and"ControlScriptAPI"onpage815)butitcanalso
beusedinStandardScripts.
Itisretrievedviathemergeobject:merge.template(see"merge"onpage856).
Whichcontextsareavailableinthetemplatecanbequeriedusingmerge.template.contexts.To
getaccesstoaspecificcontext,youhavetospecifytheContextType(see"ContextType"on
page838).
Page 733