2022.2

Note: WhenBlockHelpersareusedinasection,anychangesthatyoumakeinPreviewmode
arerevertedwhenyouswitchbacktoDesignmode.Inotherwords,editinginPreviewmodeis
notsupported.
UsingtheHelperWizard
Arethereemptyfieldsinthedata?Andisthevalueofadatafieldprecededorfollowedbyaspace,line
breakortextinthetemplate,likeinanaddress block?ThenitisbesttousetheHelperWizard.Other-
wise,emptydatafieldswillcauseemptylinesandsuperfluouswhitespacestoshowupinthetext.
TheHelperWizardcreatesa"Helper"-afunctionthatcanbecalledinanexpression.Whencalled,the
Helperinsertsoneormoredatafieldsintoyourtemplate,eachwithanoptionalprefixandsuffix.
Thewizardalsomakesiteasiertoformatdatadifferently,forexample,displayanumberasacur-
rency.
1. OpentheHandlebarsTextHelperWizard:ontheScriptspaneatthebottomleft,clicktheblack
triangleontheNewbuttonandclickHandlebars Text Helper.
2. ChangethenameoftheHelpertomakeclearwhatitdoes.Thenamemustbeunique.
ThenameoftheHelperiswhatyouuseinanexpression.Forexample,ifitsnameisMyHelper,
thentheexpressionthatcallstheHelperis{{MyHelper}}.
3. ClickthedownwardpointingarrowinthefirstrowinthecolumnField.Selectadatafieldfromthe
listthatappears.
4. AddaPrefixand/oraSuffix.Theprefixandsuffixcancontaintextand/orHTMLtags.Youcan
addlinereturnsandstatictext,suchas:
l
withaNumberfield,Prefix:Your invoice(onespaceattheend),Suffix: is now ready to be
viewed!
l
withafieldLastName,Suffix<br>(whichaddsalinebreak)
l
withafieldState,Prefix:,(commathenspace).
Note: Ifafieldisempty,theprefixandsuffixwillbeignored.
Tip: Foracommabetweenfields,usethePrefixofthesecondfieldifyoudon’twanta
commawhenthesecondfieldhasnovalue.
5. TheWizardallowsyoutoformatthedata(forexample,displayatextinuppercase,applythou-
sandsseparatorstonumbers,etc.).ClickthecolumnFormat,thenclickthedownwardpointing
arrowandselectoneoftheformats.Foranexplanationoftheformatssee"Formattingvariable
data"onpage317.
Page 310