URL Parameter Structure
RISKSHEET URLs follow this pattern:
https://<server>/polarion/risksheet/view?project=<projectId>&document=<documentId>&revision=<revisionId>&comparingTo=<baselineRevision>&view=<viewName>
Core Parameters
Document Navigation
Parameter Type Required Description Example projectstring Yes Polarion project ID where the document resides ?project=MyProjectdocumentstring No Wiki document ID to open (default: uses context from page) ?document=MyFolder/MyRisksheetspacestring No Document space prefix for multi-space projects ?space=default
Revision Control
Parameter Type Required Description Example revisionstring No Specific document revision to view (empty = current/head) ?revision=20250210_120000comparingTostring No Baseline revision to compare against (activates comparison mode) ?comparingTo=20250101_000000
View Configuration
Parameter Type Required Description Example viewstring No Name of saved view to display on load ?view=Risk%20Assessmentsearchstring No Initial search/filter query for work items ?search=severity%3DHighselectedItemstring No Item ID to select/focus on load ?selectedItem=ITEM-001
Parameter Encoding
URL parameters must be properly encoded:
Character Encoded Example Space %20 or +Risk%20AssessmentSlash %2FFolder%2FRisksheetAmpersand %26criteria%26statusEquals %3Dseverity%3DHighPipe %7Citem%7Cstatus
Common URL Patterns
Open Current Document in Current Project
https://server/polarion/risksheet/view
No parameters needed if accessing from within a Polarion document context.
Open Specific Document
https://server/polarion/risksheet/view?project=Safety&document=FMEA/SystemFailures
View Historical Revision
https://server/polarion/risksheet/view?project=Safety&document=FMEA/SystemFailures&revision=20250101_120000
When viewing a historical revision:
The RISKSHEET displays in read-only mode
All editing is disabled
No save button appears
The document state reflects the point in time of that revision
Compare Two Revisions (Side-by-Side Diff)
https://server/polarion/risksheet/view?project=Safety&document=FMEA/SystemFailures&revision=20250210_120000&comparingTo=20250101_000000
Comparison mode shows:
Added items : Green background (new in current revision)
Removed items : Red background (deleted in baseline)
Modified items : Yellow background (changed properties)
Unchanged items : Normal display (no changes)
Load Specific Saved View
https://server/polarion/risksheet/view?project=Safety&document=FMEA/SystemFailures&view=Risk%20Assessment
The saved view named “Risk Assessment” displays on load, showing only its configured columns.
Deep Link with Search
https://server/polarion/risksheet/view?project=Safety&document=FMEA/SystemFailures&search=severity%3DCritical
Filters displayed items based on the search query on load.
URL State Flow Diagram
Revision IDs in Polarion use timestamps:
Position Value Description 1-4 YYYY Year (4 digits) 5-6 MM Month (01-12) 7-8 DD Day (01-31) 10-11 HH Hours (00-23) 12-13 MM Minutes (00-59) 14-15 SS Seconds (00-59)
Example: 20250210_120000 = February 10, 2025 at 12:00:00
Example: 20250210_120000 = February 10, 2025 at 12:00:00
Comparison Mode Behavior
Visual Indicators
State Color CSS Class Meaning Added Green comparison-addedItem exists in current but not baseline Removed Red comparison-removedItem exists in baseline but not current Modified Yellow comparison-modifiedItem properties changed Unchanged Normal — No changes between versions
User Actions in Comparison Mode
Action Allowed? Notes Edit cells No All cells are read-only in comparison mode Create rows No Cannot add new items while comparing Delete rows No Cannot remove items while comparing Toggle ‘Show Unchanged’ Yes Filter to see only changed items Exit comparison Yes Click comparison toolbar button to exit
When exiting comparison mode, the URL parameter comparingTo is removed. The RISKSHEET returns to normal editing mode for the current revision.
Read-Only Mode Triggers
The RISKSHEET automatically enters read-only mode when:
Viewing a historical revision : ?revision=<pastDate> (not current revision)
Configuration specifies readonly : "readonly": true in config
User lacks edit permissions : Polarion permission check
Comparison mode active : ?comparingTo=<baseline>
Document is locked/approved : Workflow state prevents edits
Sharing and Bookmarking
Share Current State
Copy the current URL from the browser address bar:
https://server/polarion/risksheet/view?project=MyProject&document=MyFolder/MyRisksheet&view=Risk%20Assessment
This URL preserves:
Project and document
Selected saved view
Current scroll/selection (via focus parameter, if supported)
Share a Specific Revision
https://server/polarion/risksheet/view?project=MyProject&document=MyFolder/MyRisksheet&revision=20250101_000000
Recipients can review historical state without worrying about concurrent edits.
Share a Comparison
https://server/polarion/risksheet/view?project=MyProject&document=MyFolder/MyRisksheet&revision=20250210_000000&comparingTo=20250101_000000
Recipients see the exact differences between two revisions.
API URL Construction
The RISKSHEET internally constructs API URLs based on parameters:
Use URL Template Example Data fetch /api/v2/projects/<project>/risks/<document>/api/v2/projects/MyProject/risks/FMEA%2FSystemRevision data /api/v2/projects/<project>/risks/<document>?rev=<revision>...?rev=20250101_000000Comparison query /api/v2/projects/<project>/risks/<document>/comparison?baseline=<comparingTo>...?baseline=20250101_000000
Special Parameters
Debug Parameter
Enables debug logging in the browser console. Useful for troubleshooting:
Configuration loading
Data fetch errors
Query execution
Editor behavior
Embedded/IFrame Mode
When RISKSHEET is embedded in a Polarion page via iframe, parameters are passed through the iframe src attribute:
< iframe src = "/polarion/risksheet/view?project=MyProject&document=MyDoc" ></ iframe >
Browser Compatibility
Browser Version Support Notes Chrome 90+ Full URL length limit ~2000 chars Firefox 88+ Full URL length limit ~2000 chars Safari 14+ Full URL length limit ~2000 chars Edge 90+ Full URL length limit ~2000 chars IE 11 — None Not supported
Browser URL length limits are approximately 2000 characters. Complex queries with many filter criteria may exceed this. Use URL shortener services or bookmark complex RISKSHEET states instead.
Related Pages
Source Code
ShowConfigurationCommand.ts
AppConfig.ts
AppConfigParser.ts
SheetConstants.ts
NewBaselineCommand.ts