Skip to main content
See also: Columns | Column Groups | Views Selector

​
Views Structure

diagram

​
View Properties

NameTypeDefaultDescription
<ViewName>object—Top-level key is the view name displayed to users in the views selector.
columnsobjectNoneColumn visibility overrides for this view. Keys are binding paths matching column definitions.
columns.<binding>.visiblebooleantrueSet to false to hide the column in this view.

​
Defining Views

Views are defined in the top-level views section. Each view name becomes the label in the views selector UI: 
views:
  Without V&V:
    columns:
      validationTestCases.validationTestCase:
        visible: false
      systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
        visible: false
In this example, the “Without V&V” view hides the validation and verification test case columns while keeping all other columns visible.
Views only need to list columns that differ from the default state. Columns not mentioned in a view remain at their default visible setting from the columns section.

​
Base View

The base view is the default column configuration defined by the columns section. It shows all columns at their configured visible state. The base view is always available as a fallback.
BehaviorDescription
No view selectedBase view is active, showing all columns at their default visibility.
Invalid view requestedFalls back to the base view.
View clearedReturns to the base view.

​
Default View

One view can be marked as the default view, which loads automatically instead of the base view when no URL parameter is present:
The mechanism for marking a view as the default may vary by version. When a default view is configured, the base view option may be hidden from the menu.

​
View Selection Methods

Users can switch views through:
MethodDescription
MenuAccess via the alternative views menu item. Shows current selection with a “Selected” indicator.
DropdownQuick-access dropdown selector showing all available views.
URL parameterDirect URL access using ?_view=<view-key>. Enables bookmarking and sharing specific views.

​
URL Parameter

The active view persists in the URL as the _view parameter: 
/polarion/nx_databridge/document?_view=without-v-v
ScenarioURL Behavior
View selected_view=<slugified-view-name> added to URL.
View cleared_view parameter removed from URL.
Invalid _view parameterFalls back to base view or default view.

​
View-Specific Column Visibility

Each view can independently control which columns are visible. Views can completely hide entity-level columns or selectively hide specific columns while keeping data accessible: 
views:
  Requirements Only:
    columns:
      systemRequirements.systemRequirement.designRequirements.designRequirement:
        visible: false
      validationTestCases.validationTestCase:
        visible: false
      systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
        visible: false

  Design Focus:
    columns:
      severity:
        visible: false
      validationTestCases.validationTestCase:
        visible: false

​
Error Handling

Views handle configuration errors gracefully:
  • Non-existent property paths in view column configuration do not block view loading
  • Invalid view definitions fall back to the base view columns
  • Missing view names in URL parameters load the default or base view

​
Complete YAML Example

columnGroups:
  sysReq:
    groupName: System Requirements
    groupStyle: darkblue
    headerStyle: blue

columns:
  outlineNumber:
    title: "#"
    width: 80
    sort: asc

  title:
    title: User Need
    width: 200
    hasFocus: true

  severity:
    title: Severity
    width: 100

  systemRequirements.systemRequirement.title:
    title: Sys Req Title
    width: 200
    columnGroup: sysReq

  systemRequirements.systemRequirement.severity:
    title: Sys Req Severity
    width: 100
    columnGroup: sysReq

  systemRequirements.systemRequirement.designRequirements.designRequirement:
    title: Design Outputs
    width: 180
    multiItem: true
    display: title

  validationTestCases.validationTestCase:
    title: Validation Tests
    width: 180
    multiItem: true
    display: title

  systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
    title: Verification Tests
    width: 180
    multiItem: true
    display: title

views:
  Without V&V:
    columns:
      validationTestCases.validationTestCase:
        visible: false
      systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
        visible: false

  Requirements Only:
    columns:
      systemRequirements.systemRequirement.designRequirements.designRequirement:
        visible: false
      validationTestCases.validationTestCase:
        visible: false
      systemRequirements.systemRequirement.verificationTestCases.verificationTestCase:
        visible: false

sources:
  - id: rtm
    model: rtm
    query:
      from: UserNeed
    expand:
      - name: systemRequirements
        title: System Requirements
        expand:
          - name: designRequirements
            title: Design Requirements
          - name: verificationTestCases
            title: Verification Tests
      - name: validationTestCases
        title: Validation Tests
Related pages: Columns | Column Groups | Views Selector | Column Sets
KB ArticlesSource Code
  • prod-powersheet-src/com.nextedy.powersheet.client/src/modules/ConfigProvider/types/PowersheetConfig.d.ts
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/common/types/api/document.ts
  • powersheet.yaml
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/sheet/commands/applyView.ts
  • prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/cypress/e2e/Sheet/alternative-views.spec.ts