2022.2

l
PostPaginationScriptsrunafterallotherscripts,moreprecisely:afterthecontenthasbeen
paginated.ThepaginationprocessappliespagebreakstothecontentofaPrintsection,adds
MasterPagesandsetstheMedia.APostPaginationScriptmayquerytherendereddocument
andcollectinformationaboutelements(forinstance,onwhichpagetheyresideon)andsections
(forinstance,whethertheyareenabled).Ifneeded,aPostPaginationScriptcanchangethe
sheetconfigurationandre-paginateasection.
l
PostPaginationScriptsonlyapplytothePrintcontext.Theoutputofothercontextsisnotpagin-
ated.
JustlikeStandardScripts,PostPaginationScriptshaveaselector(see:"SelectorsinOLConnect"on
page825).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(see"results"onpage1301).
ThesecondmostimportantobjectinaPostPaginationScript,justlikeinaControlScript,isasection
(see"section"onpage1305).
WhattouseaPostPaginationScriptfor
AfterallPrintsectionshavebeenpaginated,PostPaginationScriptsmaysearchthroughtherendered
documentandcollectinformationaboutelements(forinstance,whichpagetheyresideon)andsec-
tions(forinstance,whethertheyareenabled).Withthisinformation,aPostPaginationScriptcando
twothings:
l
Modify the output.Thescriptmaymodifytheoutputofasection.Itcould,forexample,use
informationlikepagenumberstocreateaTableOfContents(TOC),asexplainedinthetopic:
"CreatingaTableOfContents"onthefacingpage.Ifneeded,aPostPaginationScriptcan
changethesheetconfigurationandre-paginatethesection(see"paginate()"onpage1312.
l
Add information to the Connect database.Thescriptmayaddproductioninformation,such
asthepage,sizeorpositionofelementsafteramerge,ascustompropertiestoaPrintContent
ItemintheConnectdatabase(see"contentitem"onpage1298).Custompropertiescanbeutil-
izedforfurtherprocessinginaWorkflowconfigurationwiththeRetrieveItemstask.TheRetrieve
Itemstaskretrievescustompropertiesalongwiththebaserecordinformation(seeRetrieve
ItemsinWorkflow'sOnlineHelp).
AddingaPostPaginationScript
ToaddaPostPaginationScript:
1. OntheScriptspaneatthebottomleft,clicktheblacktriangleontheNewbuttonandclickPost
Pagination Script.ThenewscriptappearsinthePostPaginationfolder.
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.
Page 851