Main Content

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

createReferences

类: slreq.ReqSet
命名空间: slreq

创建对第三方文档中需求项的只读引用

语法

createReferences(rs, pathToFile, Name, Value)
createReferences(rs, reqFormat, Name, Value)

说明

createReferences(rs, pathToFile, Name, Value) 通过使用额外的 Name, Value参量来指定导入选项,在 pathToFile 处的外部文档中创建对需求内容的只读引用。

createReferences(rs, reqFormat, Name, Value) 通过使用额外的 Name, Value 参数指定导入参量,在与 reqFormat 指定的指定注册文档类型相对应的外部文档中创建对需求内容的只读引用。

输入参数

全部展开

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

需求文档的路径。

示例: 'C:\MATLAB\System_Requirements.docx'

使用自定义文档类型扩展 API 创建的自定义注册文档类型标签。

示例: 'linktype_rmi_doors'

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来

示例: 'columns', '[1 8]', 'RichText', true

将需求引用导入到的现有需求集的名称,指定为以逗号分隔的 'ReqSet' 对和有效的需求集文件名。

示例: 'ReqSet', 'My_Requirements_Set'

将需求内容导入为富文本的选项,指定为由 'RichText'truefalse 组成的逗号分隔的对。

示例: 'RichText', true

选择使用 Microsoft Word 文档和 Microsoft Excel 电子表格中的自定义书签来导入需求内容,指定为由 'bookmarks'truefalse 组成的逗号分隔的对。

示例: 'bookmarks', false

使用正则表达式模式匹配导入需求,指定为由'match'和正则表达式模式组成的逗号分隔的对。

示例: 'match', '^REQ\d+'

要导入的列的范围。此选项仅适用于 Microsoft Excel 电子表格。

示例: 'columns', [1 6]

要导入的行的范围。此选项仅适用于 Microsoft Excel 电子表格。

示例: 'rows', [3 35]

要导入的属性名称,指定为元胞数组。

注意

Microsoft Excel 电子表格导入需求时,此元胞数组的长度必须与您使用 'columns' 选项指定的导入列数相匹配。

示例: 'attributes', {'Test Status', 'Test Procedure'}

您想要与需求集集中的 ID 字段对应的 Microsoft Excel 电子表格中的列。

示例: 'idColumn', 1

您想要与需求集的 Summary 字段对应的 Microsoft Excel 电子表格中的列。

示例: 'summaryColumn', 4

您想要与需求集中的关键字字段对应的Microsoft Excel电子表格中的列。

示例: 'keywordsColumn', 3

您希望 Microsoft Excel 电子表格中的列与需求集中的描述字段相对应。

示例: 'descriptionColumn', 2

您想要与需求集中的 Rationale 字段对应的 Microsoft Excel 电子表格中的列。

示例: 'rationaleColumn', 5

示例

Microsoft Office 文档中创建对需求的只读引用

% Create a new requirement set and save it

rs = slreq.new('newReqSet');
save(rs);

% Create read-only rich text references to requirements 
% in a Word document
createReferences(rs, 'C:\Work\Requirements_Spec.docx', ...
'RichText', true);

% Create read-only plain text references to requirements 
% in an Excel spreadsheet
createReferences(rs, 'C:\Work\Design_Spec.xlsx', ...
'columns', [2 6], 'rows', [3 32], 'idColumn', 2, ...
'summaryColumn', 3);

版本历史记录

在 R2018a 中推出