Overview
Saved views are managed in the RISKSHEET configuration and define which columns are visible when a view is selected. Unlike the ‘Select Visible Columns’ feature (which allows individual users to control visibility in real-time), saved views are predefined by administrators and provide preset configurations for common tasks.Saved Views (admin-configured, reusable presets) differ from Column Visibility Preferences (user-controlled, per-session toggles). Use saved views for standardized team workflows; use column visibility for temporary personal adjustments.
Configuration Structure
Views Property
| Property | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name shown in the saved views selector dropdown |
columnIds | array | Yes | Array of column IDs that should be visible in this view |
defaultView | boolean | No | If true, this view loads automatically when opening the Risksheet (default: false) |
Column ID Syntax
ThecolumnIds array supports two syntaxes:
Inclusive: List specific column IDs to show
@all to show all columns, then prefix column IDs with - to hide them
Configuration Example
Saved Views Selection Diagram
Use Cases
Use Case 1: Failure Mode View
For FMEA analysis teams reviewing potential failures:Use Case 2: Mitigation Planning
For teams assigning and tracking mitigation tasks:Use Case 3: Risk Review
For stakeholder review with executive summary metrics:Setting Default View
Configuration Method
Add"defaultView": true to the view definition in the configuration:
Script Method
Set the default view dynamically inrisksheetTopPanel.vm using Velocity Template Language:
Conditional Default View
Use Polarion APIs to set default views based on user role:User Interaction
Selecting a Saved View
- Click the View Selector dropdown in the RISKSHEET toolbar (appears by default when views are configured)
- Select a view name from the list
- The RISKSHEET immediately displays only the columns specified for that view
- Selected view choice persists during the current session
Switching Between Views
Users can switch between views multiple times without saving:- Click the view selector dropdown
- Choose a different view
- Current row selection and scroll position may reset depending on column changes
Column Visibility vs. Saved Views
| Feature | Saved Views | Select Visible Columns |
|---|---|---|
| Defined by | Administrator | Individual user |
| Persistence | Reusable across sessions | Per-session only |
| Preset configs | Yes (multiple predefined) | No (manual each time) |
| Edit capability | Requires config edit | Yes, real-time toggle |
| Use for | Standard workflows | Temporary adjustments |
Version Support
| Feature | Introduced | Notes |
|---|---|---|
| Saved views (basic) | 23.0 | name and columnIds properties |
| Default view | 24.1.0 | defaultView property and script methods |
Exclusive syntax (@all, -columnId) | 23.0 | Supported from initial release |
| Dynamic view selection (scripts) | 24.1.0 | Set default views based on user context |
Configuration Best Practices
When switching views, the RISKSHEET may trigger a refresh depending on the
refreshOnSave configuration property. Unsaved changes may be lost if the refresh occurs before saving.Limitations
- Personal views not supported: Each user cannot create their own saved views. Only administrators can define saved views in the configuration.
- No sorting/filtering persistence: Saved views control column visibility only; they do not save sort order, filters, or row selections.
- One default view: Only one view can be marked as the default view; if multiple views have
defaultView: true, the first one wins. - Column-level only: Saved views cannot hide individual data types or rows; they control which columns are visible in all rows.
Related Pages
- Configuration System — How configuration is structured and applied
- Create Saved Views Guide — Step-by-step guide for administrators
- Configuration Properties Index — Complete property reference
- Keyboard Shortcuts — Shortcut keys including view navigation
Sources
Sources
KB ArticlesSupport TicketsSource Code
CommandFactory.tsAppConfig.ts