2022.2

Field Type Description
channel
"Channel"on
page1294
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1299
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1314
ContainsthetotalpagecountandsheetcountofallsectionsinthePrintcontextafterpagination.
"section"on
page1305
Section InStandardScripts,thisobjectdefinesthesectionthatisbeingmerged.
Note!InControlScripts,merge.sectionisonlyavailablewhentheoutputchannelisWEB.Tomake
surethatitisdefined,usethefollowingstatement:if (merge.channel == Channel.WEB &&
merge.context.type == ContextType.WEB) { ... }.
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1292
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1299)andtomanipulatethe
sectionsinthosecontexts(see"section"onpage1305).
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845).
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) {
// File does not exist
}
resource(location, pageNumber)
location
ThelocationshouldbeaURLrelativetothetemplaterootoranabsolutefile-basedURL(withoutpro-
tocol),e.g."C:/myfile.pdf".
pageNumber(optional)
Page 1278