Configuration Property
| Property | Type | Default | Description |
|---|---|---|---|
views | array | [] | Array of view definition objects, each specifying a named column visibility preset |
View Object Properties
| Property | Type | Default | Description |
|---|---|---|---|
name | string | Required | Display name shown in the view selector dropdown |
columns | array | Required | Array of column IDs that are visible when this view is active |
Location in Configuration
Theviews property is a top-level array within risksheet.json:
Behavior
View Switching
When a user selects a saved view from the view selector in the Risksheet toolbar, the grid immediately updates to show only the columns listed in that view’scolumns array. All other columns are hidden. The data itself is unchanged — only column visibility is affected.
Default State
When no view is selected (or the page is first loaded), all columns defined in thecolumns configuration array are visible. Selecting a view narrows visibility to the specified subset.
Column ID Matching
Thecolumns array in a view must contain valid column id values that match columns defined in the top-level columns configuration. If a view references a column ID that does not exist, that entry is silently ignored.
Persistence Behavior
| Feature | Persistence |
|---|---|
| Saved view definitions | Stored in risksheet.json, persists across sessions |
| Currently selected view | Resets on page reload |
Column group collapse state (collapseTo) | Not persisted across page reloads |
| ”Select visible columns” user selections | Persisted on the user’s computer (browser storage) |
The “Select visible columns” feature provides a separate mechanism for users to hide or show individual columns. This selection persists on the user’s computer through browser local storage. However, switching to a saved view overrides the user’s column visibility selections. The two mechanisms operate independently but saved views take precedence when activated.
Complete Example
A FMEA configuration with three views for different analysis phases:View Descriptions
Risk Identification — Focused on initial risk analysis. Shows the failure mode structure (function, mode, effect, cause) and initial severity/occurrence/detection ratings with the calculated RPN. Hides mitigation tracking and review columns. Mitigation Tracking — Focused on action item management. Shows the risk identity (ID, title, failure mode) alongside the initial RPN, mitigation assignments, responsible persons, due dates, and revised ratings. Hides the detailed failure analysis columns. Review Status — Focused on review progress. Shows risk identity with both initial and revised RPN values, work item status, review status, and the responsible person. Hides detailed failure analysis and mitigation assignment columns.Column Visibility Interaction
Saved views interact with several other column visibility mechanisms in Risksheet:| Mechanism | Scope | Persistence | Priority |
|---|---|---|---|
Saved views (views) | All users, admin-defined | Configuration file | Highest when active |
| ”Select visible columns” | Per user, user-controlled | Browser local storage | Overridden by saved views |
Column visible property | All users, admin-defined | Configuration file | Base visibility |
Column group collapseTo | Per user interaction | Not persisted | Resets on page reload |
visible property on each column and the user’s “Select visible columns” preferences determine what is shown.
Use Cases
Role-Based Views
Configure views that match the information needs of different team members working on the same risk document:Analysis Phase Views
Configure views for sequential phases of risk analysis work:HARA-Specific Views
For HARA (Hazard Analysis and Risk Assessment) configurations following ISO 26262:Limitations
- No personal views: Users cannot create their own saved views through the UI. All views must be defined by an administrator in
risksheet.json. - No filter persistence: Saved views control only column visibility. They do not save row filter states, sort orders, or scroll positions.
- View selection resets on reload: The currently selected view is not remembered between page loads. Users must re-select their preferred view each time they open the document.
- Exclusive column sets: When a view is active, only the columns listed in that view are visible. There is no mechanism to additively show extra columns on top of a view.
Related Configuration
- Risksheet.json Format — Column definitions referenced by view column IDs
- Configuration Properties Index — Global settings that affect the view selector display
- Column Type Reference — Column type definitions
- Create Saved Views — Step-by-step guide for configuring views
- Control Column Visibility — Alternative visibility mechanisms
Sources
Sources
KB ArticlesSupport TicketsSource Code
CommandFactory.tsAppConfig.ts