从第三方应用程序导入需求
您可以在第三方应用程序中编写需求并将其导入到 Requirements Toolbox™。当您导入需求时,您可以迁移这些需求并在 Requirements Toolbox 中管理它们,或者将需求作为对需求的引用导入,称为引用需求,并在第三方应用中继续管理它们。支持的应用程序包括:
Microsoft® Word 和 Microsoft Excel®。请参阅从 Microsoft Office 文档导入需求。
IBM® DOORS®.请参阅从 IBM DOORS 导入需求。
IBM DOORS Next。请参阅从 IBM DOORS Next 导入需求。
使用需求交换格式(ReqIF™)的应用程序。请参阅从 ReqIF 文件导入需求。
注意
Microsoft Windows® 平台支持从上面列出的所有应用程序导入需求。要从 Mac 或 Linux® 平台上的第三方应用程序导入需求,您必须使用 IBM DOORS Next 或使用 ReqIF 的应用程序。
MATLAB® Online™ 不支持从 Microsoft Word、Microsoft Excel 或 IBM DOORS 文档导入需求。
将需求添加到路径
将需求文档添加到 MATLAB 路径或工程路径。您可以:
将需求文档复制到 MATLAB 当前文件夹。
将需求文档的父文件夹添加到 MATLAB 路径。
更新 Requirements Toolbox 路径预设项以始终使用相对路径。
有关设置需求文档路径预设项的详细信息,请参阅 文档路径存储。
选择导入模式
当您从第三方应用程序导入需求到 Requirements Toolbox 时,您可以将需求迁移到 Requirements Toolbox 或继续在第三方应用中管理您的需求。
当您将需求迁移至 Requirements Toolbox 后,您不再需要使用第三方应用来更改您的需求。
如果您选择在第三方应用程序中管理需求,则需在第三方应用程序中对需求进行修改。然后,您需要更新 Requirements Toolbox 中引用的需求,以导入第三方应用程序中做出的更改。如果您从文件中导入需求,例如 Microsoft Word 或 ReqIF 文件,需求编辑器表示源文档有更新版本可用。
两种导入模式都可以让您访问 Requirements Toolbox 分析,例如变更跟踪(参阅跟踪需求链接的变更)、实现状态(参阅使用实现状态跟踪需求链接)和验证状态(参阅审查需求验证状态)。
将需求迁移至 Requirements Toolbox
如果要将需求从外部需求管理应用程序迁移到 Requirements Toolbox,则在导入需求时,请清除选择支持外部源更新。

需求被作为 slreq.Requirement 对象导入,并由需求编辑器和可追溯性矩阵中的需求图标 (
) 表示。将需求作为 slreq.Requirement 对象导入允许您自由地编辑、添加、删除和重新排列需求。您对第三方应用中的需求所做的更新不会反映在 Requirements Toolbox 中。
注意
您可以将存储在 Requirements Toolbox 中的需求导出到 ReqIF 文件,从而将您的需求导出回支持 ReqIF 文件的第三方应用程序。
使用外部应用程序管理导入的需求
如果您想继续使用外部应用程序管理导入的需求,请在导入需求时选择支持外部源更新。这些需求被导入为引用需求(slreq.Reference 对象)。
如果有人对外部源文档进行了更改,您可以在 Requirements Toolbox 中更新引用需求。在需求编辑器中,选择顶部的导入节点,由导入节点图标(
)表示。在右侧窗格中的需求交换下,点击更新。系统将提示您选择文件的最新版本。有关详细信息,请参阅更新导入的需求。

默认情况下,引用的需求被锁定,无法编辑。锁定的需求由需求编辑器中的锁定引用需求图标 (
) 表示。要解锁单个引用需求,请在需求编辑器中导航到该需求,然后在右侧窗格中的属性下点击解锁。已解锁的需求由需求编辑器中的已解锁引用需求图标 (
) 表示。通过导航到顶部的导入节点,然后在右侧窗格中的需求交换下点击全部解锁来解锁所有引用需求。即使解锁后,您也无法删除引用需求或更改 Requirements Toolbox 内它们的层次结构。解锁需求后,您无法重新锁定需求,除非更新整个引用需求集。更新引用需求将覆盖解锁引用需求后所做的更改。
您可以为包含 Requirements Toolbox 中引用需求需求集注册自定义属性。要设置引用需求的自定义属性值,您必须解锁该需求。有关注册自定义属性并根据需求设置其值的详细信息,请参阅 向需求添加自定义属性。当您在 Requirements Toolbox 内注册自定义属性并设置引用的需求自定义属性值时,从外部源更新引用需求时,这些值会被保留。但是,如果您修改从外部源导入的自定义属性值,则更新操作将覆盖对未锁定的引用需求所做的修改。
但是,一些第三方应用程序也允许您创建自定义属性。如果需求集和外部源文档中具有同名的属性,则当您从外部源更新引用需求时,本地值将被外部源文档中定义的属性值覆盖。
当处理引用需求时,您可以通过点击属性窗格中的在文档中显示导航到外部源文档中的需求。
注意
要从 ReqIF 文件导入的引用需求导航到原始外部源文档,请创建一个导航回调函数并在 MATLAB 中注册该函数。有关详细信息,请参阅从导入的需求导航至原始需求。
为了确保从 Microsoft Word 导入的引用需求的导航能够按预期工作,在导入需求之前,请在 Microsoft Word 文档中插入与需求相对应的书签。有关详细信息,请参阅 Microsoft 网站上的在 Word 文档或 Outlook 消息中添加或删除书签。
如果源文档的文件名或位置发生变化,请右键点击需求集的顶部节点并选择更新源文档名称或位置。
导入和直接链接之间的差异
Requirements Toolbox 还支持直接链接到存储在 Microsoft Word、Microsoft Excel、IBM DOORS 和 IBM DOORS Next 中的外部需求。
当您从第三方应用程序中的需求创建到 MATLAB 或 Simulink® 中的项的直接链接时,Requirements Toolbox 提供的分析工具不会涵盖这些需求。此外,根据到外部需求的直接链接的创建方式,您可能没有可见的反向链接来导航到 MATLAB 或 Simulink 中的链接项。例如,当您通过创建书签或标题链接来链接到 Microsoft Word 中的需求时,不会向 Microsoft Word 文档添加任何导航对象。(请参阅直接链接到 Microsoft Word 文档中的需求。)除非您运行一致性检查,否则没有任何迹象表明直接链接何时无法解析。
当您链接到导入的需求而不是创建直接链接时,您可以访问 Requirements Toolbox 分析工具,例如实现状态、验证状态、变更跟踪和可追溯性矩阵。此外,您还可以跟踪和导航链接源和目标,并在链接无法解析时接收指示。