Lightbox Field Types
The following field types are supported in the Gantt lightbox editor:
| Field Type | Lightbox Control | Description |
|---|
TEXT | Text input | Standard single-line text entry |
INTEGER | Numeric input | Integer value entry |
FLOAT | Numeric input | Floating-point value entry |
DATE | Date picker | Date-only field with calendar widget |
DATETIME | Date-time picker | Date and time field with calendar widget |
DURATION | Duration input | Duration entry with increment/decrement controls |
SELECT | Dropdown | Single-value selection from enumeration options |
MULTISELECT | Multi-select dropdown | Multiple-value selection from enumeration options |
SINGLE_CHECKBOX | Checkbox | Boolean true/false toggle |
RICH_TEXT | Read-only display | Rich 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:
| Mapping | Widget Parameter | Supported Types | Default Field | Recommended Type |
|---|
| Start date | startField | Date, DateTime, String | gantt_start | Date |
| End date | endField | Date, DateTime, String | Not set | Date |
| Duration | durationField | Integer, String | gantt_duration | Integer |
| Progress | progressField | Float, String | gantt_progress | Float |
| Resource | resourceField | User enum, String | See application | User 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:
| Combination | Fields Required | Description |
|---|
| Start + End | startField + endField | Duration is calculated automatically |
| Start + Duration | startField + durationField | End date is calculated automatically |
| End + Duration | endField + durationField | Start date is calculated automatically |
Duration Precision
| Mode | Value | Duration Unit | Date Format |
|---|
| Standard | Standard (Days) | Days | Date only |
| High | High (Hours) | Hours | Date and time |
High-precision mode changes the Gantt date format globally and requires hour-capable date fields. See Data Mapping Parameters. | Progress | Float Value | Task Bar Fill |
|---|
| 0% | 0.0 | Empty |
| 50% | 0.5 | Half filled |
| 100% | 1.0 | Fully filled |
Enumeration Field Handling
Polarion enumeration fields are supported in the lightbox as follows:
| Polarion Field Type | Lightbox Behavior |
|---|
| Single enum | Rendered as a SELECT dropdown with all enumeration options |
| Multi-enum / List | Rendered 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 |
| Category | Rendered as a SELECT dropdown with category options |
| Property | Type | Description |
|---|
id | String | Internal Polarion field identifier used for reading/writing values |
referenceId | String | Optional remapping identifier that overrides the field ID for data storage |
label | String | Human-readable display label shown as the section heading in the lightbox |
fieldType | String | The lightbox control type (TEXT, SELECT, DATE, etc.) |
valueType | String | Primitive value type for type-safe conversion (INTEGER, FLOAT, STRING, etc.) |
defaultValue | Varies | Default value applied when creating a new task |
required | Boolean | When true, the field must have a value before saving. Marked with an asterisk |
readonly | Boolean | When true, the field is displayed but not editable |
options | Array | List of selectable values for SELECT and MULTISELECT fields |
Excluded Field Types
The following field types are not supported for Gantt editing:
| Field Type | Reason |
|---|
| HTML Rich Text | Complex rendering not compatible with inline editing |
| TimeOnly | Not applicable to Gantt scheduling |
status | System field managed by Polarion workflows |
resolution | System field managed by Polarion workflows |
linkedWorkItems | Managed 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:
| Permission | Lightbox Behavior |
|---|
| User can read and write | Field is fully editable |
| User can read only | Field is displayed as read-only |
| User cannot read | Field 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:
| Parameter | Example Value |
|---|
| Start Field | plannedStart |
| End Field | plannedEnd |
| Duration Field | gantt_duration |
| Progress Field | gantt_progress |
| Resource Field | assignee |
Related Pages
