Skip to main content
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:
ElementDescription
Footer indicatorAn error footer appears at the bottom of the Gantt chart
Click to expandClicking the footer opens a detailed error message identifying the error location
Browser consoleErrors are also logged to the browser console for further debugging
Server logsErrors are logged to Polarion server logs (contact your Polarion administrator)

View Mode (User View)

ElementDescription
Triangle iconA visual indicator (triangle icon) appears in the Gantt footer
PurposeInforms end users that configuration or data-related issues exist
Detail levelLess 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 CategoryPrefixSource
Config Script ErrorConfig Script Error:Error in the Gantt Config Script widget parameter
Markers Script ErrorMarkers Script Error:Error in the Markers Script widget parameter
Item Script ErrorItem 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:
ElementClassDescription
Error indicator.gantt-errors-infoWarning icon with error count badge
Count badgeNumericTotal number of errors detected across all scripts
VisibilityBoth modesAppears in both view mode and wiki editor mode

Data Loading Statistics

The Gantt footer displays load statistics that help diagnose data issues:
MetricDescriptionDiagnostic Significance
itemsTotal work items loaded successfullyExpected total task count
skippedItems skipped due to maxItems limitNon-zero value triggers a footer warning; increase maxItems to load more
filteredItems excluded by query or type filterIndicates how many items the query returned versus how many are visible
hiddenItems hidden by client-side filterExplains why visible count is lower than total items
unresolvableItems that could not be resolved (permissions or deletion)May appear as phantom tasks; check work item permissions
errorsCountTotal errors during data loadingNon-zero value triggers an error indicator in the footer
serverLoadTimeServer 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:
ValidationError ConditionResolution
percentages arrayEmpty, non-numeric, or not in ascending orderProvide a non-empty array of ascending numbers
colors arrayEmpty or wrong lengthProvide an array with length = percentages length + 1
Array length mismatchcolors length does not equal percentages length + 1Ensure 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 MessageTriggerResolution
Task’s schedule cannot be shortenedDuration edit would make task shorter than required by childrenAdjust child task durations first
Cannot be scheduled outsideTask dates would exceed parent task date boundariesMove 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

diagram

Warning Messages

Warning TypeTriggerDescription
Read-only mode warningUser attempts an edit action in view-only modeDisplayed as an overlay message
Editor configuration warningGantt detects a configuration or data error that prevents editingShown as an inline warning overlay
Required fields warningRequired workflow fields are missing from the Additional Dialog FieldsShown in the server log as an admin warning
Invalid field referenceField added to fieldFilter that is already bound as a data mapping fieldLogged as a warning during configuration parsing

Debugging Steps

StepActionTool
1Check the Gantt footer for error indicators and load statisticsGantt UI
2Open browser developer tools (right-click > Inspect > Console tab)Browser console
3Review Polarion server logs for detailed error messagesServer log files
4In edit mode, click the error footer to see the detailed error messageGantt error panel
5Verify script syntax in Config Script, Item Script, and Markers ScriptWidget parameters
6Check 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);
KB ArticlesSupport TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/LoadInfo.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/ganttCheckWarningInfo.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/Aresource-view/ganttMarkersColorConfigValidation.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/tooltips.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/ganttPreventMovingOutOfParent.cy.ts