> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# General

> Common questions about Nextedy PLANNINGBOARD — what it is, how it works, and how to get started.

***

## What is Planningboard?

Planningboard is a visual Planningboard embedded in Siemens Polarion ALM. It arranges Polarion Plans and work items as **cards** across **swimlanes**, giving teams a capacity-aware, drag-and-drop interface for sprint and release planning — without leaving the ALM environment. It complements Nextedy GANTT's timeline view with a board-style view.

***

## How does Planningboard fit into Polarion?

Planningboard is installed as a standard Polarion third-party extension and renders as a **widget** embedded in Polarion LiveDoc and Wiki pages. Each widget instance is independently configured via **widget parameters** — so different teams or projects can have different board layouts on the same Polarion instance. See [Installation](/planningboard/getting-started/installation) and [Create Your First Planningboard](/planningboard/getting-started/first-planning-board) for setup details.

***

## What are the main sections of the board?

The board is split into two areas:

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/zUlmOSLBIQ0HyaAX/planningboard/diagrams/faq/general/diagram-1.svg?fit=max&auto=format&n=zUlmOSLBIQ0HyaAX&q=85&s=6858e61eda4f9e09b0b802510fc37798" alt="Board layout showing the Planningboard area on the left as a grid with Iter 1, Iter 2, Iter 3 columns and Alice, Bob swimlane rows, and the Unplanned section on the right with backlog cards" width="720" height="340" data-path="planningboard/diagrams/faq/general/diagram-1.svg" />
</Frame>

Drag cards from the **Unplanned section** onto the board to assign them to a Plan. See [Basic Board Interactions](/planningboard/getting-started/basic-interactions) for a full walkthrough.

***

## What is a "card" on the board?

Each **card** represents a Polarion work item. The content of a card is fully customizable via widget parameters. Clicking a card opens the **Work Item Properties** sidebar, where you can review and edit fields without navigating away from the board. The sidebar fields displayed are configured via the `Sidebar Fields` widget parameter.

***

## What are swimlanes, and how do I choose the right type?

**Swimlanes** are the horizontal rows on the board that group work items. The grouping is controlled by the **swimlane assignment type**, set in **Widget Parameters > Swimlanes (Rows) > Assignment Type**. Available types include:

| Assignment Type   | Groups items by…                   | Best for…                           |
| ----------------- | ---------------------------------- | ----------------------------------- |
| Users (Assignee)  | Team members with a specified role | Workload balancing per person       |
| Parent Item       | Parent work items (e.g. Features)  | Hierarchical planning               |
| Enumeration Field | A custom field value (e.g. Team)   | Category- or team-based planning    |
| Project           | Sub-projects                       | Cross-project planning              |
| SAFe types        | SAFe Programs, ARTs, or Teams      | SAFe environments (contact support) |
| No Swimlanes      | — (single unified view)            | Simple overviews                    |

For full details on each type, see [Swimlanes FAQ](/planningboard/faq/swimlanes).

***

## What happens when I drag a card to the wrong swimlane?

It depends on the swimlane assignment type. With **Parent Item** swimlanes, Planningboard enforces the parent–child relationship: if you drag a card to a swimlane where its parent does not belong, the card automatically snaps back to the correct parent's row. With **Users (Assignee)** and **Enumeration Field** types, placing a card in a swimlane reassigns the work item's field to that row's value.

***

## Can I move verified work items?

No. Once a card has the status **Verified**, it is locked in place and cannot be moved or unplanned via drag and drop. This prevents accidental replanning of completed work. Verified items can be filtered out of the Unplanned section using the filter controls in the toolbar.

***

## Who can edit the board, and who can only view it?

Planningboard enforces **license-based access control**:

* **Licensed users** have full editing capabilities: drag-and-drop cards, access the sidebar, toggle the Unplanned section, and create new Plans.
* **Unlicensed users** can view the full board content — including cards, swimlanes, and capacity bars — but all editing actions are blocked. Drag-and-drop operations do not persist for unlicensed users.

This means team members without a license can still follow progress on the board. See [Licensing FAQ](/planningboard/faq/licensing) for license setup.

<Note title="Read-only visibility">
  Unlicensed users retain full read access so they can participate in planning reviews and track progress without needing a seat.
</Note>

***

## What does the capacity bar show?

The **capacity bar** is a per-swimlane (per-plan column) visual indicator of how much effort is allocated relative to available capacity. Hovering over it shows a detailed tooltip. The capacity bar is only visible when **Show Capacity Load** is enabled in the widget parameters.

Capacity is calculated per user as:

* **Allocated capacity** — sum of remaining estimates for tasks assigned to that user within the plan
* **Total capacity** — user's available capacity from the team calendar for the plan period
* **Available capacity** — total minus allocated (negative values indicate overallocation)

<Warning title="Capacity configuration is whitespace-sensitive">
  Capacity-related widget parameters are whitespace-sensitive. Trailing spaces in property values can cause silent miscalculation. See [Capacity FAQ](/planningboard/faq/capacity) for details and known limitations.
</Warning>

***

## What Plans appear as columns on the board?

Plans displayed as columns are controlled by the **Plans** widget parameters:

* **Plans Type** — selects the plan mode (e.g. **Project Plans** (`PROJECT_PLANS`) for standard project plans, or SAFe modes for SAFe environments).
* **Plans** / **Plans Query** — a Lucene query that filters which Plans appear.
* **Show # of last plans** / **Show # of next plans** — controls how many past and upcoming Plans are loaded (defaults: 1 past, 5 future).

Only Plans matching the configured query and count window are shown. See [Configuration FAQ](/planningboard/faq/configuration) for widget parameter examples.

***

## Does Planningboard support SAFe?

Yes, with caveats. Planningboard includes SAFe-specific plan modes (**SAFe Sprints in Program** (`SAFE_SPRINTS`), **SAFe Sprints in Portfolio** (`SAFE_PFL_SPRINTS`), **SAFe Program Increments in Program** (`SAFE_PIS`), **SAFe Program Increments in Solution** (`SAFE_SOLUTION`)) and SAFe swimlane assignment types (SAFe Programs, Agile Release Train Teams, Program/Solution Teams). SAFe configuration is highly context-dependent: the configuration UI changes depending on which **Plans Type** you select, and each hierarchy level (Portfolio, Program, Team) requires different settings.

<Tip title="SAFe setup requires support guidance">
  SAFe swimlane types and plan modes are available but require setup assistance. Contact Nextedy support to enable and configure them for your environment. See also [SAFe Integration FAQ](/planningboard/faq/safe).
</Tip>

***

## Does Planningboard support page parameters for dynamic filtering?

No. Planningboard swimlane configuration does **not** support Polarion page parameters (e.g. `$pageParameters.xxx`) for dynamic row filtering. This is a known limitation. The available workarounds for multi-team deployments are static: configure separate Planningboard pages per team using hardcoded link roles. If you need dynamic team-based planning, Nextedy GANTT (25.5.0+) supports custom team work item types and may be a better fit as the primary planning tool. See [Multiple Assignees FAQ](/planningboard/faq/multiple-assignees) for related constraints.

***

## Where do I configure Planningboard?

All per-instance configuration is done through the **Widget Parameters** panel of the Planningboard widget on a Polarion LiveDoc or Wiki page. The main parameter groups are:

* **Parameters for Work Items** — scope, query, sort order, dependency roles, sidebar fields
* **Parameters for Plans (Columns)** — plan type, plan query, last/next plan counts, capacity display, assign-to-parent-plan
* **Queries** — custom queries for the Unplanned section
* **Swimlanes (Rows)** — assignment type, user role, report links
* **New Plan** — template, naming pattern, duration, Teams configuration

See [Configuration FAQ](/planningboard/faq/configuration) for a full parameter reference and examples.

<Accordion title="Sources">
  **KB Articles**

  * Swimlane Assignment Types
  * Planningboard Widget Parameters
  * Planningboard interface & basic interactions

  **Support Tickets**

  * [#5879](https://support.nextedy.com/helpdesk/tickets/5879)
  * [#6681](https://support.nextedy.com/helpdesk/tickets/6681)
  * [#6546](https://support.nextedy.com/helpdesk/tickets/6546)

  **Source Code**

  * `licenseReadonly.cy.ts`
  * `Config.java`
  * `PlanningBoardDataService.java`
  * `PlanningBoardWidgetDependenciesProcessor.java`
  * `PlanningBoardWidgetRenderer.java`
</Accordion>
