Skip to main content

​
Basic PDF Export

  1. Open your RISKSHEET document in Polarion
  2. Click the Export button in the toolbar
  3. Select Export to PDF
  4. The browser downloads a PDF file named after your document
The PDF export uses:
  • Landscape A4 orientation for maximum column visibility
  • 26pt margins on all sides
  • Automatic row height calculation based on content
  • Preserved styling including background colors, text colors, and borders

​
How Column Types Render in PDF

Column types export with specific formatting:
Column TypePDF RenderingNotes
BooleanText: true or falseCheckboxes become text
Item LinkPlain text link labelHyperlinks not preserved
Server-RenderedPlain text with <li> → newlinesHTML tags stripped
Multi-Item LinkNewline-separated list, * for new itemsJSON parsed and formatted
Multi-EnumEnum names (not IDs)Resolves via config.enums
Enum fields in PDF exports may not display with the same clarity as the interactive UI. For enhanced enum formatting, consider using custom PDF scripts (see below) or configure conditional formatting to add visual indicators before export.

​
PDF Export Flow

diagram

​
Customize PDF Export with Scripts

For advanced PDF layouts, attach a risksheetPdfExport.vm Velocity template to your document:
  1. Create a file named risksheetPdfExport.vm
  2. Write Velocity/JavaScript code using the PDF export API
  3. Attach the file to your RISKSHEET document in Polarion
  4. Export to PDF – your script controls the output
The script has access to:
  • exporter – PDF generation utilities
  • PDFExport and GridPDF – layout classes
  • doc – current Polarion document object
  • config – RISKSHEET configuration (enums, ratings, formulas)
  • isInCompare, compareRevision, currentRevision – baseline comparison state
  • pdfExportMacros.vm – helper macros for common PDF operations
Use custom PDF scripts to: (1) Hide specific columns during export, (2) Add rating tables or enum definitions, (3) Export downstream traceability tables, (4) Include baseline-specific content, (5) Add custom headers/footers with page numbers.
For detailed scripting guidance, see Customize PDF Export Scripts.

​
Hide Columns During Export

You can selectively hide columns in the PDF without removing them from your view: Option 1: Use Saved Views
  1. Create a saved view with only export-relevant columns visible
  2. Apply the view before exporting
  3. Export to PDF
  4. Switch back to your working view
Option 2: Custom Script Column Hiding In your risksheetPdfExport.vm script: 
## Hide columns by binding name (comma-separated)
$exporter.exportMainSheet("calculatedColumn1,internalNotes")
Hidden columns are automatically restored after export completes.
If you use calculated columns that auto-populate description or title fields, those formula columns must be visible when the sheet loads. Formulas only execute on visible columns. Use saved views to hide them after the sheet loads but before export.

​
Pagination and Multi-Page Content

PDF exports automatically paginate content:
  • Page breaks occur when content exceeds page height
  • Header rows repeat on continuation pages for context
  • Row height adjusts automatically to fit cell content
When a single risk item spans multiple pages, header information (hazard, severity, occurrence) repeats on each continuation page. This is currently by design to preserve context, but may cause confusion. A fix for excessive repetition is being tracked by the development team.
Some users have reported truncated text in PDF table columns. If you experience this issue, try: (1) reducing column count via saved views, (2) using custom scripts to control table width, or (3) splitting large tables into multiple PDF exports.

​
Verify the Export

Open the downloaded PDF file. You should see:
  • Landscape A4 layout with all visible columns
  • Row headers showing work item IDs
  • Cell background and text colors preserved
  • Automatic pagination with repeated headers
  • Readable text without excessive truncation
If baselines don’t appear as expected, check your risksheetPdfExport.vm script for baseline filtering configuration. See PDF Export API for details.

​
See Also

Support TicketsSource Code
  • PdfExportConfigurationService.java
  • ExportToPdfCommand.ts
  • CommandFactory.ts
  • ExportToPdf.ts
  • RisksheetViewServlet.java