2022.2

6. Addasmanydatafieldsasyouneed,followingthesameprocedure.
7. Optionally,youcanclickOptionsatthebottomtospecifyhowtheresultisinserted:
l
AsHTML.HTMLelementsintheresultareprocessedanddisplayedasHTMLelements.
Forinstance,<b>this is bold</b>willbedisplayedasthis is bold.Thisisthe
defaultsetting.
l
Astext.Thisinsertstheresultas-is,meaningHTMLtagsandelementsaredisplayedas
textintheoutput.Inthisscenario,"<br>"showsupinthetextanddoesnotinsertaline
break.ThisisthepreferredsettingiftheHelperproducesplaintext.Itwillbeslightlyfaster
thanHTMLsinceitavoidsprocessingwithanHTMLparser.
8. ClosetheWizard.ThenewHelperappearsontheScriptspaneunderControlScripts.
9. Nowallyouhavetodoisdrag the HelperfromtheScriptspaneintothetemplate.Alternatively
youcanwritethenameoftheHelperenclosedindoublecurlybrackets:e.g.{{MyHelper}}.Do
thisanywherewhereyouwanttheresulttobeinserted.
Tip: Whenoneoftheincludeddatafieldsisempty,therespectiveline,includingtheprefix
andsuffix,isskipped.Theresultwillbeshorter,causingtherestofthecontenttomoveup.
If,inaPrintcontext,youdon'twanttheresultofaHelpertobepartofthetextflow(for
example,whenaletterisgoingtobesentinanenvelopewithawindow),puttheexpres-
sionthatcallstheHelperinapositionedbox(see"Boxes"onpage623and"Howtopos-
itionelements"onpage686).
Variable data in text: scripts and placeholders
OLConnectversionspriorto2022.2usedtoinsertvariabledatainatemplateviascripts and place-
holdersinsteadofexpressions.Expressionslooklikethis:{{FieldName}}.Anexpressionworkswithout
ascript.Theadvantageofexpressionsisthatfewerscriptsandsometimesnoscriptsatallareneeded
inatemplate.
Placeholderslooklikethis:@FieldName@.Ifyourtemplatewasmadewithapreviousversion,youwill
normallyseeaplaceholder-andascript-appearwhenyoudragafieldfromtheDataModelintoyour
template.
Doyouprefertoworkwithexpressions?Right-clickthesectionintheResourcespane,selectProp-
ertiesandchecktheoptionEvaluate Handlebars expressions.Forfurtherinstructionssee"Variable
dataintext:expressions"onpage722.
However,ifyouwanttogetfamiliarwithscriptinginOLConnect,insertingvariabledataplaceholders
maybeagoodstartingpoint.Thiswillgiveyouanunderstandingofhowplaceholdersandscriptswork.
Page 726