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

getAvailableMetricIds

返回可用度量的度量标识符

自 R2021b 起

全页折叠

    语法

    availableMetricIds = getAvailableMetricIds(metricEngine)
    availableMetricIds = getAvailableMetricIds(metricEngine,'App','DashboardApp','Dashboard',dashboardIdentifier)
    availableMetricIds = getAvailableMetricIds(___,'Installed',installationStatus)

    说明

    availableMetricIds = getAvailableMetricIds(metricEngine) 返回指定 Metric.engine 对象可用的度量的度量标识符。默认情况下，该列表仅包含当前安装可用的度量。

    availableMetricIds = getAvailableMetricIds(metricEngine,'App','DashboardApp','Dashboard',dashboardIdentifier) 返回与 dashboardIdentifier 关联的度量标识符。

    例如，以下代码返回模型测试仪表板的度量标识符：

    availableMetricIds = getAvailableMetricIds(metricEngine,...
'App','DashboardApp',...
'Dashboard','ModelUnitTesting');

    有关显示设计成本估算度量标识符的附加语法，请参阅 getAvailableMetricIds (Fixed-Point Designer)。

    示例

    availableMetricIds = getAvailableMetricIds(___,'Installed',installationStatus) 返回度量标识符，并按 installationStatus 进行过滤。

    例如，将 installationStatus 指定为 false 可以让您返回每个可用度量的度量标识符，即使关联的 MathWorks® 产品当前未安装在您的计算机上。

    示例

    全部折叠

    收集工程中基于需求的测试工件的度量结果。

    打开一个包含模型和测试文件的工程。对于此示例，在 MATLAB® 命令行窗口中，输入：

    openExample("slcheck/ExploreTestingMetricDataInModelTestingDashboardExample");
openProject("cc_CruiseControl");

    为工程创建一个 metric.Engine 对象。

    metric_engine = metric.Engine();

    更新 metric_engine 的追溯信息，确保工件信息是最新的。

    updateArtifacts(metric_engine)

    通过将仪表板标识符指定为 'ModelUnitTesting'，创建模型测试仪表板的可用度量标识符列表。

    metric_ids = getAvailableMetricIds(metric_engine,...
'App','DashboardApp',...
'Dashboard','ModelUnitTesting');

    通过对度量标识符列表执行度量引擎来收集结果。

    execute(metric_engine,metric_ids);

    输入参数

    全部折叠

    要收集度量结果的度量引擎对象，指定为 metric.Engine 对象。

    仪表盘标识符，指定为以下值之一：

    • "ModelMaintainability" - 返回模型可维护性仪表板使用的模型可维护性度量标识符。

    • "ModelUnitPILTesting" - 返回 PIL 代码测试仪表板使用的处理器在环 (PIL) 代码测试度量标识符。

    • "ModelUnitSILTesting" - 返回 SIL 代码测试仪表板使用的软件在环 (SIL) 代码测试度量标识符。

    • "ModelUnitTesting" - 返回模型测试仪表板使用的模型测试度量标识符。

    注意

    对于工程模型测试度量，您可以使用 executeDashboardMetrics 函数以编程方式收集度量。然后，要查看工程度量结果，请使用工程模型测试仪表板中的小组件，如 工程测试状态总结 所示。

    示例: "ModelUnitTesting"

    过滤度量安装状态，指定为以下值之一：

    • 1 (true) - 仅返回与当前安装在您计算机上的 MathWorks 产品关联的度量标识符。

    • 0 (false) - 返回每个可用度量的度量标识符，即使关联的 MathWorks 产品当前未安装在您的计算机上。您可以利用每个可用度量标识符的列表来访问在另一台计算机上收集的度量结果。

    示例: false

    数据类型: logical

    输出参量

    全部折叠

    可用指标的度量度量，以字符串或字符串数组的形式返回。

    有关度量及其标识符的信息，请参阅：

    示例: "slcomp.mt.CoverageBreakdown"

    示例: ["slcomp.mt.CoverageBreakdown", "RequirementWithTestCaseDistribution", "RequirementsPerTestCaseDistribution", "slcomp.mt.TestsStatusDistribution", "TestCaseTagDistribution", "TestCaseTypeDistribution", "TestCaseVerificationStatusDistribution", "TestCaseWithRequirementDistribution", "TestCasesPerRequirementDistribution"]

    版本历史记录

    在 R2021b 中推出

    全部展开

    另请参阅

    | | | |

    主题