slreq.Justification 类

命名空间: slreq

需求申述

描述

使用 slreq.Justification 对象来处理您从需求实现和验证状态度量摘要中排除的需求。通过创建从 slreq.Justification 对象到需求的出向链接并将链接类型设置为实现或验证来申述需求。

创建对象

jst = slreq.find(rs,"Type","Justification","PropertyName",PropertyValue) 在需求集 slreq.Justification 中查找并返回 jst 对象 rs，其具有由 PropertyName 和 PropertyValue 指定的附加属性。

jst = add(jt,"PropertyName",PropertyValue) 将子申述 jst 添加到父申述 jt 中，并附加由 PropertyName 和 PropertyValue 指定的属性。

输入参量

全部展开

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

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

`jt` — 申述
`slreq.Justification` 对象

申述，指定为 slreq.Justification 对象。

输出参量

全部展开

`jst` — 申述
`slreq.Justification` 对象

申述，作为 slreq.Justification 对象返回。

属性

全部展开

`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），以数据类型为 1 的 0 或 logical 返回。如果禁用索引，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 属性将更新以匹配新的需求集修订号。仅当您保存对申述的更改时，FileRevision 属性才会更新。

有关需求集修订的更多信息，请参阅 slreq.ReqSet。

属性：

`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	获取申述属性
isFilteredIn	检查已过滤的申述
isHierarchical	检查申述是否具有层次性
move	按层次结构移动申述
moveDown	在层次结构中向下移动申述
moveUp	将申述在层次结构中向上移动
outLinks	获取出向链接以进行申述
parent	查找申述的父项
promote	提升申述
remove	删除申述项
reqSet	返回父级需求集
setAttribute	设置申述属性
setHierarchical	更改层次申述状态

示例

全部折叠

添加子申述

此示例显示如何在申述下添加子申述。

加载名为 myReqSet 的需求集。

rs = slreq.load("myReqSet");

在需求集查找申述对象。

myJustifications = find(rs,"Type","Justification")

myJustifications = 

  1×2 Justification array with properties:

    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments

为数组中第一个申述添加一个子申述。

myChildJustification = add(myJustifications(1),"Id","2.1",...
"Summary","New Child Justification")

myChildJustification = 

  Justification with properties:

              Id: '2.1'
         Summary: 'New Child Justification'
     Description: ''
        Keywords: [0×0 char]
       Rationale: ''
       CreatedOn: 25-Aug-2017 14:37:29
       CreatedBy: 'Jane Doe'
      ModifiedBy: 'John Doe'
             SID: 73
    FileRevision: 1
      ModifiedOn: 26-Aug-2017 17:30:20
           Dirty: 0
        Comments: [0×0 struct]

版本历史记录

在 R2018b 中推出

另请参阅

slreq.Reference | slreq.ReqSet | slreq.Requirement

slreq.Justification 类

描述

创建对象

输入参量

rs — 需求集 slreq.ReqSet 对象

jt — 申述 slreq.Justification 对象

输出参量

jst — 申述 slreq.Justification 对象

属性

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` 对象

`jt` — 申述
`slreq.Justification` 对象

`jst` — 申述
`slreq.Justification` 对象

`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` — 申述索引
字符数组