Resolve Missing Artifacts, Links, and Results
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.
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
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 Artifact||Unsupported Features||Rationale|
|Model||Models saved in R2012a or earlier||Limitation|
Unsaved information and ambiguous relationships
|Library||Self-modifiable mask||Unsaved information — Self-modifiable masks can change the structural content of a block.|
Library forwarding table
Unsaved information and ambiguous relationships
MATLAB-based Simulink® test
|Test Harness||Test harness on a library block instance subsystem||Ambiguous relationships|
|Test Result||Test results from an unsupported test||Limitation|
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 files||Limitation|
|External MATLAB Code||Methods declared in separate files||Limitation|
Embedded links (requirement links that are saved directly in the model file)
Links to requirements that are saved externally and linked using the Requirements Management Interface (RMI)
|Links to custom requirements that you defined using stereotypes||Limitation|
Links in requirement files that have the
|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 |
|Links to unsupported modeling elements||Limitation|
|Custom link types that you defined by using stereotypes||Limitation|
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.|
Symbolic file links in a project, such as shortcuts