Skip to main content

Add a Multi-Enum Column

  1. Open the Configuration Editor
  2. Navigate to the Columns section
  3. Add a new column with type multiEnum:<EnumID>
{
  "header": "Affected Systems",
  "binding": "affectedSystems",
  "type": "multiEnum:system_enum",
  "width": 200
}
Use multiEnum:EnumID (not enum:EnumID) for multi-select columns. The prefix multiEnum enables the multi-select picker. Using enum creates a single-selection dropdown instead.

Syntax Comparison

Column TypeSyntaxBehavior
Single-select"type": "enum:status_enum"User selects one value
Multi-select"type": "multiEnum:status_enum"User selects multiple values
FeatureSingle-Select (enum:)Multi-Select (multiEnum:)
SelectionOne value onlyMultiple values
UI ControlDropdown (radio)Checkboxes
Syntax"type": "enum:EnumID""type": "multiEnum:EnumID"
User ActionClick to select, replaces previousToggle checkboxes on/off

Configure Impact Tracking

For FMEA/HARA workflows, use multi-select enums to track multiple impact categories:
{
  "header": "Impact Areas",
  "binding": "impactAreas",
  "type": "multiEnum:impact_enum",
  "width": 180
}
Create an enumeration impact_enum with values:
  • device - Device Integrity
  • patient - Patient Safety
  • operator - Operator Safety
  • environment - Environmental Impact
Users can select multiple impact areas per risk item.

Display Behavior

Multi-enum columns display selected values as a formatted list:
  • Header shows first 2 items: “Device, Patient”
  • If more than 2 selected: “Device, Patient +2 more”
  • Click to open the full multi-select dropdown
  • Each value appears as a chip/tag in the cell

Filter Multi-Enum Columns

Two filtering modes are available:

Filter by Value (Exact Match)

Shows only rows where the multi-enum field exactly matches the selected values:
  1. Click the column filter icon
  2. Select specific enum values
  3. Only rows with those exact selections appear

Filter by Condition (Contains)

Shows rows where the multi-enum field contains any of the specified values:
  1. Click the column filter icon
  2. Switch to Filter by Condition mode
  3. Use the Contains function
  4. Select enum values to match
This returns rows that have at least one of the selected values.
Use Filter by Condition with Contains when you want to find all rows that include specific enum values, even if other values are also selected. This is especially useful for impact tracking where you want to find all risks affecting “Patient Safety” regardless of other selected impacts.

Combine with Dependent Enums

Multi-select enums support cascading relationships:
{
  "from": "hazardCategory",
  "to": "affectedSystems",
  "mapping": {
    "electrical": ["power", "control", "sensors"],
    "mechanical": ["actuators", "structure", "fasteners"]
  }
}
When the parent hazardCategory changes:
  • Invalid child selections are automatically removed
  • Users can still select multiple values from the filtered list
  • If no valid options remain, the field is cleared
Changing the parent enum value removes any multi-select child values that are no longer valid according to the mapping. For example, switching from “electrical” to “mechanical” would remove “power”, “control”, and “sensors” selections and allow only “actuators”, “structure”, and “fasteners”.

Data Storage Format

Multi-enum values are stored as:
  • Polarion List fields: Array of IEnumOption objects
  • String fields: Comma-separated enum IDs (e.g., “device,patient,operator”)
Both formats are automatically handled by RISKSHEET.

Verification

You should now see a multi-select dropdown when clicking the column. Select multiple values and verify they appear as a formatted chip list in the cell. Test filtering using both “Filter by Value” (exact match) and “Filter by Condition” with Contains (partial match) to confirm both modes work correctly.

See Also

Support TicketsSource Code
  • MultiEnumEditor.ts
  • GetSetUtil.java
  • CellPreviewFormatter.ts
  • RelationActionController.ts
  • CellEditorFormatter.ts