Error Messages and Diagnostics - Nextedy Documentation

Starting with version 25.4.2, the error alert system was improved with clearer error location identification and distinct behavior between edit mode and view mode.

Error Display Modes

Edit Mode (Administrator View)

When a script contains an error in edit mode:

Element	Description
Footer indicator	An error footer appears at the bottom of the Gantt chart
Click to expand	Clicking the footer opens a detailed error message identifying the error location
Browser console	Errors are also logged to the browser console for further debugging
Server logs	Errors are logged to Polarion server logs (contact your Polarion administrator)

View Mode (User View)

Element	Description
Triangle icon	A visual indicator (triangle icon) appears in the Gantt footer
Purpose	Informs end users that configuration or data-related issues exist
Detail level	Less detailed than edit mode to avoid exposing configuration internals to end users

Script Error Categories

The Gantt displays categorized error messages with a bold prefix identifying the error source:

Error Category	Prefix	Source
Config Script Error	Config Script Error:	Error in the Gantt Config Script widget parameter
Markers Script Error	Markers Script Error:	Error in the Markers Script widget parameter
Item Script Error	Item Script Error:	Error in the Item Script widget parameter

Error Count Badge

When configuration scripts contain errors, the Gantt displays an error indicator with a count badge:

Element	Class	Description
Error indicator	`.gantt-errors-info`	Warning icon with error count badge
Count badge	Numeric	Total number of errors detected across all scripts
Visibility	Both modes	Appears in both view mode and wiki editor mode

Data Loading Statistics

The Gantt footer displays load statistics that help diagnose data issues:

Metric	Description	Diagnostic Significance
`items`	Total work items loaded successfully	Expected total task count
`skipped`	Items skipped due to `maxItems` limit	Non-zero value triggers a footer warning; increase `maxItems` to load more
`filtered`	Items excluded by query or type filter	Indicates how many items the query returned versus how many are visible
`hidden`	Items hidden by client-side filter	Explains why visible count is lower than total items
`unresolvable`	Items that could not be resolved (permissions or deletion)	May appear as phantom tasks; check work item permissions
`errorsCount`	Total errors during data loading	Non-zero value triggers an error indicator in the footer
`serverLoadTime`	Server data preparation time (ms)	Useful for performance monitoring

Configuration Validation Errors

Resource Marker Color Validation

The Gantt validates the resource marker color configuration at startup:

Validation	Error Condition	Resolution
`percentages` array	Empty, non-numeric, or not in ascending order	Provide a non-empty array of ascending numbers
`colors` array	Empty or wrong length	Provide an array with length = `percentages` length + 1
Array length mismatch	`colors` length does not equal `percentages` length + 1	Ensure `colors` has exactly one more element than `percentages`

See Color and Styling Properties for the correct format.

Schedule Constraint Errors

The lightbox displays specific error messages when task scheduling violates constraints:

Error Message	Trigger	Resolution
Task’s schedule cannot be shortened	Duration edit would make task shorter than required by children	Adjust child task durations first
Cannot be scheduled outside	Task dates would exceed parent task date boundaries	Move the task within parent bounds or remove the parent relationship

Setting a task’s parent to “no parent” in the lightbox removes the parent-bounds constraint. A previously invalid duration becomes valid after detaching from the parent.

Diagnostic Message Flow

Warning Messages

Warning Type	Trigger	Description
Read-only mode warning	User attempts an edit action in view-only mode	Displayed as an overlay message
Editor configuration warning	Gantt detects a configuration or data error that prevents editing	Shown as an inline warning overlay
Required fields warning	Required workflow fields are missing from the Additional Dialog Fields	Shown in the server log as an admin warning
Invalid field reference	Field added to `fieldFilter` that is already bound as a data mapping field	Logged as a warning during configuration parsing

Debugging Steps

Step	Action	Tool
1	Check the Gantt footer for error indicators and load statistics	Gantt UI
2	Open browser developer tools (right-click > Inspect > Console tab)	Browser console
3	Review Polarion server logs for detailed error messages	Server log files
4	In edit mode, click the error footer to see the detailed error message	Gantt error panel
5	Verify script syntax in Config Script, Item Script, and Markers Script	Widget parameters
6	Check the admin settings page for configuration status	`/polarion/#/administration/gantt/setup`

Configuration Example

Enable diagnostic logging in the Gantt Config Script:

// Check for configuration errors in the browser console
console.log("Gantt config loaded:", gantt.config);

Gantt Config Script API — configuration scripting reference
Marker Factory API — marker script debugging
Item Script API — item script debugging
Color and Styling Properties — marker color configuration format
License Types and Evaluation Periods — license-related error states

​Error Display Modes

​Edit Mode (Administrator View)

​View Mode (User View)

​Script Error Categories

​Error Count Badge

​Data Loading Statistics

​Configuration Validation Errors

​Resource Marker Color Validation

​Schedule Constraint Errors

​Diagnostic Message Flow

​Warning Messages

​Debugging Steps

​Configuration Example

​Related Pages

Error Display Modes

Edit Mode (Administrator View)

View Mode (User View)

Script Error Categories

Error Count Badge

Data Loading Statistics

Configuration Validation Errors

Resource Marker Color Validation

Schedule Constraint Errors

Diagnostic Message Flow

Warning Messages

Debugging Steps

Configuration Example

Related Pages