Understanding Configuration Storage
RISKSHEET configuration is stored inrisksheet.json files attached to Polarion documents. The system searches for configuration in a specific hierarchy:
Locating Document-Level Configuration
Check Document Attachments
- Open your Risksheet document (LiveDoc) in Polarion
- Navigate to the Attachments section at the bottom of the page
- Look for a file named
risksheet.json - If present, this configuration takes precedence over template and built-in configurations
View Configuration Source
- Open your Risksheet
- Go to Menu > Configuration > Edit Risksheet Configuration…
- The editor toolbar shows the configuration source:
- From Template: Displays template document name if inherited
- Document-Specific: Indicates configuration is attached directly to the document
- Built-In: Shows when using default configuration
Locating Template-Level Configuration
Find the Template Document
- Open your Risksheet document in Polarion
- View the document’s Custom Fields section
- Find the templateDoc custom field
- The value shows the path to the template document (e.g.,
Risks/Risk Specification) - Navigate to that document in Polarion’s document browser
Check Template Attachments
- Open the template document identified above
- Navigate to the Attachments section
- Look for
risksheet.json - This configuration is shared by all Risksheets using this template
Configuration File Paths Reference
| Configuration Level | File Location | Scope |
|---|---|---|
| Document-specific | Document attachments: risksheet.json | Single Risksheet document |
| Template-based | Template document attachments: risksheet.json | All documents using this template |
| Built-in | Plugin internal resources | All Risksheets without custom config |
Identifying Active Configuration
Using the Configuration Editor
The Configuration Editor (version 25.5.0+) provides visual indicators:- Open Menu > Configuration > Edit Risksheet Configuration…
- Check the tab title:
- Shows template name if configuration is inherited
- Shows document name if configuration is document-specific
- Review the config history panel to see when configuration was last modified
- The YAML mode displays the complete active configuration regardless of source
Checking Server Logs
For troubleshooting configuration loading issues in multi-node environments:- Open the Risksheet
- Go to Menu > Configuration > Edit Risksheet Configuration…
- Check Polarion server logs (
polarion/log/log.txt) - Search for entries containing:
DocumentConfigProviderrisksheet.json- Configuration file path resolution messages
Common Configuration Issues
Configuration Not Loading
Symptom: Changes torisksheet.json don’t appear in the Risksheet
Resolution:
- Verify the file is named exactly
risksheet.json(case-sensitive) - Check that the file is attached to the correct document or template
- Clear browser cache and reload the Risksheet
- Verify the templateDoc custom field points to the correct template
Multiple Versions Causing Conflicts
Symptom: Unexpected configuration behavior or partial settings Resolution:- Check if both document and template have
risksheet.jsonattachments - Remember document-level configuration overrides template configuration completely (no merging)
- Use Override Template only when full customization is needed
Template Changes Not Reflected
Symptom: Templaterisksheet.json updates don’t affect existing Risksheets
Resolution:
- Verify the Risksheet document doesn’t have its own
risksheet.jsonattachment - If document-level configuration exists, remove it or use Revert to Template option
- Refresh the Risksheet after template changes
Verification
You should now be able to:- Locate the active
risksheet.jsonfile for any Risksheet - Determine whether configuration is document-level or template-level
- Identify the template document path from custom fields
- Use the Configuration Editor to view configuration source
See Also
- Use the Configuration Editor - Edit configuration through the UI
- Override Template Configuration - Switch between template and document-specific configuration
- Set Up Global Templates - Create reusable configuration templates
- Configuration System - Understand configuration architecture
- Configuration Hierarchy - Learn how configuration inheritance works
- Risksheet.json Format - Configuration file structure reference
Sources
Sources
KB ArticlesSupport TicketsSource Code
DocumentConfigProvider.javaPdfExportConfigurationService.javaRisksheetViewServlet.javaAppConfigParser.tsPolarionAppConfigManager.java