Main Content

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

importFromDocument

类: slreq.ReqSet
命名空间: slreq

从外部文档导入可编辑需求

语法

importFromDocument(rs, pathToFile, Name,Value)

说明

importFromDocument(rs, pathToFile, Name,Value) 导入可编辑需求,其内容从 pathToFile 处的外部文档复制而来,并使用附加 Name,Value参量指定导入选项。

输入参数

全部展开

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

您要从中导入可编辑需求的需求文档的路径。

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

名称-值参数

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

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

示例: 'ReqSet','design_specs.slreqx'

将需求导入为引用需求的选项,指定为布尔值。

要继续在第三方工具中管理需求,请通过将值设置为 true 或使用默认值将需求导入为引用需求。要将需求迁移到 Requirements Toolbox™,请通过将值设置为 false 将需求作为 slreq.Requirement 对象导入。有关更多信息,请参阅 选择导入模式

从 ReqIF 格式导入,将属性映射指定为由 'attr2reqprop'containers.Map 对象组成的逗号分隔的对。例如:

attrMap = containers.Map('KeyType','char','ValueType','char')
attrMap('SourceID') = 'Custom ID'; % Built-in attribute
attrMap('ReqIF.ChapterName') = 'Summary'; % Built-in attribute
attrMap('Data Class') = 'MyDataClass'; % Custom attribute

slreq.import('myfile.reqif','attr2reqprop',attrMap);

示例: slreq.import('myfile.reqif','attr2reqprop',attrMap);

您想要映射为需求集需求的自定义属性的 Microsoft® Excel® 电子表格中的列,指定为 double数组。

示例: 'attributeColumn',[4 6]

自定义属性列的属性名称,指定为字符向量元胞数组。

注意

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

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

使用用户定义的书签导入需求内容的选项,指定为数据类型为 logical10

默认情况下,Requirements Toolbox 将 Microsoft Word 文档的值设置为 1,将 Microsoft Excel 电子表格的值设置为 0

示例: 'bookmarks',false

要从 Microsoft Excel 电子表格导入的列范围,指定为 double数组。

示例: 'columns',[1 6]

您想要映射到需求集需求的 CreatedBy属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'createdByColumn',5

您想要映射到需求集需求的 Description属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'descriptionColumn',2

您想要映射到需求集需求的 ID属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'idColumn',1

从 ReqIF 文件导入需求时导入链接的选项,指定为布尔值。

示例: importLinks=true

您想要映射到导入需求的 Keywords属性的外部文档属性的名称。

从 IBM® DOORS® 或自定义文档类型导入时使用此参量。

示例: "keywords","Requirement Keywords"

您想要映射到需求集需求的 Keywords属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'keywordsColumn',3

Microsoft Office 文档中 ID 搜索的正则表达式模式。

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

您想要映射到需求集需求的 ModifiedBy属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'modifiedByColumn',6

导入期间使用的自定义导入后回调脚本名称,指定为字符串标量或字符向量。

您导入或更新需求后,将执行分配给此回调的脚本。

示例: "postImportFcn","myPostImportScript"

导入期间使用的自定义预导入回调脚本名称,指定为字符串标量或字符向量。

您分配给此回调的脚本在您导入或更新需求之前执行。

示例: "preImportFcn","myPreImportScript"

从 ReqIF 文件导入需求和链接时使用的配置文件的名称,指定为字符串标量或字符向量。

如果不存在具有该名称的配置文件,软件将创建它并将其分配给导入的需求集和链接集。如果存在具有该名称的配置文件,软件会将其分配给导入的需求集和链接集。

示例: profile="myProfile"

从 ReqIF 文件导入需求和链接时使用的配置文件映射文件的名称,指定为字符串标量或字符向量。

配置文件映射 XML 文件指定了 ReqIF 需求和链接类型及属性如何映射到 Requirements Toolbox 原型和原型属性。要使用此参量,您还必须使用 profile参量指定要分配给导入的需求集和链接集的配置文件。

提示

您可以使用 saveProfileMapping 方法从具有配置文件映射的需求集创建配置文件映射文件。

示例: profileMapping="myMapping.xml"

您想要映射到导入需求的 Rationale属性的外部文档属性的名称。

从 IBM DOORS 或自定义文档类型导入时使用此参量。

示例: "rationale","Requirement Rationale"

您想要映射到需求集需求的 Rationale属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'rationaleColumn',5

导入需求的需求集的名称,指定为字符向量。

如果需求集存在,则需求导入到新的导入节点下。如果需求集不存在,Requirements Toolbox 会创建它。

示例: 'ReqSet','My_Requirements_Set'

将需求导入为富文本的选项,指定为布尔值。

示例: 'RichText',true

要从 Microsoft Excel 电子表格导入的行范围,指定为 double数组。

示例: 'rows',[3 35]

Microsoft Excel 工作簿中的工作表名称,指定为字符向量。

示例: 'sheet','Sheet1'

您想要映射到需求集需求的 Summary属性的 Microsoft Excel 电子表格中的列,指定为 double

示例: 'summaryColumn',4

从符合 USDM(通用规范描述方式)标准格式的 Microsoft Excel 电子表格导入。将值指定为带有 ID 前缀的字符向量,后面可以跟一个分隔符。

示例: 'RQ -' 将与 ID 类似于 RQ01RQ01-2RQ01-2-1 等的条目匹配。

示例

Microsoft Office 文档导入可编辑需求

% Create a new requirement set and save it
rs = slreq.new('newReqSet');
save(rs);

% Import editable requirements as rich text from a Word document
importFromDocument(rs, 'C:\Work\Requirements_Spec.docx', ...
 'RichText', true);

% Import editable requirements from an Excel spreadsheet
importFromDocument(rs, 'C:\Work\Design_Spec.xlsx', ... 
'columns', [2 6], 'rows', [3 32], 'idColumn', 2, ...
'summaryColumn', 3);
有关从 Microsoft Office 文档导入需求的更多信息,请参阅 从 Microsoft Office 文档导入需求

版本历史记录

在 R2018a 中推出