2022.2

Bysettingthescopeofascriptyoucandeterminewhetheryouwanttorunthescriptonce,oronce for
each elementthatmatchestheselector.(See"Settingthescopeofascript"onpage813.)
Ifascriptrunsonce,accessingthedetaildataanddynamicallyaddedrowstendstobeabitcom-
plicated,especiallywhentheyarenested,sinceitinvolvesloopingovertheresultsandrecordobjects
(see"results"onpage1301and"record"onpage1199).
Ifascripttargets(somethingin)arowthatisboundtoadetailtable,andrunsonce for each matched
element,thecurrentelementisaccessibleviathethisobject(see"this"onpage1237)andthecurrent
detailrecordisaccessibleviathis.record.
Theadvantageofthelatterapproachisdemonstratedinanexamplebelow.
Quick-startascriptwiththeCreatescriptbutton
Thisquick-startprocedureonlyworksforelements(acellorspan)thathaveadirectlinkwithadata
field.
Tofindoutwhetheracellorspanhasadirectlinktoadatafield,selectit(see"Selectinganelement"
onpage570)and:
l
TakealookontheAttributespane.IfunderOther,theFielddrop-downorSumfieldpointtoa
datafieldinthedetailtable,theelementhasadirectlinktoadatafield.
l
SwitchtotheSourceview.Elementswithadirectlinktoadatafieldhaveadata-fieldor
data-sumattribute.
Bydefault,cellsthatarefilledwithaplaceholderhaveadirectlinkwithadatafield.Cellsthatarefilled
withanexpressiondon't.Tocreateadirectlinkwithadatafield,selectthecellandchoosethedata
fieldfromtheFielddrop-downontheAttributespane.
Theeasiestwaytoaddascriptthattargetsaspecificelement(acellorspan)thathasadirectlinkwith
adatafieldisthis.
1. InDesignmode,selecttheelement.
2. ClicktheCreate ScriptbuttonnexttotheFielddrop-downontheAttributespane.
3. ClickYestoconfirmthatthedirectlinkwiththedatafieldwillbebroken.
Asaresult:
l
Theelementwillnowhaveadata-scriptattribute.
l
Thedata-fieldordata-formatattributeisremoved.
l
AnewscriptwillbecreatedandopenedintheScriptEditor.
Theselectorofthenewscriptisthedata-scriptattributewiththenameofthedatafieldthattheele-
mentwaslinkedtoasitsvalue.Forexample:table[data-script='ID'].
Page 836