Main Content

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

在验证状态中包含来自外部来源的结果

Requirements Toolbox™ 允许您在需求编辑器中包含来自外部来源的结果的验证状态。您可以总结需求验证状态，编写自定义域注册，并编写自定义逻辑来获取结果。有关更多信息，请参阅 审查需求验证状态。

您还可以包括来自以下方面的测试结果：

  • 持续集成 (CI) 服务器，例如 Jenkins

  • 手动或使用测试脚本更新自定义结果

您可以创建自定义文档界面，将来自外部环境的测试结果解释成特定于您的开发环境的语言。有关更多信息，请参阅 定义自定义文档界面以直接链接到需求。

您可以使用内置验证服务来解释大多数常见情况的结果文件，例如 JUnit 和 TAP（Test Anything Protocol），以将外部测试结果包含在需求验证状态中。

当您在需求中包含外部测试结果的验证状态时：

  • 外部结果列在需求编辑器的 已验证列中，以及来自其他来源的结果，例如模型验证模块和 Simulink® Test™ 测试文件。

  • 通过/失败指示反映在需求链接中。

  • 结果状态会自动跨需求层次进行聚合。

  • 随着需求的添加或删除，结果状态会自动更新。

如何从外部来源填充验证结果

通常，外部测试结果在 MATLAB® 环境之外运行和管理。测试结果可以是：

  • 运行测试脚本或其他生成结果文件的程序

  • 使用自定义 TestRunner 对象运行 MATLAB 单元测试用例（有或没有 CI 服务器）

您可以通过以下方式创建测试结果的链接：

  • 直接链接到结果文件。外部结果工件用作链接目的地，需求用作链接源。要创建自定义文档接口，您需要：

    1. 文件位置

    2. 文件格式（例如，JUnit 或 Excel®）

    详情请参阅链接到结果文件。

  • 链接到测试脚本并提供根据该测试位置获取结果的代码。外部测试工件作为链接目的地，需求作为链接源。GetResultFcn 函数中的自定义逻辑应该找到与测试工件相对应的结果工件并从该结果工件中获取结果。请参阅链接到测试脚本。

以下步骤用于从外部源创建链接并从中填充验证状态：

  1. 创建和注册自定义文档接口：创建并注册自定义文档接口。有关更多信息，请参阅 定义自定义文档界面以直接链接到需求。

  2. 从需求链接到测试结果文件或测试脚本：使用出向链接编辑器或slreq.createLink将需求链接到结果文件。

    注意

    为了避免结果过时，请确保结果文件的时间戳比链接创建的时间戳新。如果在 GetResult 函数返回的结果中没有提到时间戳或者将其设置为 NaT，则会跳过陈旧性检测。

  3. 显示验证状态：在需求编辑器中，查看已验证列以查看验证状态。详情请参阅显示验证状态。

  4. 刷新需求视图：测试运行后，点击刷新 按钮刷新验证状态。

您可以通过点击需求编辑器中的 报告 > 生成报告 将来自外部来源的验证状态包含在需求报告中。

从外部来源填充验证结果时：

  • 在将代码与 rmi register 集成之前，先测试 GetResultFcn 代码。有关 GetResultFcn 的更多信息，请参阅 定义自定义文档界面以直接链接到需求。

  • 确认出向链接编辑器中的自定义链接类型注册。

  • 当单个文件包含许多链接的结果时，使用缓存来提高性能。

  • 在GetResultFcn代码中插入断点，然后使用刷新 按钮重新执行它。

  • 使用工程时，在工程启动或关闭脚本中使用时注册和取消注册自定义链接类型。

相关示例

详细信息