Skip to main content
The following field types are supported in the Gantt lightbox editor:
Field TypeLightbox ControlDescription
TEXTText inputStandard single-line text entry
INTEGERNumeric inputInteger value entry
FLOATNumeric inputFloating-point value entry
DATEDate pickerDate-only field with calendar widget
DATETIMEDate-time pickerDate and time field with calendar widget
DURATIONDuration inputDuration entry with increment/decrement controls
SELECTDropdownSingle-value selection from enumeration options
MULTISELECTMulti-select dropdownMultiple-value selection from enumeration options
SINGLE_CHECKBOXCheckboxBoolean true/false toggle
RICH_TEXTRead-only displayRich text fields are displayed but not editable in the lightbox

Data Mapping Field Requirements

The Gantt uses specific Polarion work item fields for core scheduling data. Each mapping has field type requirements:
MappingWidget ParameterSupported TypesDefault FieldRecommended Type
Start datestartFieldDate, DateTime, Stringgantt_startDate
End dateendFieldDate, DateTime, StringNot setDate
DurationdurationFieldInteger, Stringgantt_durationInteger
ProgressprogressFieldFloat, Stringgantt_progressFloat
ResourceresourceFieldUser enum, StringSee applicationUser enum
String-type fields work for start/end/duration/progress but have precision limitations. Use native Date, Integer, or Float field types for production deployments.

Valid Field Mapping Combinations

You must configure exactly two of the three date/duration fields. Valid combinations:
CombinationFields RequiredDescription
Start + EndstartField + endFieldDuration is calculated automatically
Start + DurationstartField + durationFieldEnd date is calculated automatically
End + DurationendField + durationFieldStart date is calculated automatically

Duration Precision

ModeValueDuration UnitDate Format
StandardStandard (Days)DaysDate only
HighHigh (Hours)HoursDate and time
High-precision mode changes the Gantt date format globally and requires hour-capable date fields. See Data Mapping Parameters.

Progress Field Format

The progress field stores completion as a float value:
ProgressFloat ValueTask Bar Fill
0%0.0Empty
50%0.5Half filled
100%1.0Fully filled

Enumeration Field Handling

Polarion enumeration fields are supported in the lightbox as follows:
Polarion Field TypeLightbox Behavior
Single enumRendered as a SELECT dropdown with all enumeration options
Multi-enum / ListRendered as a MULTISELECT dropdown with enhanced selection UI
User enum (@user)Rendered as a SELECT dropdown with user list
User list (@userList)Rendered as a MULTISELECT dropdown with user list
CategoryRendered as a SELECT dropdown with category options

Field Metadata Properties

Each field in the lightbox carries the following metadata:
PropertyTypeDescription
idStringInternal Polarion field identifier used for reading/writing values
referenceIdStringOptional remapping identifier that overrides the field ID for data storage
labelStringHuman-readable display label shown as the section heading in the lightbox
fieldTypeStringThe lightbox control type (TEXT, SELECT, DATE, etc.)
valueTypeStringPrimitive value type for type-safe conversion (INTEGER, FLOAT, STRING, etc.)
defaultValueVariesDefault value applied when creating a new task
requiredBooleanWhen true, the field must have a value before saving. Marked with an asterisk
readonlyBooleanWhen true, the field is displayed but not editable
optionsArrayList of selectable values for SELECT and MULTISELECT fields

Excluded Field Types

The following field types are not supported for Gantt editing:
Field TypeReason
HTML Rich TextComplex rendering not compatible with inline editing
TimeOnlyNot applicable to Gantt scheduling
statusSystem field managed by Polarion workflows
resolutionSystem field managed by Polarion workflows
linkedWorkItemsManaged through dependency link configuration

Additional Dialog Fields

You can add extra fields to the lightbox beyond the core date/duration/resource fields using the Additional Dialog Fields (fieldFilter) configuration per work item type.
Fields already bound as startField, endField, resourceField, durationField, or progressField cannot be added to Additional Dialog Fields. The Gantt validates this and logs a warning for invalid field references.

Role-Based Field Access

The Gantt enforces Polarion role-based field permissions in the lightbox:
PermissionLightbox Behavior
User can read and writeField is fully editable
User can read onlyField is displayed as read-only
User cannot readField is hidden from the lightbox
Date field mapping (startField, endField) is currently global across all work item types. Per-work-item-type date field mapping is a planned improvement.

Configuration Example

Configure data mapping fields in the Work Items Gantt widget parameters:
ParameterExample Value
Start FieldplannedStart
End FieldplannedEnd
Duration Fieldgantt_duration
Progress Fieldgantt_progress
Resource Fieldassignee
Support TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/CustomFieldDTO.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/types/TypeConfig.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/lib/lightbox/util.js
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/types/TypeConfigWidgetParameters.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/CustomFieldDTOFactory.java