Skip to main content
Familiarity with widget parameters and swimlane configuration is assumed. If you are new to Planningboard, start with Widget Parameters Overview and Configure Swimlanes (Rows) before working through this section.

Topics in This Section

Item Scripts — Write JavaScript expressions that run per card to control labels, colors, and field values rendered on each work item card. Config Scripts — Write server-side scripts that dynamically compute widget configuration at load time, allowing board layout to adapt to context, user, or project state. Data Scripts — Write server-side scripts that shape the work item dataset the board loads, enabling custom filtering, sorting, or data enrichment beyond the standard Plan query. Template Functions — Use the built-in template function library available inside item scripts and config scripts to format field values, resolve enumerations, and compose card content. Dynamic Filtering with Page Parameters — Pass Polarion page parameters into the board widget at runtime to drive swimlane filters, Plan queries, or dataset scope without hardcoding values in the widget configuration. Read-Only Mode — Configure the board for viewing without drag-and-drop or edit permissions, suitable for stakeholder dashboards and embedded reporting pages. Custom Project Templates — Package a Planningboard widget configuration as a reusable project template so new projects start with a consistent board setup. Scripted Page Parameters — Generate page parameter values programmatically using scripts, extending the dynamic filtering pattern to computed or user-context-derived inputs.

Script Execution Overview

Board load sequence: Polarion page render, then widget parameter resolution, then server-side Config Script execution, then server-side Data Script execution, then the board rendering Plans and cards, then client-side Item Script execution per card, ending with the rendered board displayed
Script errors surface as board-level warnings or empty boards. See Script Errors for diagnosis steps.
KB Articles
  • Planningboard Widget Parameters
  • Planningboard: Customizable Statistics and Capacity Indicators
  • Planningboard interface & basic interactions
Support TicketsSource Code
  • Config.java
  • viewSetup.vm
  • Item.java
  • PlanningBoardWidgetRenderer.java
  • widget.vm
Last modified on July 9, 2026