Main Content

本页采用了机器翻译。点击此处可查看英文原文。

slreq.Reference 类

命名空间: slreq

使用外部需求代理对象

描述

slreq.Reference 类的对象代表您从第三方需求管理工具导入的引用需求。引用需求是您使用第三方工具管理的外部需求的代理需求。当您对外部需求进行更改时,您可以更新所引用需求。

创建对象

ref = find(rs, 'Type', 'Reference', 'PropertyName', PropertyValue) 在与 PropertyNamePropertyValue 匹配的属性指定的需求集rs 中查找并返回一个引用需求或一组引用需求ref

ref = add(rs, 'Artifact', FileName, 'PropertyName', PropertyValue) 将引用的需求 ref 添加到需求集rs,该需求集引用了 FileName 指定的外部文档中的需求,并具有 PropertyNamePropertyValue 指定的属性和自定义属性。

输入参量

全部展开

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

顶级容器标识符的文件名,例如 Microsoft® Office 文档名称或 IBM® DOORS® 模块唯一 ID。

输出参量

全部展开

引用的需求,指定为 slreq.Reference 对象。

属性

全部展开

引用需求 ID,以字符向量形式返回。

属性:

GetAccess
public
SetAccess
private

引用需求自定义 ID,以字符向量形式返回。

属性:

GetAccess
public
SetAccess
private

顶级容器标识符,如 Microsoft Office 文档名称或 IBM DOORS 模块唯一 ID。

属性:

GetAccess
public
SetAccess
private

源需求文档中的唯一需求标识符。对于从 IBM DOORS 导入的需求,ArtifactId 是数字对象 ID。对于从 Microsoft Word 导入的需求,书签名称用作 ArtifactId

属性:

GetAccess
public
SetAccess
private

外部需求文档的接口名称,以字符向量形式返回。该名称可以是内置名称之一,也可以是自定义注册接口的名称。有关更多信息,请参阅 定义自定义文档接口以导入需求

示例: 'linktype_rmi_word','custom_jira'

属性:

GetAccess
public
SetAccess
private

引用需求上次与外部文档同步的日期和时间,指定为 datetime 值。软件会自动填充此属性。

属性:

GetAccess
public
SetAccess
private

引用需求的创建日期,指定为 datetime 值。软件会自动填充此属性。

属性:

GetAccess
public
SetAccess
private

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

属性:

GetAccess
public
SetAccess
private

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

属性:

GetAccess
public
SetAccess
private

指示引用的需求是否被锁定。1 表示锁定,0 表示解锁。

属性:

GetAccess
public
SetAccess
private

引用需求摘要文本,以字符向量形式返回。

属性:

GetAccess
public
SetAccess
public

引用的需求描述文本,以多行字符向量形式返回。

属性:

GetAccess
public
SetAccess
public

引用需求理由文本,以多行字符向量形式返回。

属性:

GetAccess
public
SetAccess
public

引用的需求关键字,指定为字符数组。

属性:

GetAccess
public
SetAccess
public

引用的需求类型枚举,指定为 'Functional''Informational''Container',或者指定自定义需求类型的字符串标量或字符向量。有关更多信息,请参阅 需求类型

属性:

GetAccess
public
SetAccess
public

指示引用的需求索引是否启用(1)或禁用(0),作为数据类型为 logical10 返回。禁用索引会从编号层次结构列表中省略所引用的需求。

属性:

GetAccess
public
SetAccess
public

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

属性:

GetAccess
public
SetAccess
public

与引用的需求相对应的会话独立标识符。

属性:

GetAccess
public
SetAccess
private

引用需求修订号,指定为标量。

属性:

GetAccess
public
SetAccess
private

引用需求的最后修改日期,指定为 datetime 值。软件会自动填充此属性。

属性:

GetAccess
public
SetAccess
private

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

属性:

GetAccess
public
SetAccess
private

与引用需求一起附加的注释,以结构体形式返回。

属性:

GetAccess
public
SetAccess
private

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

属性:

GetAccess
public
SetAccess
private

方法

add添加子引用需求
addComment 向引用需求添加注释
children查找子引用
find查找父级引用需求的子级
getAttribute获取引用的需求自定义属性
getExternalTypeName从外部工件获取需求类型名称
getImplementationStatus 查询引用需求实施状况汇总
getPostImportFcn获取PostImportFcn回调的内容
getPreImportFcn获取已注册的PreImportFcn回调脚本
getVerificationStatus 查询引用需求验证状态摘要
hasNewUpdate检查导入节点是否有可用更新
inLinks获取引用需求的入站链接
isFilteredIn检查已过滤的引用需求
isJustifiedFor检查引用的需求是否已申述
justifyImplementation 申述用于实施的引用需求
justifyVerification 申述以验证的引用需求
moveDown将引用的需求在层次结构中向下移动
moveUp将引用的需求向上移动一层
navigateToExternalArtifact从导入的参考需求导航至原始需求
outLinks获取引用需求的出向链接
parent查找引用需求的父项
remove删除引用需求
reqSet返回父级需求集
setAttribute设置引用的需求自定义属性
setParentPostImportFcn 回调中设置引用需求的父级
setPostImportFcn分配 PostImportFcn 回调脚本
setPreImportFcn分配 PreImportFcn 回调脚本
unlock 解锁引用需求
unlockAll 解锁所有子引用需求以供编辑
updateFromDocument从外部需求文档更新引用需求

示例

全部折叠

此示例显示如何在需求集查找引用的需求。

加载名为 myReqSet 的需求集。

rs = slreq.load("myReqSet");

在需求集查找 ID 为 9 的需求。

req = find(rs,"Type","Reference","ID","9");
ref = 

  Reference with properties:

          Keywords: [0×0 char]
          Artifact: 'Req_doc.docx'
                Id: 'R9'
           Summary: 'System overview'
       Description: ''
               SID: 3
            Domain: 'linktype_rmi_word'
    SynchronizedOn: 25-Jul-2017 11:34:02

版本历史记录

在 R2018a 中推出