slreq.Requirement 类

命名空间: slreq

使用需求对象

描述

slreq.Requirement 的实例是仅在 Requirements Toolbox™ 内部进行管理的需求对象，并且与外部应用程序管理的工件没有持久关联。需求对象只能存在于需求集中。

创建对象

req = find(rs, 'PropertyName', PropertyValue) 用于在需求集 rs 中查找并返回需求 req，该需求具有 PropertyName 和 PropertyValue 所指定的额外需求属性。

req = add(rs, 'PropertyName', PropertyValue) 用于向需求集 rs 添加需求 req，该需求具有 PropertyName 和 PropertyValue 指定的额外需求属性。

输入参量

全部展开

`rs` — 需求集对象
`slreq.ReqSet` 对象

需求集，指定为 slreq.ReqSet 对象。

输出参量

全部展开

`req` — 需求对象
`slreq.Requirement` 对象

需求的句柄，以 slreq.Requirement 对象形式返回。

属性

全部展开

`Type` — 需求类型
`"Functional"` | `"Informational"` | `"Container"` | 字符串标量 | 字符向量

需求类型，指定为 "Functional"、"Informational"、"Container"，或者是指定自定义需求类型或构造型的字符串标量或字符向量。有关详细信息，请参阅需求类型。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`Id` — 需求自定义 ID
字符串标量 | 字符向量

需求的自定义 ID，指定为字符串标量或字符向量。自定义 ID 中不能使用空格和 '#'。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`Summary` — 需求摘要
字符串标量 | 字符向量

需求摘要文本，指定为字符串标量或字符向量。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`Description` — 需求描述
字符串标量 | 字符向量

需求描述文本，指定为字符串标量或字符向量。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`Keywords` — 需求关键字
字符串数组 | 元胞数组

需求关键字，指定为字符串数组或字符向量元胞数组。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`Rationale` — 需求理由
字符串标量 | 字符向量

需求理由文本，指定为字符串标量或字符向量。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`CreatedOn` — 需求创建日期
`datetime` 值

创建需求的日期，指定为 datetime 值。该属性由软件填充。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`CreatedBy` — 需求创建者
字符向量

创建需求的个人或组织的名称。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`ModifiedBy` — 需求修改者
字符向量

最后修改需求的个人或组织的名称。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`IndexEnabled` — 索引启用指示符
`1` (默认) | `0`

指示索引是已启用 (1) 还是已禁用 (0)，以 logical 数据类型的 1 或 0 形式返回。如果禁用索引，Requirements Toolbox 在创建编号层次结构列表时不会计算此需求。但是，此需求在层次结构中仍处于原来的位置。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`IndexNumber` — 用户指定的索引值
空 `double` 数组 (默认) | `int32` 数组

用户指定的索引值，以空 double 数组或 int32 数组形式返回。如果为空，Requirements Toolbox 将计算 Index 值。否则，Requirements Toolbox 将 Index 属性设置为指定的整数值。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

`SID` — 需求会话独立标识符
字符向量

与需求对应的会话独立标识符，指定为字符向量。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`FileRevision` — 需求修订版编号
标量

需求修订版编号，以标量形式返回。创建新需求时，FileRevision 属性与需求集修订版编号相匹配。修改该需求并保存需求集时，需求集修订版编号会增加 1，并且 FileRevision 属性会更新以匹配新的需求集修订版编号。仅当您保存对需求的更改时，FileRevision 属性才会更新。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`ModifiedOn` — 需求修改日期
`datetime` 值

最后一次修改需求的日期，指定为 datetime 值。该属性由软件填充。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`Dirty` — 未保存的更改指示符
`0` | `1`

指示需求是有未保存的更改 (1)，还是没有未保存的更改 (0)。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`Comments` — 需求注释
结构体数组

附加到需求的注释，指定为结构体。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

`Index` — 需求索引
字符数组

需求的索引，指定为字符数组。

属性：

`GetAccess`	`public`
`SetAccess`	`private`

方法

add	添加子需求
addComment	为需求添加注释
children	查找需求的子需求
copy	复制和粘贴需求
demote	降低需求
find	查找满足父级需求的子级
getAttribute	获取需求属性值
getDescriptionAsText	以纯文本形式获取需求描述
getImplementationStatus	查询需求实现状态摘要
getRationaleAsText	以纯文本形式获取需求原理
getVerificationStatus	查询需求验证状态摘要
inLinks	获取需求的入站链接
isFilteredIn	检查已过滤的需求
isJustifiedFor	检查需求是否已申述
justifyImplementation	申述需求以实现
justifyVerification	申述用于验证的需求
move	按层次结构移动需求
moveDown	将需求在层次结构中下移
moveUp	将需求在层次结构中向上移动
outLinks	获取需求的出向链接
parent	查找需求的父项
promote	提升需求
remove	从需求集删除需求
reqSet	返回父级需求集
setAttribute	设置需求属性值

示例

全部折叠

在需求集中查找需求

此示例说明如何在需求集中查找需求。

加载名为 myReqSet 的需求集。

rs = slreq.load("myReqSet");

在该需求集中查找 ID 为 77 的需求。

req = find(rs,"Type","Requirement","ID","77");

req = 

  Requirement with properties:

             Id: '77'
        Summary: 'Test Spec'
       Keywords: [0×0 char]
    Description: ''
      Rationale: ''
            SID: 80
      CreatedBy: 'John Doe'
      CreatedOn: 05-Oct-2007 16:09:38
     ModifiedBy: 'Jane Doe'
     ModifiedOn: 21-Dec-2016 11:10:05
       Comments: [0×0 struct]

版本历史记录

在 R2018a 中推出

另请参阅

slreq.ReqSet | slreq.Reference | slreq.Link | slreq.LinkSet

slreq.Requirement 类

描述

创建对象

输入参量

rs — 需求集对象 slreq.ReqSet 对象

输出参量

req — 需求对象 slreq.Requirement 对象

属性

Type — 需求类型 "Functional" | "Informational" | "Container" | 字符串标量 | 字符向量

属性：

Id — 需求自定义 ID 字符串标量 | 字符向量

属性：

Summary — 需求摘要 字符串标量 | 字符向量

属性：

Description — 需求描述 字符串标量 | 字符向量

属性：

Keywords — 需求关键字 字符串数组 | 元胞数组

属性：

Rationale — 需求理由 字符串标量 | 字符向量

属性：

CreatedOn — 需求创建日期 datetime 值

属性：

CreatedBy — 需求创建者 字符向量

属性：

ModifiedBy — 需求修改者 字符向量

属性：

IndexEnabled — 索引启用指示符 1 (默认) | 0

属性：

IndexNumber — 用户指定的索引值 空 double 数组 (默认) | int32 数组

属性：

SID — 需求会话独立标识符 字符向量

属性：

FileRevision — 需求修订版编号 标量

属性：

ModifiedOn — 需求修改日期 datetime 值

属性：

Dirty — 未保存的更改指示符 0 | 1

属性：

Comments — 需求注释 结构体数组

属性：

Index — 需求索引 字符数组

属性：

方法

示例

在需求集中查找需求

版本历史记录

另请参阅

`rs` — 需求集对象
`slreq.ReqSet` 对象

`req` — 需求对象
`slreq.Requirement` 对象

`Type` — 需求类型
`"Functional"` | `"Informational"` | `"Container"` | 字符串标量 | 字符向量

`Id` — 需求自定义 ID
字符串标量 | 字符向量

`Summary` — 需求摘要
字符串标量 | 字符向量

`Description` — 需求描述
字符串标量 | 字符向量

`Keywords` — 需求关键字
字符串数组 | 元胞数组

`Rationale` — 需求理由
字符串标量 | 字符向量

`CreatedOn` — 需求创建日期
`datetime` 值

`CreatedBy` — 需求创建者
字符向量

`ModifiedBy` — 需求修改者
字符向量

`IndexEnabled` — 索引启用指示符
`1` (默认) | `0`

`IndexNumber` — 用户指定的索引值
空 `double` 数组 (默认) | `int32` 数组

`SID` — 需求会话独立标识符
字符向量

`FileRevision` — 需求修订版编号
标量

`ModifiedOn` — 需求修改日期
`datetime` 值

`Dirty` — 未保存的更改指示符
`0` | `1`

`Comments` — 需求注释
结构体数组

`Index` — 需求索引
字符数组