Common Issues and Solutions
Empty Setup or License Pages
Symptom: After installing or updating Risksheet, the Setup and License pages in Administration are empty or fail to load.
Cause: Plugin caches were not cleared after the update.
Fix:
- Stop the Polarion server.
- Delete the
[POLARION_INSTALL]/data/workspace/.config directory.
- Restart the Polarion server.
- Navigate to Administration > Nextedy Risksheet > Setup to verify.
This is the most common post-installation issue. Delete [POLARION_INSTALL]/data/workspace/.config after every Risksheet installation or update.
- Check
[POLARION_INSTALL]/polarion/extensions/ for duplicate Risksheet folders. Delete the old version.
- Verify Administration > Topics includes the Risksheet topic for all relevant views and roles.
- If the
.metadata folder exists in the extensions directory, delete it.
UnsupportedOperationException in Server Logs
Symptom: Server logs show UnsupportedOperationException related to document field rendering (for example, renderingLayouts) when opening a Risksheet.
Cause: A known document field rendering issue, particularly after upgrading to Polarion 2310.
Fix: This error has no functional impact on Risksheet. The system skips failed fields and continues normally. Update to Risksheet 24.7.0+ to suppress these log entries.
Velocity Template Errors
Symptom: StringIndexOutOfBoundsException appears in server logs, possibly related to risksheetTopPanel.vm or other Velocity templates.
Cause: Misconfigured sheet configuration or custom Velocity template files.
Fix:
- Review your sheet configuration for syntax errors.
- Check any custom
risksheetTopPanel.vm template for malformed Velocity expressions.
- Validate JSON syntax using a JSON linter.
License Shows 0 Named Users
Symptom: The License page shows 0 named users despite users being in the nextedy_risksheet_users group.
Cause: Either the license needs to be refreshed, a service restart is required, or the user group name is wrong after a version upgrade.
Fix:
- Reopen the Administration > Nextedy Risksheet > License page.
- If still 0, restart the Polarion service.
- If both Risksheet and Powersheet are installed (v25.11.0+), create a
nextedy_powersheet_users group and add users to it.
If your team needs access to internal documentation, configure the settings.global.help property in your sheet configuration to point to your organization’s documentation URL. The default points to the official Nextedy support portal.
Verification
After resolving any of the above issues, you should now see the Risksheet administration pages loading correctly, the navigation menu appearing for all configured user roles, and the License page displaying the correct version and user counts.
See Also
