2022.2

Note: IfaHandlebarstemplateisrenderedwithpartofthecurrentrecord,thetemplatestill
hasaccesstotheentirerecordandcannavigateupandoutsideofthatpart,toahigher
levelinthecurrentrecord.
IfaJavaScriptobjectispassed,thetemplateonlyhasaccesstothepasseddata,andit
doesnothaveaccesstothecurrentrecord.
Formattingvalues
FunctionsthatcanbeusedinaHandlebarsexpressionarecalled"Helpers".OLConnectprovidesa
numberofHelperstoformat the valuethatistheresultofanexpression.Forexample:{{upperCase
FirstName}}returnsthevalueoftheFirstNamedatafieldinuppercase.
Theavailablefunctionsarelistedinthetopic:"FormatHelpers"onpage769.
HTMLvalues
ThevaluereturnedbyanexpressionisHTML-escaped.Thismeansthatcharactersthathaveaspecial
functioninHTML:& < > \" ' ` =arereplacedwithHTMLcharacterreferences.Forexample:&willbe
changedinto&amp;.
Takethisexpression:<span>{{foo}}</span>.
Ifthefieldfoocontainsa'>'andyoudon'tHTML-escapeit,thiswouldproduceinvalidHTML:
<span>...>...</span>.
AfterHTML-escaping,itbecomesvalidHTML:<span>&gt;</span>.
IftheresultofanexpressionshouldnotbeHTML-escaped,theexpressionmustbeenclosedinthree
curlybrackets:{{{...}}}.CharacterswithaspecialfunctioninHTMLwillthenbeinterpretedasHTML.
Forexample,thevalue"<b>Name</b>"willbedisplayedasName.
WhenanHTMLfieldisdraggedintoaHandlebarstemplateitisautomaticallyenclosedinthreecurly
brackets.
Note: Contentprovidedby'blockhelpers'-expressionsintheform{{#helperNameargu-
ments}}...{{/helperName}}-isnotautomaticallyHTML-escaped.See"Usingfunctionsinexpres-
sions:Helpers"onthefacingpage.
Testingexpressions
Totestwhetherexpressionsgivetheexpectedresult,simplyswitchtoPreviewmodeintheWork-
space.YoucouldalsodoaPreflighttotestwithmultiplerecords(see"DoingaPreflight"onpage818).
Logging
ValuescanbeloggedwithanexpressionthatusesthelogHelper.ForexamplesseeHandlebars'doc-
umentation.
Page 765