2022.2

4. TheDynamicSectionBackgroundScriptWizardcomposesthefilenames(includingthepath)
basedontheselectedlocation,theprefix,thevalueofadata field,andthesuffix.Thevariable
partofthefilenamesisthevalueofthedatafield(s)intheFieldcolumn.Theprefixandsuffixare
meanttocontainstaticpartsofthefilenames.
ClickthefirstfieldinthecolumnField,andthenclickthedownwardpointingarrow.Selectthe
datafieldtobeevaluated.
Ifyouwantthefilenametobecomposedofthevalueofseveraldatafields,simplyclickinthe
nextroworclicktheAddbutton.Thisaddsarow.Notethattherowswillbeconcatenatedtocom-
poseonefilename.Onlythelastsuffixshouldcontainthefileextension(.pdf).
5. ClickApplyorOK.
Thescriptassignstheresultingfilename,includingthepathandfileextension,totheURLofthe
section'sbackground.
6. NowclickthePreviewtabandbrowsethroughtherecordstoverifythatthescriptworksas
expected.
Ifyouwanttoseetheunderlyingscript,reopenthescriptandclicktheExpandbutton.Formoreinform-
ationonthistypeofscript,see"ControlScript:SettingaPrintsection'sbackground"onpage404).
Handlebars in OL Connect
HandlebarsisthenameofaJavaScriptlibrarythatimplementsatemplatinglanguage(see
https://handlebarsjs.com/).Itusesatemplateandaninputobjecttogenerateoutput.
ThetemplatelookslikeregulartextwithembeddedHandlebarsexpressions.Ahandlebarsexpression
issomecontentsenclosedbydoublecurlybraces:{{...}}.Forexample:
<p>Hello {{firstname}}!</p>
Whenthetemplateisrendered,theseexpressionsarereplacedwithvaluesfromaninputobject.
TheHandlebarslibraryisintegratedinOLConnectDesigner.ThismeansthatyoucanuseHandle-
barsexpressionsinallsections(asofversion2022.2),aswellasinaspecialtypeofsnippetscalled
"Handlebarstemplates"(asofversion2022.1).
l
Expressionsinsectionsareresolvedusingthecurrent recordwithwhichatemplateismerged.
Inotherwords,theinputobjectisthecurrentrecord.
l
ExpressionsinaDynamic Tableareresolvedusingthedetail recordassociatedwiththe
closesttablerow.(Nestedtablesaresupported,soasingledynamictablecanusemultipledetail
tables.)
l
InthecaseofHandlebars templates(snippets),youdetermineinascriptwithwhichdatathe
snippetwillbemerged.See"Handlebarstemplates"onpage339forinstructions.
Page 327