Main Content

Resolve Missing Artifacts, Links, and Results

Issue

The Model Design and Model Testing Dashboards uses a digital thread to analyze artifacts—including models, code, requirements, tests, and results—that are part of the model design and testing workflow for software units and components.

An artifact or a link between artifacts might not appear in the dashboard or contribute to the metric results if:

  • The artifact or link is not supported by the digital thread.

  • The artifact or link is not part of the workflow.

Possible Solutions

If you expect a link or an artifact to appear in the dashboard and it does not, try one of these solutions.

Save Artifacts in Project

The digital thread only analyzes artifacts that are saved inside the project or referenced projects.

  • Save changes to your artifact files.

  • Make sure that your artifacts are in the project or referenced projects.

  • Check that any referenced projects have unique project names.

Address Artifact Issues

The digital thread needs to be able to find, analyze, and trace artifacts.

  • Investigate artifact issues by clicking Artifact Issues in the toolstrip. For more information, see View Artifact Issues in Project.

  • Address warnings and errors.

    • Warnings indicate that the digital thread does not support that specific artifact, modeling construct, or relationship.

    • Errors indicate that the digital thread was not able to properly analyze artifacts, trace artifacts, or collect metrics, so the metric data in the dashboard widgets might be incomplete.

  • Do not change the search path while the dashboard is open.

If these solutions do not resolve the issue, close the dashboard and check that design artifacts, like models and requirements, are on the MATLAB® search path before you open the dashboard. Generated artifacts, like generated code files and test results, do not need to be on the search path.

Check If Artifact Can Contribute to Metric Results

Only artifacts that are directly related to the unit or component can contribute to the metric results in the dashboard. For information on what qualifies as a unit or component, see Categorize Models in Hierarchy as Components or Units.

Artifacts in the following folders in the Artifacts panel are for reference only, are not directly related to the unit or component that you selected, and do not contribute to the metric results shown in the dashboard:

  • Functional Requirements > Upstream

  • Tests > Others

  • Test Results > Others

  • Trace Issues

If you expect an artifact to appear in a specific folder and it does not, see Manage Project Artifacts for Analysis in Dashboard.

Avoid Unsupported Features

Certain features cannot be supported because they prevent the digital thread from properly identifying and tracing the relationships between artifacts.

Unsupported features have:

  • Unsaved information — The digital thread needs to capture the attributes and structure of the artifacts in your project. If an artifact has unsaved changes or relies on unsaved information, the information is not reliable and is incompatible with artifact traceability analysis.

  • Ambiguous relationships — The digital thread needs to capture the traceability relationships between the artifacts in your project.

  • A limitation in the digital thread — The digital thread is unable to analyze certain artifacts and relationships. For information on the digital thread, see Monitor Artifact Traceability and Detect Outdated Results with Digital Thread.

Affected ArtifactUnsupported FeaturesRationale
ModelModels saved in R2012a or earlierLimitation
Model callbacks

Unsaved information and ambiguous relationships

LibrarySelf-modifiable maskUnsaved information — Self-modifiable masks can change the structural content of a block.

Library forwarding table

Unsaved information and ambiguous relationships

Test

MATLAB-based Simulink® test

Limitation
Test HarnessTest harness on a library block instance subsystemAmbiguous relationships
Test ResultTest results from an unsupported testLimitation
Coverage Result

Aggregated coverage for external C code, such as S-function and C Caller blocks

Limitation — You must manually verify any external C code that you develop.
Coverage results for shared code filesLimitation
External MATLAB CodeMethods declared in separate filesLimitation
Requirement links

Embedded links (requirement links that are saved directly in the model file)

Limitation

Links to requirements that are saved externally and linked using the Requirements Management Interface (RMI)

Limitation
Links to custom requirements that you defined using stereotypesLimitation

Links inside:

  • Requirement Table blocks

  • Test Sequence blocks

  • Test Assessment blocks

Limitation

Links in requirement files that have the .req extension

Limitation — REQ files are from the legacy Requirements Management Interface (RMI). Save the links in an SLMX file or create them in an SLREQX file that has the requirements.

Links to models for which the model file extension changed

Limitation — If a requirement is linked to a model with the file extension .slx, but you change the model file extension to .mdl, the digital thread lists the requirement link as unresolved. Modify the requirement link to reference the expected model file and resave the requirement link.
Links to unsupported modeling elementsLimitation
Custom link types that you defined by using stereotypesLimitation

Requirement link to a justification

Limitation — If a requirement is linked with a justification and not linked to a test, the requirement appears as unlinked in the metric results.

Ambiguous links:

  • Link set shadows another loaded link set of the same name

  • Requirement set shadows another loaded requirement set of the same name

  • Link is not on the project path or is only temporarily on the project path

  • Link path format is an absolute path

  • Source artifact of the link set does not use the default link file name and location

Ambiguous relationships
Links

Symbolic file links in a project, such as shortcuts

Limitation

See Also

Related Topics