> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Error Messages and Diagnostics
> Nextedy GANTT provides diagnostic information through error indicators, footer messages, and browser console output.
export const LastReviewed = ({date}) => {
if (!date) return null;
const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC"
});
return
Last reviewed on {formatted}
;
};
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](/gantt/reference/configuration/color-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:
```javascript theme={null}
// Check for configuration errors in the browser console
console.log("Gantt config loaded:", gantt.config);
```
## Related Pages
* [Gantt Config Script API](/gantt/reference/api/config-script-api) -- configuration scripting reference
* [Marker Factory API](/gantt/reference/api/markers-api) -- marker script debugging
* [Item Script API](/gantt/reference/api/item-script-api) -- item script debugging
* [Color and Styling Properties](/gantt/reference/configuration/color-properties) -- marker color configuration format
* [License Types and Evaluation Periods](/gantt/reference/license-types) -- license-related error states