Views Architecture
View Selection Methods
| Method | Description |
|---|
| Menu | Access the views menu from the toolbar. Shows all configured views with a Selected indicator for the active view. |
| Dropdown | Quick dropdown selector showing view names for fast switching. |
| URL parameter | Append ?_view=<view-key> to the document URL to load a specific view directly. |
View Configuration
Views are defined in the views section of the sheet configuration:
views:
Without V&V:
columns:
validationTestCases.validationTestCase:
visible: false
systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
visible: false
View Properties
| Property | Type | Default | Description |
|---|
name (key) | string | (required) | Display name for this view, used in the selector |
columns | object | (required) | Column visibility overrides for this view |
columns.<binding>.visible | boolean | true | Set to false to hide a column in this view |
Base View
The base view is the default column configuration defined by the main columns section. It is always available.
| Behavior | Description |
|---|
| Default on load | Base view is shown when no URL parameter or default view is specified |
| Fallback | Invalid view keys in the URL fall back to the base view |
| Always available | Base view option is present in the selector unless a default view is defined |
Default View
One view can be marked as the default, overriding the base view on initial load:
| Behavior | Description |
|---|
| Overrides base view | When a default view is configured, it loads instead of the base view |
| Base view hidden | The base view menu option is hidden when a default view exists |
| URL override | The ?_view= URL parameter can override the default view |
The mechanism for marking a view as default may vary. Check your Powersheet version for the exact syntax.
URL Parameter Persistence
| Feature | Description |
|---|
| Parameter name | _view |
| Format | ?_view=<view-key> where view-key is a URL-friendly slug of the view name |
| Persistence | The URL updates when a view is selected, enabling bookmarking and sharing |
| Invalid keys | If the URL contains an invalid view key, the base view or default view is loaded |
Column Visibility Control
When a view is applied, column visibility is updated:
| Step | Description |
|---|
| 1 | The view’s column definitions are iterated |
| 2 | Each column is matched to the sheet columns by binding path |
| 3 | The visible property is set on the matched column |
| 4 | Columns not mentioned in the view retain their current visibility |
Cross-Document View Linking
Views can reference other documents, enabling switching between different document representations of related data:
| Feature | Description |
|---|
| Alternative documents | The views dropdown can show both views and linked documents |
| Document switching | Selecting a linked document navigates to that document’s powersheet |
Error Handling
| Scenario | Behavior |
|---|
| Invalid column binding in view | Column is silently skipped; view loads with valid columns |
| Non-existent properties | Does not block view loading; falls back to base view columns |
| Missing view in URL | Falls back to base view or configured default view |
Complete YAML Example
columns:
outlineNumber:
title: "#"
width: 60
title:
title: Title
width: "*"
severity:
title: Severity
width: 100
validationTestCases.validationTestCase:
title: Validation
width: 200
systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
title: Verification
width: 200
views:
Without V&V:
columns:
validationTestCases.validationTestCase:
visible: false
systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
visible: false
Verification Only:
columns:
validationTestCases.validationTestCase:
visible: false
severity:
visible: false
Related Pages
- Views — views YAML configuration reference
- Columns — column visibility and binding paths
- Column Sets — column groups and set management
- Toolbar — views selector location in the toolbar
Source: Views Configuration Guide KB article, alternative views test specifications, apply view command
Source Code
prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/cypress/e2e/Sheet/alternative-views.spec.tsmodel.yamlprod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/sheet/commands/applyView.tsprod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/sheet/commands/index.tsprod-powersheet-src/com.nextedy.powersheet.client/src/modules/ConfigProvider/ConfigProvider.tsx
