使用可追溯性矩阵跟踪需求链接

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

可追溯性矩阵使您可以轻松查看需求及其与其他项目的链接。可追溯性矩阵显示需求、模型或测试实体、数据字典和代码之间的链接，并允许您导航到链接源或目的地。例如，您可以：

查看项目之间的链接。
创建和删除链接。
检查并导航链接源和目的地。
将显示焦点集中在特定工件或项目的层次结构上。
将特定于工件的过滤器应用于行、列和单元格。
查看并突出显示未链接的项目。
查看并突出显示与变更问题相关的项目并清除变更问题。
当选择多个单元格时执行批量操作。
保存并加载视图设置以重新生成矩阵。

生成可追溯性矩阵

您可以创建包含两个或更多工件的可追溯性矩阵。您可以使用：

Requirements Toolbox™ 需求集
Simulink^® 模型
System Composer™ 模型
Simulink Test™ 测试文件
Simulink 数据字典
MATLAB^® M 文件

要打开可追溯性矩阵窗口，请使用以下方法之一：

在需求编辑器中，点击可追溯性矩阵。
在 Simulink模型中，在需求选项卡中，选择共享 > 打开需求可追溯性矩阵。
在 MATLAB 命令行中，输入：
```
slreq.generateTraceabilityMatrix
```

要创建可追溯性矩阵：

在可追溯性矩阵窗口中，点击添加。
生成包含两个工件或多个工件的矩阵。
- 要创建仅包含两个工件的矩阵，请从“选择工件”对话框中选择左侧和顶部工件。
- 要创建包含多个工件的矩阵，点击“选择多个工件”。在配置矩阵对话框中，通过点击并拖动，将可用工件窗格中的工件添加到左侧或顶部工件列表，或者右键点击工件并选择添加到左侧或 添加到顶部。通过指向工件并点击删除图标（），或者右键点击工件并选择删除工件，可以从列表中删除工件。
点击生成矩阵。您可以通过点击配置矩阵，重新配置工件，然后点击更新矩阵来重新配置矩阵中的工件。

该图中的工件是一需求集和一个Simulink模型。需求列在左边，Simulink模型的模块列在顶部。

Example traceability matrix with two artifacts. The links point from the Simulink blocks on the top to the requirements on the left.

如果您对工件进行了更改，点击更新来刷新您的可追溯性矩阵。

注意

未解析的链接不会显示在可追溯性矩阵中。

当您创建具有多个工件的可追溯性矩阵时，一条蓝色实线表示工件之间的分界。

Example traceability matrix with five artifacts. The requirement sets are on the left, and the Simulink models and tests are on the top. The links point from the Simulink items to the requirements.

配置具有多个工件的矩阵

当您创建或更新包含多个工件的矩阵时，可以使用“配置矩阵”对话框通过点击并拖动将工件从一个列表移动到另一个列表来排列工件，或者通过在列表内拖动工件来重新排序列表。

按住 Ctrl 并选择多个工件，您可以一次添加、删除或排列多个工件。

当您在可用工件窗格中选择一个工件时，任何包含所选工件之间的链接的工件都会被突出显示。当您将工件添加到矩阵配置时，矩阵预览中的展开图标 () 表示工件之间存在链接。

为了能够将工件添加到可追溯性矩阵中，工件必须满足以下任一条件：

加载到您的 MATLAB 工作区或 Simulink
包含已加载工件的链接
与已加载的链接集相关联

修改可追溯性矩阵视图

可追溯性矩阵是一个网格，其中行对应于左侧工件中的项目，列对应于顶部工件中的项目。单元格中的箭头图标 () 表示该行和列中的项目之间存在链接。箭头图标从源项指向目标项。

点击箭头图标时，您会看到有关该链接的信息。

Link information displayed when you click on a link. The information box includes the link source, destination, summary, and type.

有关以编程方式修改可追溯性矩阵视图的更多信息，请参阅

展开和折叠链接

最初，矩阵中的某些行和列可能会折叠。当链接因包含链接项的行或列中的一个或两个层次结构被折叠而变得模糊时，会显示展开图标 ()。要展开层次结构，请双击展开图标 ()。

点击展开图标时，您会看到与该单元格相对应的左侧和顶部的项目。

Cell information displayed when you click the expand icon. The information box includes the left and top item associated with the cell and the existing links.

当您点击信息框中的项目时，该项目将在与该工件类型关联的应用程序中打开。例如，如果您点击某个需求，则需求编辑器窗口将打开并显示指定的需求。

聚焦显示

您可以重点显示可追溯性矩阵中特定项目的层次结构。选择要显示其层次结构的工件或项目。点击作用域或右键点击该项目并点击聚焦显示。

Context menu that appears when you right click an item in a row or column of the matrix

您的可追溯性矩阵仅显示层次结构的选定部分。要显示工件的整个层次结构，请再次右键点击该工件，然后点击“显示整个层次结构”。

对于具有多个工件的矩阵，您还可以通过点击矩阵顶部列表中的工件来将显示焦点集中在其中一个工件上。要从一个工件中删除焦点，点击矩阵顶部的工件列表中的显示全部。

Artifact list after the user clicks an artifact. The selected artifact is replaced with a Show All link.

要展开工件的层次结构，请右键点击要展开其层次结构的工件，然后点击全部展开。要折叠工件的层次结构，请右键点击要折叠其层次结构的工件，然后点击全部折叠。

应用过滤器

您可以将来自过滤器面板的过滤器应用于顶部工件、左侧工件或单元格。点击该过滤器即可应用它，再次点击即可将其删除。

每个工件都有特定类型的过滤器。当您创建具有多种工件类型的可追溯性矩阵时，窗格会按工件类型列出过滤器并使用图标来指示类型。缺失链接过滤器和单元格下的所有过滤器始终出现。

Default view of the filter panel, with sections to apply filters to the top artifacts, left artifacts, or the cells. Each section has sub-sections that appear based on the context of the items and artifacts in the matrix.

如果您对某个工件应用过滤器，则矩阵仅显示具有这些特定属性的项目。例如，如果在顶部下点击缺失链接，则可追溯性矩阵仅显示来自顶部工件且未链接到其他项目的项目。但是，如果父项不具备这些特定属性，但其一个或多个子项具备这些属性，则父项及其链接会出现在矩阵中，但会变暗。例如，如果将叶模块过滤器应用于模型，则矩阵将显示包含叶模块的子系统模块，但会使子系统模块变暗并链接到子系统模块。

如果对单元格应用过滤器，矩阵将仅显示具有这些属性的链接。但是，没有省略任何行或列。例如，如果在单元格下点击有更改问题，则可追溯性矩阵仅显示存在更改问题的链接，但显示所有行和列。

当您向可追溯性矩阵的左侧或顶部工件添加过滤器时，该过滤器会出现在矩阵顶部工件名称的旁边。您可以通过点击清除过滤器来清除过滤器，或者在过滤器面板中再次点击过滤器来清除过滤器。

Artifact list for a matrix with two artifacts with filters applied

如果您的可追溯性矩阵中的一个工件是 Simulink模型，那么您可以应用缺失预期的链接过滤器。此过滤器显示未链接的 Simulink 模块或需要链接才能满足 HISL 0070 (Simulink) 的子系统。

突出显示缺失的链接

要突出显示可追溯性矩阵中未链接的单元格，点击突出显示缺失链接。可追溯性矩阵中未链接的项目以黄色突出显示。

Traceability matrix with highlighting applied to unlinked items

即使未链接的项目在当前矩阵视图中不可见，它们也会被突出显示。查看整个可追溯性矩阵的层次结构以查看所有缺少链接的项目。请参阅聚焦显示。

保存视图设置

您可以将可追溯性矩阵的视图设置保存到文件中，然后加载该文件并使用相同的视图设置重新生成矩阵。要保存视图设置，请在视图部分中点击视图设置 > 保存视图设置。视图设置文件包含以下设置：

顶层工件
左侧工件
顶层过滤
左侧过滤器
单元格过滤器
突出显示
矩阵设置

要加载视图设置文件并重新生成矩阵，点击添加。然后，点击加载视图并选择视图设置文件。

使用可追溯性矩阵中的链接

添加新链接

通过点击单元格创建链接，然后点击信息框中的创建链接或创建，即可在行中的项目和列中的项目之间创建链接。

Information box that appears when you click on a cell

Create Link dialog box, showing the pre-populated Source and Destination and the Type property

创建链接窗口填充链接源和目标。您可以通过点击反向按钮 () 来反转链接源和目标。该链接保存在与源项所属的工件相关联的链接集中。如果不存在与该工件相关联的链接集，则将创建与该工件同名的链接集。

注意

如果您使用对左侧和顶部工件的相同需求集创建可追溯性矩阵，则无法创建源项和目标项具有相同需求的链接。您也无法创建以需求集为源项或目标项的链接。

删除链接

通过点击包含链接的单元格并点击删除链接或按 Del 来删除链接。出现“删除链接”对话框，并显示链接工件、类型和标签。点击删除删除链接。

查看并清除链接的变更问题

如果与链接相关的需求发生变化，则链接存在变更问题。要了解如何启用更改跟踪并使用需求编辑器查看和清除更改问题，请参阅跟踪需求链接的变更。要以编程方式跟踪和清除更改问题，请参阅 slreq.getChangeInformation 和 slreq.clearChangeIssues。

您可以通过应用有更改问题过滤器或选择 突出显示缺失链接 > 仅显示更改的链接 来查看可追溯性矩阵中存在变更问题的链接。您可以通过点击 突出显示缺失链接 > 突出显示更改的链接 来突出显示存在变更问题的链接。存在变更问题的链接对应的行、列和单元格以红色突出显示。

Traceability matrix showing only changed links and their corresponding items

要清除链接的更改问题，请选择包含该链接的单元格，然后点击清除更改问题。

对多个单元执行批量操作

通过点击并拖动，或者按住 Shift 并点击单元格来创建矩形单元格选择。您可以按下 Ctrl 并点击来切换选择中的单元格或创建单个单元格的选择。

当您选择多个单元格时，您可以一次添加或删除链接，或者清除多个链接的更改问题。

导出可追溯性矩阵

您可以将可追溯性矩阵导出为 HTML 报告、包含表格数据的 MATLAB 变量或 Excel^® 电子表格。

导出到 HTML 报告

点击导出 > 生成 HTML 报告 生成 HTML 报告。命名并保存报告。报告自动打开。

HTML 报告不是交互式的。通过聚焦显示、折叠或展开层次结构、或应用过滤器和突出显示来创建想要导出的视图。HTML 报告列出了矩阵中工件的文件路径，以及焦点显示、应用的过滤器和突出显示。

导出到 MATLAB 变量

通过点击导出 > 创建 MATLAB 变量，创建包含表数据的 MATLAB 变量。变量 slrtmxData 在基础 MATLAB 工作区中创建。如果您的工作区中已经有一个变量 slrtmxData，那么该变量将被覆盖。

导出的 MATLAB 变量不是交互式的，但具有 MATLAB 表的功能。请参阅表。通过聚焦显示或应用过滤器来创建您想要导出的视图。MATLAB 表包含折叠层次结构中的项目，但不包括突出显示。

导出至 Excel

要将可追溯性矩阵导出至Excel，点击导出 > 导出为 Excel。

Excel 电子表格不是交互式的。在导出矩阵之前，通过聚焦显示、折叠或展开层次结构、或应用过滤器和突出显示来创建要导出的视图。电子表格列出了矩阵中工件的文件路径，并显示了导出前应用的设置。

使用可追溯性矩阵以编程方式工作

您还可以以编程方式创建可追溯性矩阵。使用 slreq.getTraceabilityMatrixOptions 创建一个结构体，并通过提供包含工件列表的元胞数组来设置 leftArtifacts 和 topArtifacts 字段。

您可以通过修改选项结构体中的 slreq.matrix.Configuration 对象以编程方式修改现有过滤器或添加新过滤器。然后使用以结构体为输入参量的slreq.generateTraceabilityMatrix 函数来生成具有指定工件的矩阵。请参阅以编程方式生成可追溯性矩阵。

另请参阅