Overview Multi-enum columns (also called multi-select enums) store collections of enum values. Unlike single-enum columns that hold one value, multi-enum columns hold arrays of multiple selected options. They work with both native Polarion multi-enum fields and string fields containing comma-separated enum IDs.
Multi-enum columns require a Polarion field type that supports multiple values, such as List<IEnumOption> or a string field configured to hold comma-separated values.
Column Type Declaration Multi-enum columns are declared using the multiEnum: prefix followed by the enumeration identifier:
{ "header" : "Applicable Standards" , "id" : "applicableStandards" , "type" : "multiEnum:standards_list" , "width" : 200 , "filterable" : true }
Configuration Properties Basic Properties Property Type Default Description headerstring Required Column header text displayed in the grid idstring Required Unique column identifier used for data binding typestring Required Must be multiEnum:<enumId> where enumId matches a Polarion enumeration widthnumber Auto Column width in pixels; typically larger than single-enum columns minWidthnumber 80 Minimum column width to display multiple selections bindingstring value of id Data binding path for the column
Property Type Default Description headerGroupstring None Header group text for column grouping headerGroupCssstring None CSS class for styling the header group headerCssstring None CSS class for styling the column header cellCssstring None CSS class applied to all cells in the column showEnumDescriptionboolean false Display enum option descriptions in the multi-select editor wordWrapboolean true Whether text wraps within cells to accommodate multiple values multiLineboolean true Forces textarea-style rendering for multi-value display
Behavior and Editing Property Type Default Description readOnlyboolean false Prevents editing when true; set to false to enable edits on upstream multi-enum fields filterableboolean true Whether the column appears in filter controls sortableboolean true Whether users can sort by this column editableboolean true Controls whether cells can be edited
Styling and Appearance Property Type Default Description cssClassstring None Additional CSS classes for custom styling cellRendererstring None Custom renderer for specialized cell rendering cellDecoratorIdstring None Cell decorator for visual indicators on multiple selections
Data Type Mapping Multi-enum columns support multiple Polarion field types for data storage:
Polarion Field Type Behavior List<IEnumOption> Native Polarion multi-enum field — recommended String Stores comma-separated enum IDs (blank values filtered automatically) IEnumOption[] Array of enum options
When using string fields to store multiple enums, blank values are automatically removed from the collection during save. Empty strings and null values do not create separate selections.
Example Configurations Basic Multi-Select Standards { "header" : "Applicable Standards" , "id" : "applicableStandards" , "type" : "multiEnum:standards_list" , "width" : 180 , "filterable" : true , "sortable" : true }
Multi-Enum with Custom Styling { "headerGroup" : "Compliance" , "headerGroupCss" : "complianceGroup" , "headerCss" : "standardsHeader" , "header" : "Standards" , "id" : "standards" , "type" : "multiEnum:standards_enum" , "cellCss" : "standardsCell" , "width" : 200 }
Upstream Multi-Enum with Editing Upstream (linked item) multi-enum columns are read-only by default. Enable editing with readOnly: false:
{ "header" : "Requirement Tags" , "id" : "requirementTags" , "bindings" : "requirement.tags" , "type" : "multiEnum:tag_list" , "width" : 180 , "readOnly" : false , "level" : 2 }
Multi-Enum for Risk Categories { "header" : "Risk Categories" , "id" : "riskCategories" , "type" : "multiEnum:risk_category" , "width" : 200 , "headerGroup" : "Risk Assessment" , "headerGroupCss" : "riskGroup" , "filterable" : true , "showEnumDescription" : true }
Editor Behavior The multi-enum editor provides a checkbox-based interface for selecting multiple values:
Selection Display
Cell Display : Selected values are displayed as a comma-separated listEditing : Clicking the cell opens a dropdown showing all available options with checkboxesSelection State : Currently selected options display with checkmarksOption Order : Options appear in the enumeration’s defined order
Selection Mechanics Use dependent enum rules (when released) to filter available options based on other column values. For example, show applicable standards only when a specific risk type is selected.
Empty Value Handling Multi-enum columns handle empty values as follows:
Scenario Behavior No selections made Column displays empty; null/empty collection stored Blank option selected Automatically filtered out during save Comma-separated string (string field) Empty values between commas removed automatically Edit and clear all selections Cell becomes empty; collection cleared
Read-Only Upstream Multi-Enums Upstream multi-enum columns (multi-enums showing linked item properties) are read-only by default. This prevents accidental modification of linked objects. Control this with the Polarion configuration property:
nextedy.risksheet.upstreamSubColumnsReadonly=false
To enable editing of a specific upstream multi-enum column, set readOnly: false:
{ "bindings" : "linkedItem.multiEnumField" , "type" : "multiEnum:enumId" , "readOnly" : false }
Multi-Enum with Work Items (Advanced) Multi-enum columns can reference work items using the special syntax multiEnum:@NoIDWorkItems. This allows selecting multiple work items as enum values:
{ "header" : "Linked Work Items" , "id" : "linkedItems" , "type" : "multiEnum:@NoIDWorkItems" , "width" : 250 }
Work item multi-enum syntax requires Polarion custom field configuration with appropriate XML setup. Consult your Polarion administrator for configuration details.
Filtering and Sorting Filter Behavior Multi-enum columns support filtering by:
Single Value : Filter rows containing a specific enum value (matches if any selected value matches)Multiple Values : Filter rows containing any of the specified valuesEmpty/Not Empty : Filter rows with no selections vs. rows with selections
Sort Behavior Multi-enum columns sort by:
Display Order : Lexicographic order of comma-separated display textCount : Number of selected values (when configured)First Value : First selected option in enumeration order
Comparison with Single-Enum Aspect Single-Enum Multi-Enum Values per cell 1 or null 0 or more Column type enum:enumIdmultiEnum:enumIdPolarion field type IEnumOption or String List<IEnumOption> or String Editor style Dropdown (radio) Dropdown (checkboxes) Blank handling Allowed as null Filtered out automatically Display Single value or empty Comma-separated list or empty
Related Pages
KB Articles Support Tickets Source Code
GetSetUtil.javaAppConfig.tsExportToExcel.tsRisksheetViewServlet.javaCustomMergeManager.ts 
