In Risksheet, enum values are NOT defined inside the sheet configuration. They come from Polarion enumerations defined in Siemens Polarion ALM. The sheet configuration only references those enumerations from individual column definitions.
Step 1: Define the Enumeration in Polarion
Multi-select enum values are managed in Polarion, not in the sheet configuration.
- Open Polarion Administration > Enumerations for your project (or globally).
- Create a new enumeration (for example,
allocation) and add the items you want to expose: mech, elec, sw, sys, with display names such as “Mechanical”, “Electrical”, “Software”, “System”.
- Create or reuse a custom field on the risk work item type that is bound to this enumeration and allows multiple values.
The enumeration ID (here allocation) is what the sheet configuration will reference. You do not redeclare options, names, or visibility in the sheet configuration file.
To hide deprecated values, mark them as not visible in the Polarion enumeration definition. Risksheet will simply not offer them in the dropdown.
Step 2: Add a Multi-Enum Column
In the sheet configuration (the configuration editor supports YAML editing since v25.5.0), add a column that references the enumeration via the multiEnum: type prefix and binds it to the Polarion custom field through bindings:
Key points:
type: multiEnum:<enumId> tells Risksheet to render a multi-select dropdown backed by the Polarion enumeration whose ID is <enumId>.bindings (plural) is the Polarion field ID on the risk work item that stores the selected values.- The server loads the enumeration values automatically; no list of options lives in the sheet configuration.
The column type must use the multiEnum: prefix (for example, type: multiEnum:allocation). Using type: enum:allocation renders a single-select dropdown even if the underlying Polarion field supports multiple values.
Multi-Select Display Behavior
| Selected Count | Display |
|---|
| 0 | Empty cell |
| 1 | Single value name |
| 2 | Both value names shown |
| 3+ | First 2 names + “+N more” indicator |
- Pick a controlling column on the same row (for example, a
riskCategory enum column).
- On the multi-enum column, declare which values become available for each value of the controlling column.
When the controlling column changes:
- The multi-enum dropdown filters to show only the values listed for the new controlling value.
- Any currently selected values that are no longer valid for the new controlling value are automatically removed.
- If the controlling cell is cleared, the full set of enumeration values becomes available again.
Cascading updates triggered by a dependent-enum change are tracked together in the undo stack. A single undo (Ctrl+Z) reverts the controlling change and any dependent values that were cleared.
Filtering Multi-Enum Columns
Column filtering is enabled by default on multi-enum columns. Users can filter rows by one or more selected enumeration values; matching is value-based, so a row is included when its selected set intersects the filter set. If you need to opt a column out of filtering, set filterable: false on the column definition.
Verification
You should now see a multi-select dropdown when clicking a cell in the configured column. Selecting multiple values displays them as chips, with a “+N more” indicator when more than two values are selected. If a dependent mapping is configured, changing the controlling cell should immediately reshape the available options and drop any invalid selections.
See Also
