Export results to PDF

Overview

The Export > PDF Format option produces a professionally formatted PDF export, including all report charts and data tables. PDF exports can optionally include custom corporate letterhead or logos, as well as various other options that are described in the following sections.

Projects, users, and issue keys are automatically linked back to the corresponding object in your Jira instance.

The Export menu within a report permits the export of a single report at a time. An example PDF export is shown below:

To export multiple Dataplane reports into a single PDF file, arrange the desired reports as Dataplane gadgets on a Jira dashboard, and then follow the instructions in Export Jira dashboards to PDF.

PDF exports can be customized in several ways by the system administrator and users who have Customizer Script permission.

Global default settings

When exporting reports in PDF format, the following default settings are used for the size, orientation, and layout of the PDF file. Where noted, a Jira administrator can customize some settings globally.

Property	Default	Description

Property	Default	Description
page size	letter or A4	The default page size for report exports is user-specific, based on the user's Jira user profile language/region setting. If a user's language/region is the US, Canada, or Mexico, the default page size is "letter" (8.5 inches x 11 inches). For all other user language/region settings, the default page size is "A4" (210 mm x 297 mm). This default can be modified on a report-by-report basis /wiki/susing Daaplane aces/dataplaneDr aft/pages/442729698.
page orientation	portrait	Dataplane defaults to vertically-oriented (portrait) pages for PDF exports. This default can be modified on a report-by-report basis /wiki/susing Daaplane aces/dataplaneDr aft/pages/442729698.
background image (letterhead or logo)	none	By default, Dataplane does not add a background image, logo, or letterhead to PDF exports. To add a custom, global background image to all exported Dataplane reports, place an image file named exactly `defaultBackground.png` in the following location on the Jira server: <JIRA_DATA>/dataplane/export/defaultBackground.png (where `<JIRA_DATA>` is the path to your Jira data directory, not your Jira application install directory) If this file is present, it will be used as a background image on all exported Dataplane reports. No restart of Jira or reinstallation of Dataplane is necessary. Report-specific background images can be defined /wiki/spacusing Daaplane s/dataplane Draft/pages/442729698.
stylesheets	<none>	By default, Dataplane uses its own, built-in cascading style sheet (CSS) for formatting exported PDF reports. To add a custom, global style sheet to all exported Dataplane reports, place a CSS file named exactly `default.css` in the following location on the Jira server: `<JIRA_DATA>/dataplane/export/default.css` (where `<JIRA_DATA>` is the path to your Jira data directory, not your Jira app install directory) If this file is present, it will be included as a style sheet on all exported Dataplane reports. No restart of Jira or reinstallation of Dataplane is necessary. Additional report-specific stylesheets can be defined using Dataplan/wiki/s aces/dataplaneDr aft/pages/442729698.

Customizing individual reports

Using a customizer script

With Dataplane Customizer Scripts, you can customize the size, orientation, layout, and other attributes of an individual report's PDF export.

If you are not yet familiar with using Dataplane Customizer Scripts in your reports, first see Customize reports with scripts for background information.

The following Customizer Script syntax is used to modify the properties of a report's PDF export:

customizeExport {
	format "pdf" [properties...]
}

The format"pdf" indicates that you are customizing the PDF export format, and it is followed by one or more pairs of properties and values.

For example, to create a wide-format landscape page for a multi-column Issues work log table report, you could use the following:

customizeExport {
	format "pdf" size "ledger" orientation "landscape" backgroundImage "ourLogo.png"
}

You can also place each PDF export customization on a separate line, as in the following:

customizeExport {
	format "pdf" size "ledger"
    format "pdf" orientation "landscape"
    format "pdf" backgroundImage "ourLogo.png"
}

Customizer script options

Using a Dataplane Customizer Script, the following properties and values can be used to customize PDF exports:

Property	Values	Description

Property	Values	Description
`size`	`"letter"` `"legal"` `"ledger"` `"A3"` `"A4"` `"A5"` `"B4"` `"B5"`	Specifies the output page size for the PDF file.
`orientation`	`"portrait"` `"landscape"`	Selects whether the longest edge of the page is on the vertical ("portrait") or horizontal ("landscape").
`backgroundImage`	`"<filename>"`	To add a logo or letterhead to your report, you can specify an image file (in format .png or .jpg) to use as a background for the exported report. This file must be placed in the following directory on your Jira server by your Jira administrator: `<JIRA_DATA>/dataplane/export/<filename>` (where `<JIRA_DATA>` is the path to your Jira data directory) Only a simple filename can be used. Any paths are ignored. For details on the required format of the background image, see /wiki/sAdding Backgracs/daaplanDund Imagsft/pages/442729698.
`stylesheet` `stylesheets`	`"<filename>"` `("<filename1>", "<filename2>", ...)`	To provide custom styling for the exported report text, layout, header, or footer, specify one or more cascading style sheets (CSS) to be used. The stylesheets must be placed in the following directory on your Jira server: `<JIRA_DATA>/dataplane/export/<filename>` (where <`JIRA_DATA>` is the path to your Jira data directory) Only simple filenames can be used. Any paths will be ignored. To add a single style sheet, simply enclose the filename in quotation marks. For multiple stylesheets, add parentheses around a comma-separated list of quoted style sheet filenames. For example: `// Add one stylesheet stylesheet "sheet1.css" // Add multiple stylesheets stylesheets ("sheet1.css", "sheet2.css")` Only one style sheet or stylesheets keyword can be used per Customizer Script. Any additional style sheet(s) keywords will replace all previously-listed stylesheets. For more information on style sheet rules and options, see /wiki/spacs/dataCustlaneDmizaaftion /pages and Tips/442729698.

Customization guidelines and tips

Using stylesheets

Dataplane uses the Flying Saucer HTML-to-PDF engine to render PDF report exports.

The format of PDF exports can be customized by adding one or more cascading style sheets (CSS), which can be specified at a global l/wiki/spaces/davplaneDraf/page/442729698 or on a r/wiki/space/daaplan-by-Dreoraft basi/pages/442729698. For custom stylesheets, Dataplane supports most standard CSS 2.1 attributes, including paged media selectors.

See the Flying Saucer User's Guide for details on document formatting options using CSS.

Style sheet dimension units

Dataplane PDF report exports are targeted for print media, so when specifying the size of fonts and other document elements, always use units of points ("pt") rather than pixels ("px"). One point equals 1/72 of an inch.

For example, use "font-weight: 10pt;" rather than "font-weight: 10px;"

The same rule applies for margins, borders, padding and any other CSS attribute that requires a dimension.

Adding background images

To add custom letterhead or a watermark to your reports, PDF report exports can be configured to use a background image.

The background image can be defined either as a global /wiki/spaces/dataplaneDr iaft/page/442729698 used on all reports exported by Dataplane users, or as a report-specific /wiki/spaces/d iatalaneDaf/pages/442729698 defined with a Dataplane Customizer Script. Both methods for setting background images are described in the previous sections.

Background images must be in the PNG file format.

We suggest the following background image dimensions to render the export at a standard print resolution of 300 ppi:

Export Page Size	Image Width	Image Height

Export Page Size	Image Width	Image Height
Letter (8.5 x 11)	2550 px	3300 px
A4 (210 mm x 297 mm)	2480 px	3507 px

The default PDF report export page size is user-specific, base/wiki/spaces/d on thataplane lDrangf/page/regon sttings/442729698 in the user's Jira profile.

The background image height is automatically stretched to fill the full page height, and the background image width is scaled, as needed, to maintain proper proportions. As a result, horizontal cropping can sometimes occur if your image dimensions are not proportional to the selected page size.

If you want to export reports in both Letter and A4 sizes, use the A4 dimensions for your background image to avoid unnecessary horizontal cropping.

Page Contents