Skip to main content

Diagnostic Steps

Start by identifying the symptom:
SymptomLikely Cause
Blank white screenJSON parse error
”Loading…” foreverQuery timeout
Red error bannerMissing config
Partial load (no data)Link role mismatch
403 ForbiddenPermission issue

Solution 1: Validate Risksheet JSON Configuration

Invalid JSON syntax prevents risksheet from initializing.
  1. Navigate to your risksheet document in Polarion (e.g., Risks/HAZID)
  2. Click Attachments tab
  3. Download risksheet.json to your local machine
  4. 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"
  1. 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).
  1. If validation fails, compare against a working template from RiskTemplates space
  2. Re-upload the corrected risksheet.json file
  3. Refresh the risksheet document page
Copy a working risksheet.json from RiskTemplates/HARATemplate or RiskTemplates/DFMEATemplate and modify incrementally. Templates are guaranteed syntactically valid.

Solution 2: Check Work Item Query Performance

Slow queries cause timeouts on large datasets.
  1. Open the risksheet.json configuration
  2. Locate the "query" property (usually near top of JSON)
  3. Copy the Lucene query string (e.g., "type:failureMode AND module.id:Risks/HAZID")
  4. Test query performance in Polarion’s Search interface
  5. 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.
  1. Open risksheet.json and review columns[] array
  2. 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
  3. 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
  4. 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"
  5. 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.
  1. Chrome/Edge: Press Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
  2. Select Time range: Last 7 days
  3. Check Cached images and files and Cookies and site data
  4. Click Clear data
  5. Close all Polarion tabs
  6. Reopen Polarion and navigate to risksheet document
  7. 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.
  1. Open risksheet document that’s failing to load
  2. Press F12 to open Developer Tools
  3. Click Console tab
  4. Look for red error messages
  5. Common errors and fixes:
Error MessageCauseFix
Cannot read property 'id' of undefinedQuery returned no itemsCheck query filter matches work items
XMLHttpRequest CORS errorCross-origin security blockContact admin to check Polarion CORS config
Uncaught SyntaxError in risksheet.jsonJSON parse failureValidate and fix JSON syntax (Solution 1)
Failed to load resource: 403Permission denied on work itemsCheck user has read access to module
wijmo.grid is not definedMissing Wijmo libraryClear cache (Solution 4) or contact admin
  1. Screenshot the console output if error is unclear
  2. Share with your Polarion administrator for advanced troubleshooting

Solution 6: Verify User Permissions

Insufficient permissions cause blank screens or 403 errors.
  1. Navigate to the risksheet module (e.g., Risks/HAZID)
  2. Check you can see work items in Document view (not risksheet)
  3. 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
  4. 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