2021.1

Table Of Contents
Tip
Be aware that scripts run in a specific order (see "The script flow: when scripts run" on
page887). When one script unintentionally influences the results of another script,
changing the order of the scripts in the Scripts pane may help (see "Changing the order of
execution" on page874).
Note
An image with an unknown file extension is represented by a red cross in the output, but
no error is logged unless the image refers to a local file that does not exist on disk.
Image file extensions that the software recognizes are: AFP, BMP, EPS, GIF, JPG/JPEG,
PCL, PDF, PNG, PS, SVG, and TIF/TIFF.
Using the Script Debugger
The Designer's Script Debugger allows you to set breakpoints in scripts and step through them.
It simulates an output run with only the current record and shows an overview of the state of all
local and global variables, while the Workspace displays the partially merged document.
There are two ways to start the Script Debugger:
l Click the Debug Scripts button in the toolbar of the Scripts pane. The Script Debugger
will pause and accept input as soon as it processes the first script.
l Right-click an enabled script in the Scripts panel and choose Debug from the contextual
menu. The Script Debugger will pause and accept input as soon as it processes the
selected script.
If the selected script is never processed, a message will pop up. This can happen when:
l The selector has no matches at any time. (This may depend on other scripts, since scripts
can add or remove content.)
l The script is excluded through the properties of its parent folder.
For an explanation of the buttons in the Script Debugger, see "Script Debugger" on page989.
Page 880