2022.2

Thefollowingscripttargetsthetable,andhasitsscopesetto"Resultset".Thisscriptloopsoverthe
detailtableintherecord,evaluatingthefieldShipped.Ifthevalueofthatfieldis1,itlooksupthecor-
respondingrowintheresults(theselectedDynamicTable).
Selector:#table_1tbody
Scope:Resultset
for(var i = 0; i < record.tables.detail.length; i++){
if(record.tables.detail[i].fields['Shipped'] == 1)
query("tr:nth-child(" + (i+1) + ")", results).css('color','green');
}
Control Scripts
Whenoutputisgeneratedfromatemplate,ControlScriptsrunbeforeallotherscripts,whenarecordis
mergedwithacontext.Theydeterminehowdifferentsectionsofthecontextarehandled.Theycan,for
example,makethepagenumberingcontinueoverallPrintsections,splitEmailattachments,oromit
Printsectionsfromtheoutput.
SomefunctionalityisprovidedasaScriptingWizard,forexampleConditionalPrintSections.
ThistopicexplainshowtoaddaControlScriptanditgivesanoverviewofwhatControlScriptscando.
Itwillalsotellyouwhereyouwillfindinformationabouteachfeature,includingexamples.
Thebasicsofscript-writingintheDesignerareexplainedinthefollowingtopic:"Writingyourown
scripts"onpage808.
WhatControlScriptsare
ControlScriptsareaspecialkindofDesignerscript.Theycanmanipulatethewayoutputisgenerated
fromatemplate.Theyallowyou,forexample,tochangethepagenumberinginPrintoutput,tosplit
onegeneratedPrintdocumentintomultipleEmailattachments,ortosetaPrintsection'sbackground
dynamically.(Theseareonlyafewexamples;formoreusesofControlScriptssee"WhattouseaCon-
trolScriptfor"onthenextpage.)
ControlScriptsdifferfromStandardscriptsintwoways:
l
ControlScriptsrunbeforeallotherscripts.Whenatemplateconsistsofseveralcontexts,and
thesecontextsarecombinedintheoutput-forexample,whenanEmailisgeneratedwiththe
Printcontextasattachment-allscriptsrunonceforeachcontext,butControlScriptsalwaysgo
first.
l
ControlScriptsdo not touch the content-meaning,thetextflow-ofthesections.
Theydon'thaveaselector,liketheotherscriptsdo.Aselectorselectspartsofthecontentofa
sectionandstoresthemintheresultsobject,sothattheycanbemodifiedinthescript.AsCon-
trolScriptsdon'thaveaselector,theresultsobjectcan'tbeusedthere.
Page 838