2022.2

ControlScriptsdon'ttouchthecontentofthesectionsthemselves,buttheycanchangethewayatem-
plateisoutputted.FormoreinformationaboutControlScriptsandtheiruse,see"ControlScripts"on
page838.
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725)oryoucanwritethemyourself(see"CreatingcustomHelpers"onpage771).
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825).
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-
Page 809