Diagnostic Steps
Start by identifying the symptom:
| Symptom | Likely Cause |
|---|
| Blank white screen | JSON parse error |
| ”Loading…” forever | Query timeout |
| Red error banner | Missing config |
| Partial load (no data) | Link role mismatch |
| 403 Forbidden | Permission issue |
Solution 1: Validate Risksheet JSON Configuration
Invalid JSON syntax prevents risksheet from initializing.
- Navigate to your risksheet document in Polarion (e.g.,
Risks/HAZID)
- Click Attachments tab
- Download
risksheet.json to your local machine
- Validate JSON syntax using an online validator or command line:
# macOS/Linux validation
python3 -m json.tool risksheet.json > /dev/null && echo "Valid JSON" || echo "Invalid JSON"
- Common JSON errors to fix:
- Trailing commas in arrays or objects
- Unescaped quotes in string values
- Missing closing brackets
} or ]
- Duplicate property keys in same object
Formulas in columns[] use JavaScript syntax but must be JSON-escaped. Wrong: "formula": "item.sev * item.occ". Right: "formula": "item.sev * item.occ" (quotes already escaped in JSON strings, but watch for single quotes which need escaping).
- If validation fails, compare against a working template from
RiskTemplates space
- Re-upload the corrected
risksheet.json file
- Refresh the risksheet document page
Copy a working risksheet.json from RiskTemplates/HARATemplate or RiskTemplates/DFMEATemplate and modify incrementally. Templates are guaranteed syntactically valid.
Slow queries cause timeouts on large datasets.
- Open the risksheet.json configuration
- Locate the
"query" property (usually near top of JSON)
- Copy the Lucene query string (e.g.,
"type:failureMode AND module.id:Risks/HAZID")
- Test query performance in Polarion’s Search interface
- If search takes >10 seconds or returns >500 items, optimize:
- Add
module.id filter to limit scope: module.id:Risks/SFMEA
- Use enum filters instead of text search:
classification:(sc OR cc) instead of title:*safety*
- Split large documents into separate modules by system element
Never use type:failureMode alone without module or project scope. This loads ALL failure modes across all spaces, causing 30+ second timeouts on projects with 1000+ items.
Solution 3: Verify Column Configuration
Missing custom fields or link roles break column rendering.
-
Open
risksheet.json and review columns[] array
-
For each column with
"property" (custom field):
{"id": "sev", "property": "fmeaSeverity", "title": "S"}
Verify the custom field exists: Navigate to Administration → Work Items → Custom Fields and search for fmeaSeverity
-
For each column with
"role" (link role):
{"id": "rc", "dataType": "task", "role": "mitigates", "title": "Risk Control"}
Verify the link role exists: Administration → Work Items → Link Roles and confirm mitigates is defined
-
Check field type compatibility:
- Enum fields require
"dataType": "string" and optional "pickerType": "enum"
- Link columns require
"dataType": "task" or "workItem" and "role": "linkRoleName"
- Calculated columns use
"formula": "JavaScript expression"
-
If field or role is missing, either:
- Add it via Administration interface
- Remove the column from risksheet.json
- Replace with correct field/role name
Solution 4: Clear Browser Cache and Cookies
Stale JavaScript or CSS causes rendering errors.
- Chrome/Edge: Press
Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
- Select Time range: Last 7 days
- Check Cached images and files and Cookies and site data
- Click Clear data
- Close all Polarion tabs
- Reopen Polarion and navigate to risksheet document
- Force refresh:
Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
Open risksheet in incognito/private browsing mode. If it works there but not in normal mode, cache is the culprit.
Solution 5: Check JavaScript Console for Errors
Browser console reveals hidden errors.
- Open risksheet document that’s failing to load
- Press
F12 to open Developer Tools
- Click Console tab
- Look for red error messages
- Common errors and fixes:
| Error Message | Cause | Fix |
|---|
Cannot read property 'id' of undefined | Query returned no items | Check query filter matches work items |
XMLHttpRequest CORS error | Cross-origin security block | Contact admin to check Polarion CORS config |
Uncaught SyntaxError in risksheet.json | JSON parse failure | Validate and fix JSON syntax (Solution 1) |
Failed to load resource: 403 | Permission denied on work items | Check user has read access to module |
wijmo.grid is not defined | Missing Wijmo library | Clear cache (Solution 4) or contact admin |
- Screenshot the console output if error is unclear
- Share with your Polarion administrator for advanced troubleshooting
Solution 6: Verify User Permissions
Insufficient permissions cause blank screens or 403 errors.
-
Navigate to the risksheet module (e.g.,
Risks/HAZID)
-
Check you can see work items in Document view (not risksheet)
-
If document is empty, you lack read permissions:
- Contact project administrator
- Request Read permission for the
Risks space
- Request membership in project role with work item access
-
Check risksheet widget permissions:
- Navigate to Project → Properties → Permissions
- Verify your role has Risksheet Widget access enabled
Even if you have project access, individual documents can have restricted permissions. Check Document → Properties → Permissions tab.
Verification
After applying fixes, you should see:
- Risksheet loads within 5 seconds
- Data grid displays with all configured columns
- Work items populate rows (no “Loading…” spinner stuck)
- Clicking cells allows inline editing (if permissions allow)
- Traffic lights indicator (if configured) shows colored status lights in top-right corner
- No red error messages in browser console
If risksheet still fails after all solutions, gather this diagnostic data for support:
- Browser and version (Chrome 120, Firefox 115, etc.)
- Polarion version (check Help → About)
- Screenshot of browser console errors (F12 → Console tab)
- Copy of risksheet.json configuration (sanitize sensitive data)
- Lucene query from risksheet.json and result count from Search interface
See Also