Skip to main content

​
Using Saved Views

Saved views are pre-configured column sets defined by administrators that let you quickly switch between different column layouts without manually selecting columns each time.

​
Define Saved Views in Configuration

Open the Configuration Editor (Menu > Configuration > Edit Risksheet Configuration) and add view definitions in the views section: 
"views": [
  {
    "name": "Potential Failures",
    "columnIds": [
      "item",
      "failureMode",
      "effect"
    ]
  },
  {
    "name": "No Mitigations",
    "columnIds": [
      "@all",
      "-task",
      "-taskTitle",
      "-taskStatus"
    ]
  }
]
View Definition Syntax:
  • Show specific columns only: List the column IDs you want visible
  • Show all except specific columns: Start with "@all", then prefix column IDs with - to hide them

​
Select a View

After defining views, users can select them from the dropdown in the RISKSHEET top panel:

​
Set a Default View

Starting with version 24.1.0, you can configure a default view that opens automatically: In Configuration: 
{
  "name": "Potential Failures",
  "defaultView": true,
  "columnIds": ["item", "failureMode", "effect"]
}
Dynamic Default Based on User Context: In risksheetTopPanel.vm, use Velocity scripting to set the default view based on current user, role, or other context: 
<script>
#foreach($r in $securityService.getRolesForUser($securityService.getCurrentUser()))
  #if($r.equals("admin"))
    risksheet.appConfig.views[1].defaultView=true;
  #end
#end
</script>
For Risksheets with 30+ columns, create task-specific views rather than showing all columns. For example: “Risk Assessment” (only severity/occurrence/detection), “Mitigation Review” (only mitigation columns), and “Full View” (all columns).

​
Using the Column Selector

For one-time column visibility changes without pre-configured views, use the interactive column selector:
  1. Click the Menu icon ☰ in the RISKSHEET toolbar
  2. Select Select Visible Table Columns
  3. Check/uncheck columns in the dialog
  4. Click Apply
diagram
Changes made through Select Visible Table Columns apply only to your current session. If you need persistent column layouts that survive page refreshes, use saved views instead.

​
Conditional Column Visibility with Cell Decorators

For advanced scenarios where column editability depends on work item field values, use cell decorators to dynamically control the readonly state: 
function conditionalReadonly(info) {
  if (info.item['enableLinking'] === 'no') {
    if (!info.systemReadOnlyFields) {
      info.systemReadOnlyFields = [];
    }
    info.systemReadOnlyFields.push('linkedItem');
  }
}
Reference this decorator in your column configuration: 
{
  "id": "linkedItem",
  "header": "Linked Item",
  "bindings": "linkedItem",
  "type": "itemLink",
  "cellDecorator": "conditionalReadonly"
}
The column-level readOnly property makes a column non-editable for all users. Cell decorators provide row-level control, making cells readonly based on item data. This enables workflows where editability depends on item state.

​
Verification

After configuring saved views, you should see:
  • View selector dropdown in the RISKSHEET top panel with your defined view names
  • Clicking a view name immediately shows/hides columns according to the configuration
  • If you set a defaultView, that view loads automatically when opening the RISKSHEET
After using the column selector, you should see:
  • Only the checked columns visible in the grid
  • Hidden columns removed from the display until you check them again or refresh the page

​
See Also

KB ArticlesSupport TicketsSource Code
  • ToggleReviewCommand.ts
  • ResetColumnsCommand.ts
  • AppConfig.ts
  • SaveColumnsCommand.ts
  • ColumnsHelper.ts