This documentation is for an old version of Dataplane Reports.

View the latest documentation, or the list of documentation for all versions.

PDF Export Defaults

PDF Export Defaults

When exporting reports in PDF format, in the absence of any specific configuration instructions, the following default settings determine the size, orientation and layout of the PDF. Some of these settings can be customized by a Jira administrator to provide a global default specific to your organization.

PropertyDefaultDescription
page size

letter or A4

The page size for Dataplane PDF exports is determined on a user-by-user basis based on the user's Jira Profile.

If a user's Jira profile language/region is set to the US, Canada or Mexico, the default page size is "letter" (8.5 inches x 11 inches). For all other regions, the default page size is "A4" (210 mm x 297 mm).

This default can be modified on a report-by-report basis using Dataplane Customizer Scripts.

page orientation

portrait

Dataplane uses vertically-oriented pages ("portrait") as the default for PDF exports.

This default can be modified on a report-by-report basis using Dataplane Customizer Scripts.

background image (letterhead or logo)

none

By default, Dataplane does not add a background image, logo or letterhead to PDF exports.

Administrators can set up a default, global background image to customize the look of all Dataplane reports exported by your organization, place an image file named 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 default background image on all subsequent reports exported from Dataplane. No restart of Jira or reinstallation of Dataplane is necessary. For information on the specifications of the image, see

Per-report background images can also be defined through the use of Dataplane Customizer scripts (see PDF Export Customizer Scripts).

stylesheets<none>

By default, Dataplane uses its own built-in styling for reports that are exported to PDF using cascading stylesheet (CSS) rules.

If you wish to set up a global cascading stylesheet to customize the formatting of all Dataplane reports exported by your organization, place a cascading stylesheet file named default.css in the following location on your Jira server:

<JIRA_DATA>/dataplane/export/default.css

(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 included as a stylesheet on all subsequent reports exported from Dataplane. No restart of Jira or reinstallation of Dataplane is necessary.

Page Contents