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

slreq.import

从外部文档导入需求

全页折叠

语法

slreq.import(docPath)
[refCount, reqSetFilePath, reqSetObj] = slreq.import(docPath)
slreq.import(docInterfaceName)
slreq.import(___,Name=Value)
slreq.import("clearcache")

说明

slreq.import(docPath) 从位于 docPath 的外部文档中导入需求，并将它们保存为引用需求，存储在一个与外部文档同名的新的需求集 中。使用此函数从 Microsoft® Office 文档和要求交换格式 (RIF)"）文件中导入需求。

示例

[refCount, reqSetFilePath, reqSetObj] = slreq.import(docPath) 从外部文档中导入引用需求，并返回生成的引用需求数量 refCount、包含引用需求的 demand 集合的路径 reqSetFilePath，以及引用需求对象的名称 reqSetObj。

示例

slreq.import(docInterfaceName) 将当前在已注册文档接口 docInterfaceName 中打开的文档中的需求作为引用需求导入。该函数将导入的需求保存到一个新的需求集，该需求集与外部文档具有相同的名称。

示例

slreq.import(___,Name=Value) 除了前面语法中的输入参量外，还使用一个或多个名称-值参量指定选项。

示例

slreq.import("clearcache") 清理在导入富文本格式需求时生成的临时 HTML 文件。

示例

示例

全部折叠

从一个 Microsoft Word 文档中导入引用需求。

slreq.import("Specification002.docx");

将电子表格 3 中 150 至 MyExcelDoc.xlsx 的行以富文本格式导入。将电子表格的第二列映射到需求中的 ID 属性，将第三列映射到需求中的 Description 属性。然后，清理临时 HTML 文件。

slreq.import("MyExcelDoc.xlsx",rows=[3 150],...
idColumn=2,descriptionColumn=3,RichText=true);

slreq.import("clearcache");

从一个 Microsoft Excel® 文档中导入引用需求，并返回导入的需求数量、需求集文件路径以及需求集对象。

[count,reqSetFilePath,reqSet] = slreq.import( ...
    "ExampleRequirements.xlsx");

从 IBM DOORS 模块导入引用需求。要导入引用需求，DOORS 应用程序必须正在运行，您必须已登录，并且要导入的模块必须已打开且处于当前状态。

slreq.import("linktype_rmi_doors");

输入参数

全部折叠

外部需求文档或 ReqIF 文件的路径，指定为字符串标量或字符向量。

用于与第三方应用程序集成的注册文档接口的名称，应指定为以下选项之一：

"linktype_rmi_doors"

从 IBM® DOORS® 导入

"linktype_rmi_word"

从 Microsoft Word 导入

"linktype_rmi_excel"

从 Microsoft Excel 导入

指定自定义文档接口名称的字符串标量或字符向量从 Requirements Toolbox™ 未提供内置支持的第三方应用程序导入。有关详细信息，请参阅定义自定义文档接口以导入需求。

示例: slreq.import("linktype_rmi_doors")

名称-值参数

全部展开

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

示例: slreq.import(docPath,AsReference=true) 将位于 docPath 的文档中的需求导入为参考需求。

常规选项

全部展开

将需求作为引用需求导入的选项，指定为 true 或 false。

要将引用需求导入为引用需求，请将值设置为 true。如果希望继续在第三方工具中管理需求，请选择此选项。要将需求导入为 slreq.Requirement 对象，请将值设置为 false。使用此选项将需求迁移到 Requirements Toolbox。有关详细信息，请参阅选择导入模式。

示例: AsReference=true

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

注意

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

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

外部需求文档标识符，指定为字符串标量或字符向量。

提示

从 IBM DOORS 导入时，请使用 DocID 参量指定模块 ID。

示例: DocID="0000abcd"

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

您分配给此回调的脚本在您导入或更新需求之前执行。有关详细信息，请参阅使用回调自定义需求导入行为。

示例: preImportFcn="myPreImportScript"

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

您导入或更新需求后，将执行分配给此回调的脚本。有关详细信息，请参阅使用回调自定义需求导入行为。

示例: postImportFcn="myPostImportScript"

用于导入需求的条件集名称，指定为字符串标量或字符向量。

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

示例: ReqSet="My_Requirements_Set"

导入需求为富文本格式，格式选项指定为 true 或 false。要导入富文本格式需求，请将 RichText 设置为 true。

示例: RichText=true

Microsoft Excel 和 Microsoft Word 的选项

全部展开

导入需求内容的选项，支持通过用户自定义书签导入需求内容，书签格式可指定为数字或逻辑值 1 (true) 或 0 (false)。

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

示例: bookmarks=false

用于在 Microsoft Office 文档中搜索 ID 的正则表达式模式，指定为字符串标量或字符向量。

示例: match="^REQ\d+"

Microsoft Excel 的选项

全部展开

在 Microsoft Excel 电子表格中，用于映射到需求集中的需求自定义属性的列范围，以 double 数组形式指定。

示例: attributeColumn=[4 6]

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

示例: columns=[1 6]

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 CreatedBy 属性，指定为 double。

示例: createdByColumn=5

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 Description 属性，指定为 double。

示例: descriptionColumn=2

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 ID 属性，指定为 double。

示例: idColumn=1

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 Keywords 属性，指定为 double。

示例: keywordsColumn=3

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 ModifiedBy 属性，指定为 double。

示例: modifiedByColumn=6

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 Rationale 属性，指定为 double。

示例: rationaleColumn=5

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

示例: rows=[3 35]

要从 Microsoft Excel 工作簿中导入的工作表名称，指定为字符串标量或字符向量。

示例: sheet="Sheet1"

Microsoft Excel 电子表格中的列，用于映射到需求集中需求的 Summary 属性，指定为 double。

示例: summaryColumn=4

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

示例: USDM="RQ -" 将匹配 ID 与 RQ01、RQ01-2、RQ01-2-1 等类似的条目。

ReqIF 文件的选项

全部展开

ReqIF 属性映射，指定为一个 containers.Map 对象。

示例: attr2reqprop=attrMap

在从 ReqIF 文件导入需求时，提供导入链接的选项，链接格式指定为 true 或 false。

示例: importLinks=true

属性映射文件的路径，指定为字符串标量或字符向量。

示例: mappingFile="D:/reqifmapping/myMapping.xml"

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

如果不存在名为“此名称”的配置文件，软件将创建该配置文件，并将其分配给导入的需求集和链接集。如果存在名称相同的配置文件，软件将该配置文件分配给导入的需求集和链接集。

示例: profile="myProfile"

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

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

提示

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

示例: profileMapping="myMapping.xml"

DOORS 和自定义文档类型的导入选项

全部展开

要映射到导入需求中 Keywords 属性的外部文档中的属性名称，指定为字符串标量或字符向量。

示例: keywords="Requirement Keywords"

要映射到导入需求中 Rationale 属性的外部文档中的属性名称，指定为字符串标量或字符向量。

示例: rationale="Requirement Rationale"

输出参量

全部折叠

导入的引用需求数量，以 double 格式返回。

包含导入需求的规范集文件的路径，以字符向量形式返回。

导入需求时所设置的需求集，以 slreq.ReqSet 对象形式返回。

限制

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

提示

  • 当您导入或更新需求时，您可以使用回调来执行代码。有关详细信息，请参阅使用回调自定义需求导入行为。

  • 如果在导入 ReqIF 文件时 slreq.import 返回了错误，请使用 slreq.validateReqIF 函数检查该文件是否符合 ReqIF 规范。请使用第三方需求管理工具修复这些警告和错误，创建一个新的 ReqIF 文件，然后再次导入该文件。

版本历史记录

在 R2018a 中推出

全部展开

另请参阅

类

函数

主题