add

类: slreq.Reference
命名空间: slreq

添加子引用需求

语法

refChild = add(ref,"Artifact",FileName) refChild = add(ref,"Artifact",FileName,PropertyName,PropertyValue,...,PropertyNameN,PropertyValueN)

说明

refChild = add(ref,"Artifact",FileName) 在引用外部文档 FileName 中的需求的引用需求 ref 下添加一个子引用需求。

refChild = add(ref,"Artifact",FileName,PropertyName,PropertyValue,...,PropertyNameN,PropertyValueN) 添加一个子引用需求，其属性和属性值由 PropertyName 和 PropertyValue 指定。

输入参数

全部展开

`ref` — 引用的需求
`slreq.Reference` 对象

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

`FileName` — 外部需求文档标识符
字符串标量 | 字符向量

外部需求文档标识符，指定为字符串标量或字符向量。文档标识符的示例是 Microsoft^® Office 文档名称或 IBM^® DOORS^® 模块唯一 ID。

`PropertyName` — 引用的需求属性名称
字符串标量 | 字符向量

引用的需求属性名称，指定为字符串标量或字符向量。

您只能输入 slreq.Reference 属性，其中 SetAccess 属性为 public。

示例: "Summary"

`PropertyValue` — 引用需求属性值
字符串标量 | 字符向量

引用需求属性值，指定为字符串标量或字符向量。

输出参量

全部展开

`refChild` — 引用的子需求
`slreq.Reference` 对象

新引用的子需求，作为 slreq.Reference 对象返回。

示例

全部展开

在引用需求下添加子引用需求

打开实时脚本

此示例显示如何在引用需求下添加子引用需求。

加载crs_req需求集。

rs = slreq.load("crs_req");

查找摘要为 Functional Requirements 的顶级引用需求。在该引用需求下添加一个子引用需求，该子引用需求使用与顶级引用需求相同的外部文档。

topRef = find(rs,"Summary","Functional Requirements");
childRef = add(topRef,"Artifact",topRef.Artifact)

childRef = 
  Reference with properties:

              Id: ''
        CustomId: ''
        Artifact: 'crs_req.docx'
      ArtifactId: ''
          Domain: 'linktype_rmi_word'
       UpdatedOn: 17-Apr-2023 16:07:41
       CreatedOn: 17-Apr-2023 16:07:41
       CreatedBy: ''
      ModifiedBy: ''
        IsLocked: 1
         Summary: ''
     Description: ''
       Rationale: ''
        Keywords: {}
            Type: 'Functional'
    IndexEnabled: 1
     IndexNumber: []
             SID: 32
    FileRevision: 1
      ModifiedOn: 17-Apr-2023 16:07:41
           Dirty: 0
        Comments: [0×0 struct]
           Index: '3.13'

提示

要将顶级需求添加到需求集，请使用 slreq.ReqSet 的 add 方法。要将一个需求添加为另一个需求的子项，请使用 slreq.Requirement 的 add 方法。要将一个申述添加为另一个申述的子项，请使用 slreq.Justification 的 add 方法。