Configure Multi-Enum Columns - Nextedy Documentation

Single-Select vs. Multi-Select

The critical distinction between single-select and multi-select enum columns is the type prefix:

Type Prefix	Behavior	Stored Format
`enum:EnumID`	Single value dropdown	Single enum ID string
`multiEnum:EnumID`	Multi-select checkbox list	Collection of enum IDs

Using enum:EnumID for a multi-select Polarion field renders a single-select dropdown even though the underlying field supports multiple values. You must use multiEnum:EnumID to enable the multi-select picker.

Define a Multi-Enum Column

Add a column with the multiEnum: type prefix in your risksheet.json:

{
  "columns": [
    {
      "id": "allocation",
      "header": "Allocation",
      "binding": "allocation",
      "type": "multiEnum:allocation_options"
    }
  ]
}

Define Enum Options

Provide the list of available options in the enums section:

{
  "enums": {
    "allocation_options": [
      { "id": "hw", "name": "Hardware" },
      { "id": "sw", "name": "Software" },
      { "id": "mech", "name": "Mechanical" },
      { "id": "sys", "name": "System Integration" }
    ]
  }
}

Each option supports these properties:

Property	Type	Required	Description
`id`	string	Yes	Internal value stored in the work item
`name`	string	Yes	Display text in the dropdown
`description`	string	No	Extended description
`icon`	string	No	Icon identifier

Connect to Polarion Multi-Select Fields

For columns bound to Polarion-native multi-select custom fields, match the type to the XML custom field definition: Standard multi-enum field:

{
  "id": "measures",
  "header": "Measures",
  "binding": "measures",
  "type": "multiEnum:wit_measure-en_me_allocation"
}

WorkItem reference multi-enum:

{
  "id": "workpackages",
  "header": "Work Packages",
  "binding": "workpackages",
  "type": "multiEnum:@NoIDWorkItems[workpackage]"
}

The enum identifier must exactly match the definition name in Polarion’s custom fields XML file. Check your Polarion administration panel for the correct identifier.

Multi-Select Display Behavior

The multi-enum editor displays selected values in a compact format:

Up to 2 selected items are shown in the collapsed cell. When more than 2 are selected, the display shows the first items followed by a “+N more” indicator. Multi-enum fields are optional by default and can be left empty.

Configure Dependent Multi-Enums

Multi-enum columns support dependent relationships where available options are filtered based on a parent column’s value. Configure this in the relations array:

{
  "relations": [
    {
      "from": "riskCategory",
      "to": "measures",
      "mapping": {
        "hardware": ["hw_shield", "hw_redundancy", "hw_isolation"],
        "software": ["sw_monitoring", "sw_validation", "sw_watchdog"]
      }
    }
  ]
}

When the parent riskCategory changes, the multi-enum measures dropdown filters to show only options mapped to the selected category. If the parent value is deselected, any child options that depended on it are automatically removed from the selection.

Dependent enum relationships support both forward (parent to child) and backward (child to parent) propagation. If a child value requires a specific parent, the parent can be auto-populated when only one valid parent exists.

Filter Multi-Enum Columns

Multi-enum columns offer two filtering modes with different behavior:

Filter by Value (Exact Match)

The default “Filter by Value” mode matches exact combinations. If a cell contains both “Hardware” and “Software”, selecting only “Hardware” in the filter will not match because the exact combination differs.

Filter by Condition (Partial Match)

To find all rows containing a specific enum value regardless of other selections:

Click the column filter icon
Select Filter by Condition
Choose Contains from the condition dropdown
Enter the enum value to match

For most use cases, “Filter by Condition” with “Contains” is what users expect. It finds all rows that include the selected value, regardless of other values in the cell.

Export Behavior

Excel export: Multi-enum IDs are converted to display names and separated by commas
PDF export: Values render as a comma-separated list of display names
Cell merging: Multi-enum columns merge when their value arrays are identical (same selected options)

Verification

After configuring your multi-enum columns, you should now see:

A checkbox dropdown appearing when you click a multi-enum cell
Multiple values selectable simultaneously
Selected values displayed as a compact comma-separated list in the cell
Dependent filtering narrowing options when a parent column value changes

​Single-Select vs. Multi-Select

​Define a Multi-Enum Column

​Define Enum Options

​Connect to Polarion Multi-Select Fields

​Multi-Select Display Behavior

​Configure Dependent Multi-Enums

​Filter Multi-Enum Columns

​Filter by Value (Exact Match)

​Filter by Condition (Partial Match)

​Export Behavior

​Verification

​See Also

Single-Select vs. Multi-Select

Define a Multi-Enum Column

Define Enum Options

Connect to Polarion Multi-Select Fields

Multi-Select Display Behavior

Configure Dependent Multi-Enums

Filter Multi-Enum Columns

Filter by Value (Exact Match)

Filter by Condition (Partial Match)

Export Behavior

Verification

See Also