2022.2


o
Aplaceholderforthevalueofthedatafieldshowsupinthetext.Itlooksasfollows:
@FIELDNAME@.

o
AscriptappearsintheScriptspaneatthebottomleft.
Tip: Double-clickthescripttoopentheTextScriptWizardandaddmorefieldstothesame
script.See"UsingtheTextScriptWizard"onthefacingpage.
Thescriptreplacestheplaceholdersinthecontentwiththevalueofadatafieldinthecurrentrecord.
SwitchtothePreviewtabatthebottomoftheworkspacetoseethescriptinoperation.Thevalueofthe
correspondingdatafieldinthefirstrecordappearsinsteadoftheplaceholder,everywherewherethe
placeholderisfoundinthetext.Thisvaluewillberefreshedwhenyoubrowsethroughtherecordsin
theDataModelpane.
Whentheoutput(theletter,email,etc.)isgenerated,thetextscriptexecutesforeachrecordinthe
recordset,andeachtimeitreplacestheplaceholderswiththevalueofthefieldinthecurrentrecord.
IntheScriptspaneyoucanseethatthescripthasanameandaselector.Theselectoriswhata
scriptlooksforinthetemplate.
l
Thedrag-and-dropmethodautomaticallygeneratesascriptthatisnamedafterthedatafield
(seetheScriptspane).
l
Bydefaultthedrag-and-dropmethodwrapstheplaceholdertextinaSpan.(Selecttheplace-
holderandswitchtotheSourcetabtoseetheSpanelement.)TheSpan'sclassisusedas
selector.Notethatanyspacesthatoccurinadatafieldnamewillberemovedfromthescript
selector.
WhenyoudragthesamefieldfromtheDataModeltothecontentagain,asecondplaceholderappears
inthetext,butnonewscriptisadded.Theexistingscriptwillreplaceallplaceholdersthatmatchits
selector.
YoucouldalsodragascriptwithanIDand/orclassselectorfromtheScriptspaneintothetemplateto
insertanadditionalplaceholder.
Tip: DragthedatafielddirectlytotheScriptspanetocreateascriptwithaclassselector,
withoutaddingaplaceholdertothetemplate.HoldingtheAltkeywhiledraggingcreatesascript
withatextselector.
Note: Connectversionsolderthan2020.2usedtheplaceholdertextasthescript'sselector.
Lookingfortextinatextisalessoptimizedoperationandmayimpactoutputspeedsinlonger
documents.ForthatreasonplaceholdersarenowbydefaultwrappedinaSpanandtheclassof
thatSpanisusedasthescript'sselector.
Page 313