2022.2

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368.
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.
Similarly,thequery()function,whichisusedtoselectcontentfromwithinascript,isunavail-
ableinaControlScript.
AddingaControlScript
ToaddaControlScript:
1. OntheScriptspaneatthebottomleft,clicktheblacktriangleontheNewbuttonandclickCon-
trol Script.Anewscriptappearsinthelist.
2. Double-clickthenewscripttoopenit.Thescripteditorappears.
3. Changethenameofthescriptsothatitreflectswhatthescriptdoes.
Note: Scriptscanonlyhavethesamenamewhentheyarenotinthesamefolder.
4. Writethescript;seethe"ControlScriptAPI"onpage815.Ifyouarenotfamiliarwithscripting,
alsosee"Writingyourownscripts"onpage368.
Page 398