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-infoWarning 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 itemsTotal work items loaded successfully Expected total task count skippedItems skipped due to maxItems limit Non-zero value triggers a footer warning; increase maxItems to load more filteredItems excluded by query or type filter Indicates how many items the query returned versus how many are visible hiddenItems hidden by client-side filter Explains 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 loading Non-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:
Validation Error Condition Resolution percentages arrayEmpty, non-numeric, or not in ascending order Provide a non-empty array of ascending numbers colors arrayEmpty or wrong length Provide an array with length = percentages length + 1 Array length mismatch colors 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 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 );
Related Pages
KB Articles Support Tickets Source 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