Enumeration Field Mode - Nextedy Documentation

This page is a reference for the parameters, supported field types, filtering options, and known limitations of the Enumeration Field assignment mode. For an overview of all available swimlane assignment types, see Assignment Modes.

How It Works

When assignmentMode is set to ENUM, Nextedy PLANNINGBOARD reads the configured enumeration field on each work item and places the card in the swimlane that corresponds to that field’s value. Work items whose field is empty or whose value is not included in the rows filter are placed in the Not Assigned / Other swimlane at the bottom of the board. When a work item has a multi-value enumeration field (list type), the card can appear in multiple swimlanes simultaneously — one per value held by that field.

Board layout in Enumeration Field mode: swimlane rows for Team Alpha, Team Beta, Team Gamma, and Not Assigned / Other, each with cards distributed across Plan A, Plan B, and Plan C columns

Configure Enumeration Field mode in the Swimlanes (Rows) section of the Widget Parameters panel.

Core Parameters

Name	Type	Default	Description
`assignmentMode`	string	`ASSIGNEE`	Set to `ENUM` to enable Enumeration Field mode.
`enumFieldId`	string	—	Required. The field ID of the Polarion enumeration custom field to use for swimlane grouping. Example: `team`, `component`, `severity`. Must match the exact field ID as configured in Polarion.

Row Visibility

Name	Type	Default	Description
`showEmptySwimlanes`	boolean	`false`	When `true`, swimlanes with no work items are shown. When `false` (default), only swimlanes that contain at least one card are rendered.
`swimlaneSort`	string	`alphabetical`	Sort order for swimlane rows. Applies to Enumeration Field mode.

Row Filtering

Name	Type	Default	Description
`rowsFilter`	multi-value selector	(all values)	Limits which enumeration values appear as swimlane rows. When no values are selected, all values from the field’s enumeration are shown. When one or more values are selected, only those values appear as rows. Configured via the Rows Filter dialog in the Widget Parameters panel.

Optional

Name	Type	Default	Description
`reportLink`	string	—	Optionally attach a Polarion report URL. The link is surfaced per swimlane for deeper analysis of that field value.

Supported Field Types

Planningboard supports the following Polarion field types for Enumeration Field mode:

Field Type	Supported	Notes
Single-value enumeration (`IEnumType`)	Yes	Each card appears in exactly one swimlane.
Multi-value enumeration (list of `IEnumType` items)	Yes	A card with multiple values appears in each matching swimlane simultaneously.
`status` field	No	Not supported as a swimlane grouping field.
`resolution` field	No	Not supported as a swimlane grouping field.
`type` (work item type) field	No	Not supported as a swimlane grouping field.
Free-text or numeric fields	No	Only enumeration-typed fields are valid.

Global enumeration custom fields (defined at the global Polarion administration level rather than per project) are not reliably supported for swimlane grouping. A global field may appear to validate correctly during initial widget configuration but fail post-save with the error “field does not exist or is not of type enumeration”.Workaround: Use project-specific enumeration custom fields. If you require a global enum field, contact Nextedy support.

Full support for multi-value (multi-select) enumeration fields as swimlane sources was under active development as of early 2026. If you encounter issues with multi-enum swimlanes, verify you are running a current release and contact support.

Rows Filter

The Rows Filter lets you restrict which enumeration values are displayed as swimlane rows, without modifying the field definition in Polarion. Behaviour:

An empty filter (no values selected) shows all values from the enumeration — every option defined on the field for the current work item type appears as a swimlane row.
A populated filter shows only the selected values. Values not in the filter are hidden; work items whose field holds a hidden value are placed in the Not Assigned / Other swimlane.
Available enum values in the Rows Filter dialog reflect the selected work item type on the board. Different work item types may define different option sets for the same field ID.

How to configure:

Open the Widget Parameters panel and navigate to Swimlanes (Rows).
Set Assignment Type to Enumeration Field.
Enter the Field ID of your enumeration field.
Click the Rows Filter selector to open the multi-value dialog.
Select the values you want to appear as rows and confirm.

Rows Filter dialog for the team field, with Team Alpha and Team Beta checked, Team Gamma and Team Delta unchecked, and Cancel/Confirm buttons

Configuration Example

The following example configures a Planningboard to display swimlanes grouped by a project-level team enumeration field, showing only two specific teams and hiding empty rows. Widget Parameters — Swimlanes (Rows) section:

assignmentMode=ENUM
enumFieldId=team
showEmptySwimlanes=false
swimlaneSort=alphabetical

Rows Filter selection: Team Alpha, Team Beta In this configuration:

Work items with team=Team Alpha appear in the Team Alpha swimlane.
Work items with team=Team Beta appear in the Team Beta swimlane.
Work items with any other team value, or no team value, appear in Not Assigned / Other.
Empty swimlanes are hidden — if no items are planned for a team in the visible Plans, that row does not render.

Drag-and-Drop Assignment

When a user drags a card from one swimlane to another in Enumeration Field mode, Planningboard updates the enumeration field on the work item to the value corresponding to the target swimlane. This write-back happens immediately on drop. Restrictions:

Dragging a card to the Not Assigned / Other swimlane clears the field value on the work item (sets it to empty).
In read-only mode, drag-and-drop is disabled and field values cannot be changed from the board.
In prioritize mode, drag-and-drop is also blocked.

When using a multi-value enumeration field, dragging a card between swimlanes appends or removes individual values rather than replacing the entire field. Verify the resulting field state in Polarion after moving items with multiple values.

Swimlane Sort Order

The swimlaneSort parameter controls the vertical order of swimlane rows when using Enumeration Field mode.

Value	Behaviour
`alphabetical` (default)	Swimlane rows are sorted A–Z by the display label of the enumeration value.

Additional sort options (e.g., by enumeration option order as defined in Polarion, or custom ordering) may be available. Verify against the running application for the current option set.

Capacity in Enumeration Field Mode

Capacity bars and capacity load work with Enumeration Field mode in the same way as other assignment modes. Each swimlane row shows a capacity bar reflecting the total effort of cards assigned to that row across the visible Plans. When a work item appears in multiple swimlanes (multi-value field), its effort is counted in each swimlane it appears in. This can result in effort being counted more than once across the board total. See Capacity Parameters for capacity configuration details.

Limitations

Limitation	Details
Global enumeration custom fields	Not reliably supported. Use project-specific fields. See the warning above.
`status`, `resolution`, and `type` fields	Cannot be used as the swimlane grouping field.
Multi-enum swimlane support	Was under active development as of early 2026; verify support in your installed version.
Capacity double-counting	When a multi-value field places a card in multiple swimlanes, effort is counted per swimlane — not de-duplicated at board level.
Swimlane sort is coupled to item sort	The vertical order of swimlanes and the order of items within swimlanes share the same underlying sort mechanism; configuring one affects the other.
Custom-enum card coloring	Card coloring based on enumeration values may have parity gaps compared to other Nextedy board products.

Troubleshooting

”Field does not exist or is not of type enumeration” after saving

Cause: The configured enumFieldId either does not exist in the project, is not an enumeration type, or is a global field that is not supported in this context. Steps:

Verify the field ID is spelled exactly as defined in Polarion Administration → Custom Fields for the relevant work item type.
Confirm the field type is Enumeration (single or multi-value list), not text or numeric.
If using a global field, switch to a project-level enumeration field instead.
After correcting the field ID, save the widget configuration. If the error persists, rebuild the widget configuration: remove the swimlane configuration, save, re-add it with the correct field ID, and save again.

Rows Filter shows no options

Cause: The enumeration field has no values defined for the currently selected work item type, or the field ID is incorrect. Steps:

Confirm the Field ID is correct and the field is associated with the work item type shown on the board.
Check that the enumeration has at least one option defined in Polarion Administration for that work item type.
Change the work item type selector on the board to the type that has the field configured, then re-open the Rows Filter dialog.

Cards appear in “Not Assigned / Other” unexpectedly

Cause: The field value on the work item is empty, or the value is excluded by the Rows Filter. Steps:

Open the work item in Polarion and confirm the enumeration field has a value set.
Check the Rows Filter in the widget configuration — if specific values are selected, items with other values are routed to Not Assigned / Other.
Clear the Rows Filter (deselect all values) to show all enum values as rows, and verify where items land.

Assignment Modes — overview of all swimlane assignment types
Assignee Mode — swimlanes by user/assignee
Parent Item Mode — swimlanes by parent work item
Project Mode — swimlanes by sub-project
Swimlanes (Rows) Parameters — full swimlane widget parameter reference
Capacity Parameters — capacity bar configuration

Sources

KB Articles

Swimlane Assignment Types
Filter user swimlanes by Plan range
What is ‘Normalization’

Support Tickets

Source Code

PlanningBoardWidgetRenderer.java
PlansMode.java
PlanningBoardDataService.java
PlanningBoardWidgetDependenciesProcessor.java
planningboard.js

​How It Works

​Widget Parameters

​Core Parameters

​Row Visibility

​Row Filtering

​Optional

​Supported Field Types

​Rows Filter

​Configuration Example

​Drag-and-Drop Assignment

​Swimlane Sort Order

​Capacity in Enumeration Field Mode

​Limitations

​Troubleshooting

​”Field does not exist or is not of type enumeration” after saving

​Rows Filter shows no options

​Cards appear in “Not Assigned / Other” unexpectedly

​Related Pages

How It Works

Widget Parameters

Core Parameters

Row Visibility

Row Filtering

Optional

Supported Field Types

Rows Filter

Configuration Example

Drag-and-Drop Assignment

Swimlane Sort Order

Capacity in Enumeration Field Mode

Limitations

Troubleshooting

”Field does not exist or is not of type enumeration” after saving

Rows Filter shows no options

Cards appear in “Not Assigned / Other” unexpectedly

Related Pages