Supported Field Types - Nextedy Documentation

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 Field Format

The progress field stores completion as a float value:

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

Field Metadata Properties

Each field in the lightbox carries the following metadata:

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`

Data Mapping Parameters — field mapping widget parameters
Work Item Types Configuration — per-type fieldFilter configuration
Work Items Gantt Widget Parameters — core widget parameter reference
Error Messages and Diagnostics — field validation error messages

​Lightbox Field Types

​Data Mapping Field Requirements

​Valid Field Mapping Combinations

​Duration Precision

​Progress Field Format

​Enumeration Field Handling

​Field Metadata Properties

​Excluded Field Types

​Additional Dialog Fields

​Role-Based Field Access

​Configuration Example

​Related Pages

Lightbox Field Types

Data Mapping Field Requirements

Valid Field Mapping Combinations

Duration Precision

Progress Field Format

Enumeration Field Handling

Field Metadata Properties

Excluded Field Types

Additional Dialog Fields

Role-Based Field Access

Configuration Example

Related Pages