使用 IBM DOORS Next 链接和跟踪需求

您可以通过导入 DOORS^® Next需求或使用直接链接，将 Simulink^®模型元素和支持的基于模型的设计工件链接并追踪到 IBM^® DOORS Next（以前称为 IBM DOORS Next Generation 或 DNG）中的需求。

如果从 IBM DOORS 导入需求到 Requirements Toolbox™ 旁边，导入的需求变为 slreq.Reference 对象，这种对象被称为引用需求。当需求在 DOORS 接下来发生变化时，您可以更新引用需求。导入的引用需求有助于了解实施状态、验证状态和变更跟踪。有关更多信息，请参阅从 IBM DOORS Next 导入需求。然后，您可以将 MATLAB^® 或 Simulink 基于模型的设计工件或其他可链接项与 Simulink 画布或需求编辑器中引用需求链接起来。您还可以从 Requirements Toolbox 中引用的需求导航到 DOORS Next 中的原始需求。

如果您使用直接链接来链接需求，那么您将在 MATLAB 或 Simulink 中的需求和 DOORS Next 工件之间创建一个链接。您可以建立可追溯性链接，并直接从 MATLAB 或 Simulink 基于模型的设计工件导航到 DOORS Next 需求。直接链接不需要您创建额外的文件，与导入不同，导入将需求存储在 .slreqx 文件中。然而，链接过程需要额外的设置步骤，并且IBM DOORS Next需求未包含在Requirements Toolbox分析中，例如实施状态、验证状态和变更跟踪。

无论使用哪种链接方法，您都可以在 DOORS Next 中插入反向链接，这些链接允许您从 DOORS Next 中的需求导航到 MATLAB 或 Simulink 中的工件。

配置 IBM DOORS Next 会话

为了与 IBM DOORS 接口，接下来，您必须在每个会话中配置 MATLAB。

在 MATLAB 命令提示符下，输入：
```
slreq.dngConfigure
```
在 DNG 服务器登录配置对话框中，输入 DOORS Next 服务器地址、端口号和服务根，就像访问 DOORS Next 时在 Web 浏览器中显示的一样。输入您的用户名和密码，或者输入自定义身份验证回调函数的名称。有关更多信息，请参阅 setCustomLoginProvider。点击确定。
如果您在 Web 浏览器中没有看到端口号，请输入默认值 443。
在 DOORS 工程对话框中，选择工程以及配置上下文（如果适用）。如果您的配置上下文未在选择配置流或更改集列表中列出，请通过选择 <更多> 来加载其他配置。要在配置列表中显示全局配置，请在 MATLAB 命令行中输入：
```
rmipref("OslcUseGlobalConfig",true);
```
有关更多信息，请参阅 rmipref 和指定并更新 IBM DOORS Next 配置。

提示

您还可以以编程方式在您的 MATLAB 会话和 IBM DOORS Next 服务器之间建立连接，而无需使用 DNG 服务器登录配置对话框或 DOORS 工程对话框。有关更多信息，请参阅 slreq.dngConfigure。

MATLAB 通过在浏览器中打开一个窗口来测试连接。如果连接成功，则会出现“MATLAB 连接器测试”对话框并显示确认消息。点击确定。如果输入 slreq.dngConfigure 后未出现对话框或者出现错误，请参阅使用 slreq.dngConfigure 的提示。

注意

如果您计划在 IBM DOORS 接下来创建指向需求的直接链接，则必须保持测试连接浏览器窗口打开，因为此 Web 浏览器实例已经过身份验证，可以与 MATLAB 进行通信。使用此网络浏览器在您的 IBM DOORS Next 工程中选择需求以创建直接链接。您可以通过在浏览器地址栏中复制并粘贴此地址来重新打开测试连接浏览器窗口：https://localhost:31515/matlab/oslc/inboundTest。

与引用需求相链接

当您想要链接 MATLAB 或 Simulink 中的需求并跟踪 Simulink 中的实施、验证和变更跟踪时，请使用这种方法。

首先，通过选择 DOORS Next 模块或创建查询来导入需求。有关更多信息，请参阅从 IBM DOORS Next 导入需求。

将 DOORS Next 需求导入需求集后，您可以按照链接其他 slreq.Reference 对象的方式链接这些引用需求。例如，您可以打开一个 Simulink模型或测试，选择一个模型元素或测试用例，然后在需求编辑器中创建指向所选引用需求的链接。您还可以通过点击并拖动需求视角中的某个需求来创建链接，而无需离开 Simulink模型。有关详细信息，请参阅：

如果在将需求导入Requirements Toolbox后在DOORS Next 中更新需求，则可以更新需求集以反映更改。有关更多信息，请参阅更新引用需求。如果更新更改或删除了具有链接的引用需求，则链接存在更改问题。有关更多信息，请参阅跟踪需求链接的变更。

创建链接后，您可以在需求编辑器中编辑链接类型。有关更多信息，请参阅链接类型。

在 DOORS Next 中插入反向链接

当您从模块DOORS Next导入需求，并从MATLAB或Simulink中的项目创建引用需求的链接时，您可以在DOORS Next模块中手动插入反向链接：

打开需求编辑器。在 MATLAB 命令提示符下，输入：
```
slreq.editor
```
在需求编辑器中，点击工具条中的显示链接以查看已加载的链接集。
选择包含您的DOORSNext模块中没有反向链接链接的链接集。右键点击链接集并选择更新反向链接。
对话框显示已检查的现有反向链接链接的数量以及已添加的反向链接的数量。点击确定。

您可以通过选择需求编辑器中的需求并点击在文档中显示来导航到原始需求。

当查看模块上下文之外的 DOORS Next 工程时，展开链接窗格，该窗格显示指向链接到下的 MATLAB 或 Simulink 的反向链接。在模块上下文中工作时，选择该项目。在右侧窗格中，选择选定工件，然后选择工件链接。反向链接显示在链接到下。

直接链接 DOORS Next 需求

当您希望直接链接到 DOORS Next 中的需求时，请使用这种方法。直接链接不需要导入需求。

设置完成后，您可以通过右键点击某个项目并使用上下文菜单，或使用“出向链接”对话框来建立直接链接。

使用上下文菜单链接到选定需求

当您使用上下文菜单链接到DOORS Next 中的需求时，您可以在创建链接时插入反向链接。您还可以在模块上下文和指定的流或变更集集中创建链接。如果您在模块上下文中创建链接并插入反向链接，则反向链接也会插入到模块上下文和指定的流或变更集集中。要了解有关流和变更集的更多信息，请参阅指定并更新 IBM DOORS Next 配置。使用上下文菜单链接到DOORS Next 中的需求需要在需求编辑器和 DOORS Next 服务器中进行额外的设置。

要使用上下文菜单创建链接，首先需要确保使用 IBM DOORS Next 启用了基于选择的链接。

通过在 MATLAB 命令提示符下输入以下内容来打开需求编辑器：
```
slreq.editor
```
在工具条的链接部分中，点击预设项。
在“需求设置”对话框中，在“选择链接”选项卡中，确保选择了“已启用的应用程序”旁边的“DOORS”。

在 IBM DOORS Next 中安装 MathWorks Requirements Toolbox 小组件并启用 dropins。有关更多信息，请参阅配置 IBM DOORS Next 服务器以与 Requirements Toolbox 集成。要确认小组件正在运行，请在您的 DOORS Next 工程中的工件选项卡中选择一个工程并验证小组件内容是否按预期更新。

提示

将迷您仪表板固定到页面上，以便它始终可见，并且您知道哪个选定的 ID 已传达给 MATLAB。

The MathWorks Requirements Toolbox widget is shown on the left in an open module in IBM DOORS Next.

您可以在DOORS Next 中验证MATLAB是否正在接收有关您选择的信息。在 MATLAB 命令提示符下，输入：

oslc.selection

返回的数字应与 DOORS Next 浏览器中所选项目的数字 ID 相对应。

当小组件运行时，您可以在使用上下文菜单时在 Simulink 可链接项和 DOORS Next 之间创建链接：

在您的 DOORS Next 工程中，选择工件选项卡。
通过选中需求旁边的复选框来选择您想要链接的需求。您选择的需求将显示在迷您仪表盘窗格中的 MathWorks Requirements Toolbox 小组件中。
在 Simulink 中，右键点击要链接到选定 IBM DOORS Next 需求的 Simulink 模型元素。从上下文菜单中选择需求 > 链接到 DOORS Next 中的所选项目。
出现 DOORS 链接目标对话框。如果小组件按预期运行，则工程区域和 需求 ID 字段将填充您选择的信息。
要在模块上下文中创建链接，请选择模块上下文中的链接。然后将模块上下文设置为需求所属的模块。
要在 DOORS 中插入反向链接，接下来，选择插入反向链接。如果在模块上下文中创建链接，则反向链接也会插入到模块上下文中。
点击确定创建链接，如果选择，则插入反向链接。

The mouse points to the Link to Selected Item(s) in DOORS Next selection in the context menu.

要导航到 DOORS 中的链接需求，接下来，右键点击相同的 Simulink模型元素并选择需求。该链接出现在上下文菜单的顶部。

如果 IBM DOORS Next 中的小组件不可用或由于安全限制而无法与 MATLAB 通信，则可以在不选择 DOORS Next 中的需求的情况下创建链接：

在 Simulink 中，右键点击要链接到选定 IBM DOORS Next 需求的 Simulink 模型元素。从上下文菜单中选择需求 > 链接到 DOORS Next 中的所选项目。
出现 DOORS 链接目标对话框，但未填充任何信息。将工程区域设置为您想要处理的工程。
在需求 ID 字段中，输入您想要链接到的需求的 DOORS Next 数字 ID。
要在模块上下文中创建链接，请选择模块上下文中的链接。然后，将模块上下文设置为需求所属的模块。
注意
如果您在模块上下文中创建指向需求的链接，然后在同一模块中创建更多指向需求的链接，则这些链接将在模块上下文中创建。
要在 DOORS 中插入反向链接，接下来，选择插入反向链接。如果在模块上下文中创建链接，则反向链接也会插入到模块上下文中。
点击确定创建链接，如果选择，则插入反向链接。

使用出向链接对话框链接到需求

使用“出向链接”对话框中的“索引”选项卡创建链接不需要“MATLAB”和系统浏览器之间的通信。

右键点击要链接到 IBM DOORS Next 需求的 Simulink 模型元素。
选择需求 > 打开 "出向链接" 对话框。
在“出向链接”对话框中，点击新建并将文档类型设置为 IBM DOORS Next。
点击浏览。在 DOORS 工程对话框中，选择要使用的工程，然后根据工程选择配置上下文。如果您的配置上下文未在下拉列表中列出，请选择 <更多> 来加载更多配置。
下一步取决于您是否要链接到模块上下文中的需求。
- 如果您想在模块上下文中创建链接：
  1. 点击“文档索引”选项卡即可查看模块名称列表。
  2. 双击要链接到的模块。
  3. 当列表更新时，选择您想要链接到的需求。
- 如果您的工程没有模块，或者您不想在模块上下文中创建链接，请在位置字段中输入 DOORS Next 链接目标需求的数字 ID。
要创建链接，点击确定或应用来创建链接。

The Outgoing Links dialog shows a single requirement from IBM DOORS Next to create a link to.

当您使用“出向链接”对话框中的“索引”选项卡或在对话框中输入 ID 来创建链接时，创建的链接是不带反向链接的。创建链接后，您可以在 DOORS Next 工程中插入反向链接，以满足缺少反向链接的需求。请参阅插入缺失的反向链接。

插入缺失的反向链接

如果您的 DOORS Next 工程中的需求不包含反向链接，因为创建链接时未插入反向链接或者反向链接已被删除，则您可以插入缺失的反向链接：

打开 Simulink模型或其他包含指向 DOORS Next 中需求的直接链接的工件。
通过在 MATLAB 命令提示符下输入以下内容来打开需求编辑器：
```
slreq.editor
```
选择显示链接，然后选择包含不包含反向链接的链接集。
右键点击链接集并选择更新反向链接。出现“反向链接检查”对话框并显示添加的缺失反向链接的数量。

注意

当您使用此方法插入缺失的反向链接时，将为目标工程与您当前配置的 DOORS Next 工程匹配的链接集中的直接链接添加反向链接。如果您的链接集包含指向其他 DOORS Next 工程的链接，则这些链接将不会被处理。您需要为其他工程重新配置 MATLAB 会话后，重新运行更新反向链接程序，以便在其他工程中插入反向链接。

当您更新反向链接时，如果 Requirements Toolbox 中的原始链接不再存在，软件将从外部文档中删除反向链接。有关更多信息，请参阅管理外部需求文档中的导航反向链接。

注意

Requirements Toolbox 仅当 MATLAB 中的当前配置上下文与 IBM DOORS 中的配置上下文匹配时，才会删除反向链接。

DOORS Next 中的反向链接对此配置上下文的用户可见，包括无权访问 MATLAB 或 Simulink 源工件的用户。

在 DOORS Next 需求和直接链接项目之间导航

一旦您将 MATLAB 或 Simulink 中的可链接项直接链接到 DOORS Next 需求，您就可以使用需求编辑器从 MATLAB 导航到该需求。

通过在 MATLAB 命令提示符下输入以下内容来打开需求编辑器：
```
slreq.editor
```
选择显示链接并选择您想要导航的链接。
在右侧窗格中，在属性下，点击目标旁边的超链接以导航到 DOORS Next 中的需求。

如果您在 DOORS Next 工程中插入了反向链接，那么您可以从 DOORS Next 中的需求导航到 MATLAB 或 Simulink 中的链接工程：

在您的 DOORS Next 工程中，在所需的流或变更集，选择工件选项卡。
选择所需的需求。如果需求在模块上下文中链接，请在该模块上下文中选择该需求。
在右侧窗格中，确保已选择选择选定工件选项卡。
在右侧窗格中，选择工件链接。
在链接到下，点击反向链接即可导航到 MATLAB 或 Simulink 中的链接项目。

A requirements module in IBM DOORS Next is shown. A requirement is selected and in the right pane, the Selected Artifact tab is selected and shows the backlink to a Simulink model element.

如果您没有在 DOORS Next 工程中插入反向链接，您可以使用 MathWorks Requirements Toolbox 小组件来查询给定需求的链接。

在您的 DOORS Next 工程中，在所需的流或变更集，选择工件选项卡。
选择所需的需求。确保 MathWorks Requirements Toolbox 小组件更新以反映所选需求。
在 MathWorks Requirements Toolbox 小组件中，点击从 SL 查询链接。来自 MATLAB/Simulink 的链接窗口在浏览器中打开。

注意
必须加载 MATLAB 或 Simulink 中的链接工件，链接才会出现在浏览器窗口中。
点击源对象下的超链接可以导航到 MATLAB 或 Simulink 中的项目。

指定并更新 IBM DOORS Next 配置

在 IBM DOORS Next 中启用了配置管理的工程支持多个称为流和变更集的分支（也称为配置）。Requirements Toolbox 可让您将 Simulink 中现有链接的出向链接目标更新为不同流或变更集的相同需求。

指定配置流或变更集

选择 IBM DOORS Next 工程以及您想要使用的流或变更集。在 MATLAB 命令提示符下，输入：

slreq.dngConfigure

有关该函数的更多信息，请参阅 slreq.dngConfigure。

通过 API 更新存储的流或变更集

Requirements Toolbox 提供了当您的流或变更集变化时管理 DOORS Next需求的函数：

使用 slreq.dngCountLinks 查找 slreq.LinkSet 对象中指向特定 DOORS Next 流或变更集的链接数。
使用 slreq.dngGetProjectConfig 查询 DOORS Next 工程中的已知流或变更集。
使用 slreq.dngGetUsedConfig 识别 slreq.LinkSet 对象中链接的流或变更集。
当流或变更集随着 slreq.dngUpdateConfig 而改变时，更新现有链接以指向 DOORS Next需求的不同流或变更集。

使用 MathWorks Requirements Toolbox 小组件同步和更新会话上下文

MathWorks Requirements Toolbox 小组件显示有关 Requirements Toolbox 中当前配置流上下文的信息。该小组件通过以红色显示和突出显示活动的Requirements Toolbox 配置流上下文来指示 Requirements Toolbox 和 IBM DOORS Next 中的活动配置流上下文不匹配：

The MathWorks Requirements Toolbox widget in IBM DOORS Next shows the configuration context with red text to indicate that there is a mismatch.

要解决不匹配问题，点击小组件中红色突出显示的文本，然后点击 DNG 配置上下文不匹配对话框中的更新。或者，您可以在 IBM DOORS Next 中更改活动配置流。

您可以使用通过 API 更新存储的流或变更集中列出的函数或使用 MathWorks Requirements Toolbox 小组件中的从 SL 查询链接超链接来更新现有链接的配置上下文。

在 DOORS 接下来，在 MathWorks Requirements Toolbox 小组件下，点击从 SL 查询链接。浏览器中将打开一个新窗口，其中列出了“DOORS Next”中所选需求的链接摘要。
点击托管链接配置超链接将显示当前 MATLAB 会话中的 DOORS Next 链接的报告，并按目标配置上下文属性分组。
点击“重定向”选择您想要与不同配置上下文关联的链接组。
当窗口更新时，点击您想要关联的流或变更集。
找到您更新了其链接的流或变更集之一，并确认该链接现在将带您到达所链接需求的预期配置。