2022.2

Tip: Doyoufindyourselfcopy-pastingthesamefunctionintoeverynewscript?Youcanavoid
thisbydefiningyourfunctioninaControlScript.ControlScriptsareexecutedfirst,sothefunction
willthenbeavailableinallStandardScriptsandPostPaginationScripts.
Handlebars Helpers
AHandlebarsHelper-afunctionthatcanbeusedinexpressions-isalsodefinedinaControlScript.
HelperscanbemadewiththeHandlebarsTextHelperwizard(see"UsingtheHelperWizard"on
page310)oryoucanwritethemyourself(see"CreatingcustomHelpers"onpage336).
StandardScripts
StandardScriptscanchangethecontentsofsectionsinatemplate.Thistypeofscriptmusthavea
selector.Theselectorcanbetext,anHTMLelementand/oraCSSselector(see"SelectorsinOLCon-
nect"onpage385).
RunningaStandardScriptstartswithlookingforpiecesofcontentinthetemplatethatmatchthe
script'sselector.
Theresultsofthisquerycanvaryfromoneoccurrenceofasimpletext(forexample:@EMAIL@)toa
largecollectionofHTMLelements.Forexample,whentheselectorisp,theHTMLtagforaparagraph,
allparagraphswillbecollectedandpassedtothescript.
Tip: HoveroverthenameofascriptintheScriptspanetohighlightpartsofthetemplatethatare
affectedbythescript.
Next,thescriptcanmodifytheselectedpiecesofcontent,usingvaluesfromtherecordthatismerged
withthetemplateatthetimethescriptruns.Itcan,forexample,hide,replaceoraddtextorchangethe
styleofthosepiecesofcontent.Thisishowscriptspersonalizedocuments.
Tip: Contentaddedbyascriptisn'tvisibleinDesignmode,butisvisibleandcanbeinspectedin
Previewmode.
Note: InaPrintcontext,thescriptsintheScriptspanerunonceforeachsectionandthenonce
foreachMasterPage(seeMasterPages).
Note: Thecontextforuserscriptsdoesnotresetacrossrecords.Thismeansthatifascriptuses
avariablethatisnotdeclaredorinitializedinthatscript,thevariableretainsitsvaluefromthepre-
viousrecord.Thisisbydesign.Itallowsyou,forexample,tomaintainarunningtotalacrossall
recordsofajob.
Page 369