Main Content

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

slreq.import

从外部文档导入需求

说明

slreq.import(docPath) 从位于 docPath 的外部文档导入需求内容作为引用需求。导入的需求将保存在与外部文档同名的新需求集。使用此导入方法从 Microsoft® Office 文档以及需求交换格式 (.reqif.reqifz) 的文件导入需求内容。

[refCount, reqSetFilePath, reqSetObj] = slreq.import(docPath) 从位于 docPath 的外部文档导入需求内容作为引用需求,并返回导入的引用数量 refCount。导入的需求保存在位于reqSetFilePath的需求集reqSetObj中,与外部文档同名。

slreq.import(docType) 从注册文档类型为 docType 的外部文档导入需求内容作为引用需求。导入的需求将保存在与外部文档同名的新需求集。

slreq.import(docPath,Name,Value) 从位于 docPath 的外部文档导入需求内容作为引用需求,并使用一个或多个 Name, Value 对参量指定的选项。

slreq.import(reqifFile) 使用预配置的属性映射从 ReqIF 文件 reqifFile 导入需求内容。

slreq.import(reqifFile, 'mappingFile', mapFilePath) 使用 mapFilePath 指定的属性映射从 ReqIF 文件 reqifFile 导入需求内容。

slreq.import('clearcache') 清理导入富文本需求时创建的临时 HTML 文件。

示例

导入参考需求

% Import referenced requirements from Microsoft Office documents
slreq.import('Specification002.docx');
slreq.import('D:/Projects/Requirements/Safety321.xlsx');

% Import referenced requirements from an IBM DOORS Module
slreq.import('linktype_rmi_doors');

有关从第三方应用程序导入引用需求的更多信息,请参阅 从第三方应用程序导入需求

输入参数

全部折叠

外部需求文档的文件路径,指定为字符向量。

外部需求文档的文档类型,指定为字符向量。

示例: 'linktype_rmi_doors'

ReqIF 文件的文件路径,指定为字符向量。

属性映射文件的文件路径,指定为字符向量。

名称-值参数

将可选的参量对组指定为 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 等的条目匹配。

输出参量

全部折叠

导入的引用需求的数量,以 double 形式返回。

导入需求的需求需求集的文件路径,以字符向量形式返回。

处理您导入需求的需求集,以 slreq.ReqSet 对象的形式返回。

限制

  • MATLAB® Online™ 不支持从 Microsoft WordMicrosoft Excel 或 IBM DOORS 文档导入需求。

提示

版本历史记录

在 R2018a 中推出

全部展开