Customizing Print Settings for a Widget

You can print most kinds of widgets. To customize how the system prints a widget, access the Dashboard Editor, select the widget as described in Reconfiguring a Widget, and click Print Setup and then click Page Setup. You can modify the following options:

Reset — Click this to restore the default print settings for this widget.
Page Size — Specify the size of the pages. Choose a page size.
Units — (Read only) This field displays the units associated with the page size you selected.
Orientation — Specify the orientation of the pages.
Title — Specify an optional title to include in the PDF. See the first subsection for special options.
Subtitle — Specify an optional subtitle to include in the PDF. See the first subsection for special options.
Show Subtitle — Click On to include the subtitle in the PDF. Or click Off not to include the subtitle.
Listing Settings — Select this to access additional options that apply when the output is a detail listing. Then specify options as described in the subsection Listing Settings.
Filter Settings — Select this to access options that control the appearance of information about any filters applied to this pivot table. Then specify options as described in the first subsection.
Show Date — Click On to include the current date in the PDF, at the top of the first page. Or click Off to omit this information.
Show User — Click On to include the current user in the PDF, at the top of the first page. Or click Off to omit this information.
Page Margins options: Top, Bottom, Left, and Right — Specify the size of the top, bottom, left, and right margins, respectively.

Note that the Title, Subtitle, and Show Date options apply to Excel Export as well.

Requirements for Printing

When a user invokes the Print option, InterSystems IRIS uses Java to call out to a third-party PDF rendering tool. This means that Java (or specifically JRE, Java Runtime Environment) is required on the server accessed by the user’s local machine. For information on the requirements, see Configuring InterSystems IRIS for PDF Output.

Special Options for the Title and Subtitle

Within the Title and Subtitle fields, you can include a combination of static text and the following tokens:

{@filter.filterName} where filterName is the name of a filter defined for the given widget. Use the same name as provided in the Filter dropdown menu in the Dashboard Designer.
In the PDF, this token is replaced with the current value of that filter.
{@date.dateFormat} where dateFormat is an integer date format, with the same meaning as the dformat argument of $ZDATETIME.
In the PDF, this token is replaced with the date in the given format, followed by the time in 24–hour format.
{@variable.variableName} where variableName is the name of a runtime variable.
In the PDF, this token is replaced with the current value of that variable.

Listing Settings

For Listing Settings, specify some or all of the following options, which take effect when the output is a detail listing:

Show Listing Filters — Click On to include information on the context used for the detail listing (that is, which member or members were selected before the listing was requested, as well as any filters that were in use). Or click Off to omit this information.
Show Zebra Stripes — Click On to use different colors for alternating rows. Or click Off to use the same color for all rows.
Font Size — Specify the font size, including units, for example: 6pt

Filter Settings

For Filter Settings, specify some or all of the following options, which control the presentation of the filter information:

Show Filters — Specify the presentation of the filter information. Select By Table (to display this information as a table on the top of the first page), By Title (to display this information as the subtitle or appended to the subtitle), or Off (to not display this information).
By default, the filter information is appended to the subtitle area to the right of any specified subtitle.
When you display filter information as a table, the table has two columns with level names (that is, the filter names) on the left and member names (that is, filter item names) on the right.
Table Style — Specify options to control the appearance of the table that is used to display the filter information.
These options affect both the caption column (the left column) and the item column (the right column).
Row Header Style — Specify options to control the appearance of the row headers. These options override the Table Style options.
Item Style — Specify options to control the appearance of the item column. These options override the Table Style options.
Display Format for NOW — Specify how to display the NOW member of any time level, if that member is used in the filter and if the filter information is shown. Specify any of the dformat options of the $ZDATE function. For example, specify 3 for ODBC format (for example, 2015-03-27).
If you leave this option blank, the PDF shows the NOW member as NOW.

Adding Widget Properties