Overview
Widget Parameters
Configure Assignee mode in the Swimlanes (Rows) section of the Widget Parameters panel. Set Assignment Type toUsers (Assignee).
If
userRole is not set, the board cannot determine which users to display as swimlane rows. Set it to a valid Polarion role ID — for example, project_user — to populate the board.Configuration Properties
The following administration-level configuration properties affect Assignee mode behavior. Set these in Polarion Administration → Configuration Properties.Required Data Structure
For Assignee mode to populate swimlanes correctly, the project must meet these requirements:- At least one Polarion role must be assigned to the relevant users (e.g.
project_user). - Work items must have an assignee field set to a user who holds the configured role.
- When using Team Assignments for Plan-range filtering (
activeTeamAssignmentsInPlanRangeOnly=true), the project must have configured Teams and Team Assignments.
How Swimlane Population Works
- The board reads all users who hold the role specified in
userRole. - One swimlane row is created per matching user.
- Each work item is placed in the swimlane whose user matches the item’s assignee.
- Items with an assignee not present in the user list (or with no assignee) go to Not Assigned/Other.
Teams Service Integration
WhenuseTeamsService=true is set on the widget, Assignee mode integrates with the Polarion Teams Service:
- Team membership data is sourced from the Teams Service rather than solely from role membership.
- Per-user capacity values come from the Teams Service, enabling the capacity bar to reflect actual user capacity.
- The
selectedTeamwidget parameter filters swimlanes to members of a specific team.
Drag-and-Drop Behavior
- Dragging a card from the Unplanned sidebar to a swimlane row assigns the work item to that row’s user and plans it into the target column (Plan).
- Dropping a card on a different swimlane row reassigns the work item’s assignee to that row’s user.
- Holding Alt while dragging creates a duplicate assignment: the item is added to the target user in addition to the original assignee (comma-separated assignee list). Duplicating to the Not Assigned/Other swimlane is not supported.
- Cards with status Verified cannot be moved or unplanned.
Capacity Bar
WhencapacityLoad=true is enabled, each swimlane displays a capacity bar showing planned effort against available capacity. In Assignee mode:
- Column-level capacity bars aggregate effort for all items in that Plan column.
- When
userCapacityLoad=trueand the Teams Service is active, capacity bars reflect per-user available capacity sourced from Team Assignments. - Hovering over a capacity bar shows a detailed tooltip (requires capacity configuration via widget parameters).
Filtering Plan-Range Active Users
When your project uses Team Assignments and you want swimlanes to reflect only users active during the displayed Plans:- Project has configured Teams and Team Assignments.
- Nextedy PLANNINGBOARD is configured with user-based swimlanes derived from Team Assignments.
- Property set under Polarion Administration → Configuration Properties.
Configuration Example
The following example configures a Planningboard widget with Assignee mode using theproject_user role, with empty swimlanes hidden and collapsible rows enabled.
Widget Parameters (Swimlanes section):
project_user role. The board displays one swimlane per user. A third user, Mark Test, has no Team Assignment within the shown Plans’ time range; with activeTeamAssignmentsInPlanRangeOnly=true enabled, Mark Test’s swimlane is hidden and any items assigned to him appear in Not Assigned/Other.
Limitations
- No multi-assignee capacity distribution. When a work item has multiple assignees, its effort is not distributed across multiple swimlanes. The capacity calculation does not split effort proportionally between co-assignees.
- Swimlane sort order is coupled to item sort order. Changing the swimlane sort may affect the item sort order within cells.
- Assignee mode sources users from the current project’s role membership. Cross-project user lists require the Project Mode or a SAFe assignment type.
- Team Assignment-based Plan-range filtering (
activeTeamAssignmentsInPlanRangeOnly) requires version 25.12.0 or later.
Related Pages
- Assignment Modes — overview of all available swimlane assignment types
- Swimlanes (Rows) Parameters — full widget parameter reference for swimlane configuration
- Capacity Parameters — configure capacity bars and effort tracking
- Teams Service Properties — Teams Service integration properties
- Parent Item Mode — swimlanes grouped by parent work item instead of assignee
- Enumeration Field Mode — swimlanes grouped by a custom enumeration field
- Project Mode — swimlanes grouped by sub-project
Sources
Sources
KB Articles
- Swimlane Assignment Types
- Filter user swimlanes by Plan range
- Planningboard interface & basic interactions
PlanningBoardWidgetRenderer.javaPlanningBoardDataService.javaPlansMode.javaPlanningBoardWidget.javaAssignmentMode.java