Rendering and Display Errors - Nextedy Documentation

Rendering Issue Decision Table

Use this table to identify your specific symptom and jump to the appropriate resolution:

Symptom	Likely Cause	Section
Risksheet redirects to space home page	Missing topic in Polarion view	Redirect to Space Home Page
`UnsupportedOperationException` in server logs	Document field rendering failure	UnsupportedOperationException in Server Logs
`StringIndexOutOfBoundsException` in server logs	Misconfigured Velocity template	Velocity Template Errors
Browser console errors (“Positive number expected”)	Polarion or configuration issue	Browser Console Errors
Configuration looks different across cluster nodes	Cluster synchronization delay	Cluster Node Inconsistency
Page loads take over 60 seconds	Unresolvable work item references	Slow Loading from Broken Links
Header tooltips blocking filter buttons	Known bug in older versions	Header Tooltip Overlap
Risksheet not activating after server maintenance	Post-maintenance compatibility	Post-Maintenance Activation Failure
Enum value mapping errors (“For input string:“)	Invalid enum configuration	Enum Configuration Errors

Diagnostic Flowchart

Use this flowchart to narrow down the category of your rendering issue before diving into a specific section:

Redirect to Space Home Page

Problem

When clicking Risksheet in the navigation sidebar, the browser redirects to the project’s space home page instead of displaying the Risksheet grid. This affects specific users or all users after an update.

Cause

The Risksheet topic is not configured in the user’s active Polarion view (hat). This is the single most common rendering issue and is frequently misidentified as a browser compatibility problem, certificate issue, or installation failure.

Resolution

Step 1: Identify which Polarion view the affected user is using. Ask the user to check their current view in the Polarion UI header. Step 2: Navigate to Administration > Topics in the affected project. Step 3: Locate the view configuration for the affected user’s view and add the Risksheet topic:

<topic id='risksheet'/>

Step 4: Save the configuration and ask the user to refresh the page.

If your Polarion instance uses multiple views for different roles (for example, “Engineer View” and “Manager View”), the <topic id='risksheet'/> entry must be present in every view where users need Risksheet access. Missing the topic in even one view causes redirects for all users assigned to that view.

Common scenarios where this issue appears:

Scenario	What Actually Happened
After Risksheet update	Topic was removed from a custom view during configuration migration
Only some users affected	Those users are assigned to a different Polarion view that lacks the topic
Works in Firefox, not Edge (or vice versa)	Users may be logged into different views in different browsers
Appears to be a certificate problem	Network errors in the browser mask the real cause — a missing topic entry

UnsupportedOperationException in Server Logs

Problem

The Polarion server log contains java.lang.UnsupportedOperationException errors when loading Risksheet, typically referencing document field rendering such as renderingLayouts.

Cause

This exception occurs when the system attempts to render document fields that are not supported in the current Polarion version. The system skips the failed field and continues normally, so Risksheet functionality is not affected. This is particularly common after upgrading to Polarion 2310 or later, where the renderingLayouts field conversion triggers the error.

Resolution

Step 1: Verify that Risksheet is functioning correctly despite the log errors. Open a risk document and confirm that data loads, columns render, and editing works as expected. Step 2: Update Risksheet to version 24.7.0 or later, which suppresses the document field rendering error entirely. If you are already on 24.7.0 but see related issues, update to 24.7.2 which includes an additional fix.

UnsupportedOperationException errors related to document field rendering (especially renderingLayouts) have no impact on Risksheet functionality. The system automatically skips unsupported fields and continues loading. If you are on version 24.7.0+ and still see these errors, contact support with the full stack trace.

Velocity Template Errors

Problem

The server log shows StringIndexOutOfBoundsException errors originating from Velocity template processing, or the top panel displays incorrectly or is blank.

Cause

These errors are typically caused by misconfigured risksheet.json or custom Velocity template files (such as topPanel.vm). Common triggers include syntax errors in Velocity expressions, references to undefined variables, and incorrectly escaped special characters.

Resolution

Step 1: Check your risksheet.json for any Velocity expressions in serverRender column properties or topPanel configuration. Look for these common mistakes:

Unclosed ${} or #{} blocks
References to variables that may be null (use $!variable for null-safe access)
String operations on empty values (e.g., .substring() on a null field)

Step 2: If you have a custom topPanel.vm file, validate its Velocity syntax by checking these areas:

Step 3: Re-upload the corrected configuration file and refresh the Risksheet page. Check the server log again to confirm the exception no longer appears.

For Velocity template errors, the Polarion server log contains the specific line number and expression that caused the failure. Always check the full stack trace before attempting configuration changes — the line number points directly to the problematic expression.

Browser Console Errors

Problem

The browser developer console shows errors such as “Uncaught Positive number expected” or similar JavaScript exceptions when loading or interacting with Risksheet.

Cause

Browser console errors during Risksheet usage may originate from three distinct sources:

Risksheet configuration — invalid column widths, formula syntax errors, or malformed cellDecorators
Polarion core JavaScript — not Risksheet-specific; appears on all Polarion pages
Third-party browser extensions — ad blockers, accessibility tools, or developer extensions interfering with the grid rendering

Resolution

Step 1: Open the browser developer console (press F12, then select the Console tab) and note the exact error messages. Step 2: Navigate to a non-Risksheet Polarion page (such as the project dashboard or a regular work item) and check if the same errors appear. If they do, the errors originate from Polarion itself, not Risksheet. Step 3: If errors only appear on Risksheet pages, check your risksheet.json for these common issues:

Configuration Area	What to Check	Example Fix
`columns[].width`	Width values must be positive integers	Change `"width": 0` to `"width": 80`
`formulas`	Formula syntax must be valid JavaScript expressions	Check for missing parentheses or undefined references
`cellDecorators`	Decorator functions must return valid style objects	Verify jQuery selectors target existing elements
`levels`	Level configuration must reference valid column bindings	Ensure `controlColumn` exists in `columns[]`
`headers.rowHeaderWidth`	Must be a positive number	Change `"rowHeaderWidth": -1` to `"rowHeaderWidth": 40`

Step 4: Try loading the page in a private/incognito browser window to rule out browser extension interference.

Isolate the Error Source First

The most effective diagnostic step is testing the same page in a different browser and checking whether errors appear on non-Risksheet pages. This immediately narrows whether the issue is Risksheet-specific, Polarion-wide, or browser-specific.

Cluster Node Inconsistency

Problem

In clustered Polarion deployments, the Risksheet configuration appears correctly on one cluster node but displays differently (wrong columns, old configuration, or missing data) on other nodes. Refreshing the page sometimes resolves the issue temporarily.

Cause

Configuration changes to risksheet.json may not immediately propagate across all nodes in a Polarion cluster. When a user’s request is routed to a node that has not yet synchronized the latest configuration, the stale version is displayed.

Resolution

Step 1: Refresh the page multiple times. Most cluster synchronization issues resolve within a few seconds to minutes as nodes synchronize. Step 2: If the issue persists, check the Polarion server logs on each cluster node for configuration loading errors. Step 3: Verify that all cluster nodes are running the same version of both Risksheet and Polarion. Step 4: If inconsistency continues after several minutes, restart the affected cluster node to force a full configuration reload.

Cluster synchronization timing depends on your Polarion cluster infrastructure. In most deployments, changes propagate within seconds. Persistent inconsistencies lasting more than five minutes typically indicate a node communication issue at the infrastructure level rather than a Risksheet problem.

Slow Loading from Broken Links

Problem

Risksheet pages take 60 seconds or more to load, with the browser showing a loading spinner for an extended period.

Cause

Unresolvable work item references (broken cross-project links, deleted items, or items in inaccessible projects) cause expensive UnresolvableObjectException processing in the GridItems data loading API. Each unresolvable reference can add 40+ seconds of delay per API call, compounding quickly with multiple broken links.

Resolution

Step 1: Check the Polarion server logs for UnresolvableObjectException errors. These entries identify which specific work items cannot be resolved:

Step 2: Open the risk items containing broken references in the Polarion work item tracker and remove or update the invalid links. Step 3: Reload the Risksheet page and verify improved load times.

Even a small number of unresolvable references can cause dramatic performance degradation. If your Risksheet has 10+ broken cross-project links, total load time can exceed several minutes. Prioritize cleaning up broken references whenever performance suddenly degrades after project restructuring or item deletion.

Problem

Header tooltip/helper text covers the column header area, making it difficult or impossible to access sort and filter buttons. Users cannot click the filter icon because the tooltip overlay is in the way.

Cause

In versions prior to 24.3.3, header tooltips (descriptions added to column headers via the description property) could overlap the sort and filter buttons, especially on narrow columns where space is limited.

Resolution

Preferred: Update Risksheet to version 24.3.3 or later, which fixes the tooltip positioning so it no longer blocks interactive header elements. Workaround for older versions: Widen the affected column by dragging the column border in the header row. A wider column provides enough space for both the tooltip text and the filter/sort buttons to coexist without overlap.

Post-Maintenance Activation Failure

Problem

After Polarion server maintenance (OS updates, storage migration, or cluster reconfiguration), Risksheet no longer activates in some or all projects. The grid may show partial rendering, fail to load entirely, or display work items in plain text format instead of the grid layout.

Cause

Server maintenance can disrupt several components that Risksheet depends on:

Plugin file permissions or paths may have changed
Cached configuration state may be stale or corrupted
Polarion and Risksheet version compatibility may be affected by patches applied during maintenance

Resolution

Step 1: Verify the Risksheet plugin files are still present in [POLARION_INSTALL]/polarion/extensions/. Step 2: Delete the configuration cache at [POLARION_INSTALL]/data/workspace/.config to force a fresh reload. Step 3: Restart Polarion services completely (not just a soft restart). Step 4: Navigate to Administration > Risksheet > Setup and verify the setup wizard shows a completed state. Step 5: Check the license status at Administration > Risksheet > License to confirm the license is still valid and activated.

After any server maintenance, verify the Risksheet setup in Administration even if no Risksheet-specific changes were made. Polarion updates applied during maintenance windows can affect plugin compatibility, requiring a Risksheet update to restore full functionality.

Enum Configuration Errors

Problem

A configuration error appears with a message like For input string: nice_to_have when loading a Risksheet document, particularly when using custom work item types.

Cause

This error occurs when enum values in the risksheet.json configuration do not match the enum option IDs defined in Polarion. The system attempts to parse a string enum value where it expects a numeric type, or references an enum ID that does not exist in the project’s enum definitions.

Resolution

Step 1: Open the risksheet.json configuration and locate the enums section. Step 2: Compare each enum id value against the actual enum option IDs in your Polarion project (Administration > Enumerations). Step 3: Correct any mismatches. Enum IDs in risksheet.json must exactly match the Polarion enum option IDs (case-sensitive):

{
  "enums": {
    "priority": [
      { "id": "critical", "name": "Critical" },
      { "id": "high", "name": "High" },
      { "id": "medium", "name": "Medium" },
      { "id": "low", "name": "Low" }
    ]
  }
}

Step 4: Also check the ratings section if your configuration uses risk assessment scales. The same ID-matching requirement applies:

{
  "ratings": {
    "severity": [
      { "id": "1", "name": "No Effect" },
      { "id": "2", "name": "Minor" },
      { "id": "3", "name": "Moderate" },
      { "id": "4", "name": "Significant" },
      { "id": "5", "name": "Critical" }
    ]
  }
}

When setting up FMEA with custom work item types (e.g., wit_failureMode, wit_measure), enum value mappings are a frequent source of configuration errors. Always verify that the dataTypes section references valid work item type IDs and that all enum definitions match Polarion exactly.

Verification

After resolving your rendering issue, you should now see:

The Risksheet grid loading within normal time (under 10 seconds for typical documents)
All configured columns displaying with correct data and formatting
No redirect to the space home page when navigating to Risksheet
No new UnsupportedOperationException or StringIndexOutOfBoundsException errors in server logs (on updated versions)
Consistent rendering across all cluster nodes after synchronization completes
Sort and filter buttons accessible in column headers without tooltip interference

​Rendering Issue Decision Table

​Diagnostic Flowchart

​Redirect to Space Home Page

​Problem

​Cause

​Resolution

​UnsupportedOperationException in Server Logs

​Problem

​Cause

​Resolution

​Velocity Template Errors

​Problem

​Cause

​Resolution

​Browser Console Errors

​Problem

​Cause

​Resolution

​Cluster Node Inconsistency

​Problem

​Cause

​Resolution

​Slow Loading from Broken Links

​Problem

​Cause

​Resolution

​Header Tooltip Overlap

​Problem

​Cause

​Resolution

​Post-Maintenance Activation Failure

​Problem

​Cause

​Resolution

​Enum Configuration Errors

​Problem

​Cause

​Resolution

​Verification

​See Also

Rendering Issue Decision Table

Diagnostic Flowchart

Redirect to Space Home Page

Problem

Cause

Resolution

UnsupportedOperationException in Server Logs

Problem

Cause

Resolution

Velocity Template Errors

Problem

Cause

Resolution

Browser Console Errors

Problem

Cause

Resolution

Cluster Node Inconsistency

Problem

Cause

Resolution

Slow Loading from Broken Links

Problem

Cause

Resolution

Header Tooltip Overlap

Problem

Cause

Resolution

Post-Maintenance Activation Failure

Problem

Cause

Resolution

Enum Configuration Errors

Problem

Cause

Resolution

Verification

See Also