importFromDocument
类: slreq.ReqSet
命名空间: slreq
从外部文档导入可编辑需求
语法
importFromDocument(rs, pathToFile, Name,Value)
说明
importFromDocument(
导入可编辑需求,其内容从 rs
, pathToFile
, Name,Value
)pathToFile
处的外部文档复制而来,并使用附加 Name,Value
参量指定导入选项。
输入参数
rs
— 需求集文件
slreq.ReqSet
对象
需求集文件,指定为 slreq.ReqSet
对象。
pathToFile
— 文件路径
字符向量
您要从中导入可编辑需求的需求文档的路径。
示例: 'C:\MATLAB\System_Requirements.docx'
名称-值参数
将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: 'ReqSet','design_specs.slreqx'
AsReference
— 根据引用需求导入的选项
true
(默认) | false
将需求导入为引用需求的选项,指定为布尔值。
要继续在第三方工具中管理需求,请通过将值设置为 true
或使用默认值将需求导入为引用需求。要将需求迁移到 Requirements Toolbox™,请通过将值设置为 false
将需求作为 slreq.Requirement
对象导入。有关更多信息,请参阅 选择导入模式。
attr2reqprop
— ReqIF™ 属性映射
containers.Map
对象
从 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);
attributeColumn
— 自定义属性列
double
数组
您想要映射为需求集需求的自定义属性的 Microsoft® Excel® 电子表格中的列,指定为 double
数组。
示例: 'attributeColumn',[4 6]
attributes
— 属性名称
元胞数组
自定义属性列的属性名称,指定为字符向量元胞数组。
注意
从 Microsoft Excel 电子表格导入需求时,此元胞数组的长度必须与使用 attributeColumn
参量指定的导入列数相匹配。
示例: 'attributes',{'Test Status','Test Procedure'}
bookmarks
— 使用书签导入需求的选项
0
(默认) | 1
使用用户定义的书签导入需求内容的选项,指定为数据类型为 logical
的 1
或 0
。
默认情况下,Requirements Toolbox 将 Microsoft Word 文档的值设置为 1
,将 Microsoft Excel 电子表格的值设置为 0
。
示例: 'bookmarks',false
columns
— 列的范围
double
数组
要从 Microsoft Excel 电子表格导入的列范围,指定为 double
数组。
示例: 'columns',[1 6]
createdByColumn
— 按列创建
double
您想要映射到需求集需求的 CreatedBy
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'createdByColumn',5
descriptionColumn
— 描述列
double
您想要映射到需求集需求的 Description
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'descriptionColumn',2
idColumn
— ID 列
double
您想要映射到需求集需求的 ID
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'idColumn',1
importLinks
— 导入链接的选项
false
(默认) | true
从 ReqIF 文件导入需求时导入链接的选项,指定为布尔值。
示例: importLinks=true
keywords
— 要映射到 Keywords
的属性
字符串标量 | 字符向量
您想要映射到导入需求的 Keywords
属性的外部文档属性的名称。
从 IBM® DOORS® 或自定义文档类型导入时使用此参量。
示例: "keywords","Requirement Keywords"
keywordsColumn
— 关键字列
double
您想要映射到需求集需求的 Keywords
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'keywordsColumn',3
match
— 正则表达式模式
字符向量
Microsoft Office 文档中 ID 搜索的正则表达式模式。
示例: 'match','^REQ\d+'
modifiedByColumn
— 按列修改
double
您想要映射到需求集需求的 ModifiedBy
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'modifiedByColumn',6
postImportFcn
— 自定义导入后回调
字符串标量 | 字符向量
导入期间使用的自定义导入后回调脚本名称,指定为字符串标量或字符向量。
您导入或更新需求后,将执行分配给此回调的脚本。
示例: "postImportFcn","myPostImportScript"
preImportFcn
— 自定义导入前回调
字符串标量 | 字符向量
导入期间使用的自定义预导入回调脚本名称,指定为字符串标量或字符向量。
您分配给此回调的脚本在您导入或更新需求之前执行。
示例: "preImportFcn","myPreImportScript"
profile
— 配置文件名称
字符串标量 | 字符向量
从 ReqIF 文件导入需求和链接时使用的配置文件的名称,指定为字符串标量或字符向量。
如果不存在具有该名称的配置文件,软件将创建它并将其分配给导入的需求集和链接集。如果存在具有该名称的配置文件,软件会将其分配给导入的需求集和链接集。
示例: profile="myProfile"
profileMapping
— 配置文件映射文件的名称
字符串标量 | 字符向量
从 ReqIF 文件导入需求和链接时使用的配置文件映射文件的名称,指定为字符串标量或字符向量。
配置文件映射 XML 文件指定了 ReqIF 需求和链接类型及属性如何映射到 Requirements Toolbox 原型和原型属性。要使用此参量,您还必须使用 profile
参量指定要分配给导入的需求集和链接集的配置文件。
提示
您可以使用 saveProfileMapping
方法从具有配置文件映射的需求集创建配置文件映射文件。
示例: profileMapping="myMapping.xml"
rationale
— 要映射到 Rationale
的属性
字符串标量 | 字符向量
您想要映射到导入需求的 Rationale
属性的外部文档属性的名称。
从 IBM DOORS 或自定义文档类型导入时使用此参量。
示例: "rationale","Requirement Rationale"
rationaleColumn
— 理由栏
double
您想要映射到需求集需求的 Rationale
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'rationaleColumn',5
ReqSet
— 需求集
字符向量
导入需求的需求集的名称,指定为字符向量。
如果需求集存在,则需求导入到新的导入节点下。如果需求集不存在,Requirements Toolbox 会创建它。
示例: 'ReqSet','My_Requirements_Set'
RichText
— 导入富文本需求的选项
false
(默认) | true
将需求导入为富文本的选项,指定为布尔值。
示例: 'RichText',true
rows
— 行的范围
double
数组
要从 Microsoft Excel 电子表格导入的行范围,指定为 double
数组。
示例: 'rows',[3 35]
sheet
— 工作表名称
字符向量
Microsoft Excel 工作簿中的工作表名称,指定为字符向量。
示例: 'sheet','Sheet1'
summaryColumn
— 摘要栏
double
您想要映射到需求集需求的 Summary
属性的 Microsoft Excel 电子表格中的列,指定为 double
。
示例: 'summaryColumn',4
USDM
— USDM 格式导入选项
字符向量
从符合 USDM(通用规范描述方式)标准格式的 Microsoft Excel 电子表格导入。将值指定为带有 ID 前缀的字符向量,后面可以跟一个分隔符。
示例: 'RQ -'
将与 ID 类似于 RQ01
、RQ01-2
、RQ01-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);
版本历史记录
在 R2018a 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)