Skip to main content

Configuration Property

PropertyTypeDefaultDescription
viewsarray[]Array of view definition objects, each specifying a named column visibility preset
Each view object in the array defines which columns are visible when that view is selected.

View Object Properties

PropertyTypeDefaultDescription
namestringRequiredDisplay name shown in the view selector dropdown
columnsarrayRequiredArray of column IDs that are visible when this view is active

Location in Configuration

The views property is a top-level array within risksheet.json:
{
  "columns": [ ... ],
  "dataTypes": { ... },
  "views": [
    {
      "name": "View Name",
      "columns": ["col1", "col2", "col3"]
    }
  ]
}

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’s columns 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 the columns configuration array are visible. Selecting a view narrows visibility to the specified subset.

Column ID Matching

The columns 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. diagram

Persistence Behavior

Saved views are defined by administrators in risksheet.json and apply to all users of the document. Individual users cannot create, modify, or delete saved views through the UI. Saved views are shared presets, not personal configurations.
FeaturePersistence
Saved view definitionsStored in risksheet.json, persists across sessions
Currently selected viewResets on page reload
Column group collapse state (collapseTo)Not persisted across page reloads
”Select visible columns” user selectionsPersisted 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:
{
  "columns": [
    { "id": "systemItemId", "header": "ID", "binding": "systemItemId", "type": "string" },
    { "id": "title", "header": "Title", "binding": "title", "type": "string" },
    { "id": "function", "header": "Function", "binding": "linkedItem", "type": "itemLink" },
    { "id": "failureMode", "header": "Failure Mode", "binding": "title", "type": "string", "level": 2 },
    { "id": "effect", "header": "Effect", "binding": "customField1", "type": "string" },
    { "id": "cause", "header": "Cause", "binding": "customField2", "type": "string" },
    { "id": "sev", "header": "S", "binding": "severity", "type": "rating" },
    { "id": "occ", "header": "O", "binding": "occurrence", "type": "rating" },
    { "id": "det", "header": "D", "binding": "detection", "type": "rating" },
    { "id": "rpn", "header": "RPN", "binding": "rpn", "type": "int", "formula": "commonRpn" },
    { "id": "mitigation", "header": "Mitigation", "binding": "linkedTask", "type": "taskLink" },
    { "id": "responsible", "header": "Responsible", "binding": "assignee", "type": "ref" },
    { "id": "dueDate", "header": "Due Date", "binding": "dueDate", "type": "date" },
    { "id": "sevNew", "header": "S (new)", "binding": "severityNew", "type": "rating" },
    { "id": "occNew", "header": "O (new)", "binding": "occurrenceNew", "type": "rating" },
    { "id": "detNew", "header": "D (new)", "binding": "detectionNew", "type": "rating" },
    { "id": "rpnNew", "header": "RPN (new)", "binding": "rpnNew", "type": "int", "formula": "commonRpnNew" },
    { "id": "status", "header": "Status", "binding": "status", "type": "enum" },
    { "id": "reviewStatus", "header": "Review", "binding": "reviewsRendered", "type": "string" }
  ],
  "views": [
    {
      "name": "Risk Identification",
      "columns": ["systemItemId", "title", "function", "failureMode", "effect", "cause", "sev", "occ", "det", "rpn"]
    },
    {
      "name": "Mitigation Tracking",
      "columns": ["systemItemId", "title", "failureMode", "rpn", "mitigation", "responsible", "dueDate", "sevNew", "occNew", "detNew", "rpnNew"]
    },
    {
      "name": "Review Status",
      "columns": ["systemItemId", "title", "failureMode", "rpn", "rpnNew", "status", "reviewStatus", "responsible"]
    }
  ],
  "formulas": {
    "commonRpn": "function(info){ var value = info.item['occ']*info.item['det']*info.item['sev']; return value?value:null;}",
    "commonRpnNew": "function(info){ var value = info.item['occNew']*info.item['detNew']*info.item['sevNew']; return value?value:null; }"
  }
}

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:
MechanismScopePersistencePriority
Saved views (views)All users, admin-definedConfiguration fileHighest when active
”Select visible columns”Per user, user-controlledBrowser local storageOverridden by saved views
Column visible propertyAll users, admin-definedConfiguration fileBase visibility
Column group collapseToPer user interactionNot persistedResets on page reload
When a saved view is activated, it overrides all other column visibility settings. When no saved view is selected, the base 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:
{
  "views": [
    {
      "name": "Safety Engineer",
      "columns": ["systemItemId", "title", "failureMode", "cause", "effect", "sev", "occ", "det", "rpn", "mitigation"]
    },
    {
      "name": "Project Manager",
      "columns": ["systemItemId", "title", "rpn", "rpnNew", "responsible", "dueDate", "status"]
    },
    {
      "name": "Auditor",
      "columns": ["systemItemId", "title", "failureMode", "sev", "occ", "det", "rpn", "sevNew", "occNew", "detNew", "rpnNew", "status", "reviewStatus"]
    }
  ]
}

Analysis Phase Views

Configure views for sequential phases of risk analysis work:
{
  "views": [
    {
      "name": "1 - Structure Analysis",
      "columns": ["systemItemId", "function", "failureMode", "cause", "effect"]
    },
    {
      "name": "2 - Risk Assessment",
      "columns": ["systemItemId", "failureMode", "sev", "occ", "det", "rpn"]
    },
    {
      "name": "3 - Optimization",
      "columns": ["systemItemId", "failureMode", "rpn", "mitigation", "responsible", "dueDate", "sevNew", "occNew", "detNew", "rpnNew"]
    }
  ]
}

HARA-Specific Views

For HARA (Hazard Analysis and Risk Assessment) configurations following ISO 26262:
{
  "views": [
    {
      "name": "Hazard Identification",
      "columns": ["systemItemId", "hazard", "operatingMode", "hazardousEvent", "severity", "exposure", "controllability"]
    },
    {
      "name": "ASIL Classification",
      "columns": ["systemItemId", "hazardousEvent", "severity", "exposure", "controllability", "asil", "safetyGoal"]
    }
  ]
}

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.
While saved views handle column visibility, personal filters (available since version 24.8.1) allow individual users to set row-level filters that persist between sessions. Combining saved views with personal filters gives users a consistent, customized experience for their daily workflow.
KB ArticlesSupport TicketsSource Code
  • CommandFactory.ts
  • AppConfig.ts