slreq.View

View settings

Since R2022b

Description

Use slreq.View objects to apply and manage the view settings for the Requirements Editor and Requirements Perspective.

Creation

Create a View object by using create.

Properties

Name — View name

character vector | string scalar

View name, specified as a character vector or string scalar.

Example: "myView"

ReqFilter — Requirement filter

character array | string scalar

Requirement filter, specified as a character array or a string scalar. The contents of the character vector or string scalar must be formatted as a cell array.

Example: "{'ReqType','Functional'};"

LinkFilter — Link filter

character array | string scalar

Link filter, specified as a character array or a string scalar. The contents of the character vector or string scalar must be formatted as a cell array.

Example: "{'LinkType','Relate'};"

Host — Host requirement set

Read-only: character array

This property is read-only.

Host requirement set that the view is stored in, returned as a character array. If the view is in the preferences folder, the host is empty.

Object Functions

activate	Apply view settings
activateDefaultView	Apply default view settings
create	Create view settings
delete	Delete view settings
getActiveView	Get applied view settings
getErrorMessage	Get view settings error message
getViews	Get available views
isValid	Check validity of view settings

Examples

Create and Apply View to Requirements Editor

This example shows how to create a view and apply it to the Requirements Editor and Requirements Perspective.

Open the myAddRequirements requirement set, which contains requirements with Type set to Functional.

rs = slreq.open("myAddRequirements");

Create a view with the name NewView.

myView = slreq.View.create("NewView")

myView = 
  View with properties:

          Name: 'NewView'
     ReqFilter: ''
    LinkFilter: ''
          Host: ''

Set the requirement filter to only display requirements that have Type set to Container.

myView.ReqFilter = "{'ReqType','Container'};"

myView = 
  View with properties:

          Name: 'NewView'
     ReqFilter: '{'ReqType','Container'};'
    LinkFilter: ''
          Host: ''

Check if the view is valid.

tf = isValid(myView)

tf = logical
   1

Apply the view to the Requirements Editor and Requirements Perspective.

activate(myView)

Confirm that the active view is NewView.

appliedView = slreq.View.getActiveView

appliedView = 
  View with properties:

          Name: 'NewView'
     ReqFilter: '{'ReqType','Container'};'
    LinkFilter: ''
          Host: ''

The myAddRequirements requirement set does not contain any requirements with Type set to Container, so all of the requirements are filtered out.

Version History

Introduced in R2022b