setDestination

R2026b

Class: slreq.Link
Namespace: slreq

Set requirement link destination

Syntax

setDestination(myLink,dest)

Description

setDestination(myLink,dest) sets the link destination to the item specified by dest for the link myLink.

Input Arguments

myLink — Link

slreq.Link object

Link, specified as an slreq.Link object.

dest — Link destination item

string scalar | character vector | double | slreq.Requirement object | slreq.Reference object | ...

Link destination item, specified as a:

• slreq.Requirement or slreq.Reference object

• String scalar or character vector that lists the name of a Simulink^® model or path to a Simulink block or subsystem, a Stateflow^® chart, or a System Composer™ port or component

• Handle to a Simulink block or subsystem or a System Composer port or component

• Stateflow.Chart (Stateflow), Stateflow.State (Stateflow), or Stateflow.Transition (Stateflow) object

• Simulink.data.dictionary.Entry (Simulink) object

• sltest.testmanager.TestFile (Simulink Test), sltest.testmanager.TestSuite (Simulink Test), sltest.testmanager.TestCase (Simulink Test), or sltest.testmanager.TestIteration (Simulink Test) object

• Fault (Simulink Fault Analyzer), Conditional (Simulink Fault Analyzer), SpreadsheetCell (Simulink Fault Analyzer) (since R2023b), SpreadsheetRow (Simulink Fault Analyzer) (since R2024b), Event (Simulink Fault Analyzer), Gate (Simulink Fault Analyzer), or FailureModel (Simulink Fault Analyzer) object (since R2026b)

• slreq.TextRange object (since R2022b)

• RequirementRow object (since R2026a)

• String scalar or character vector that specifies the path to a MAT file (since R2024b)

Examples

Find and Repair Broken Links

This example shows how to find and repair broken links.

Load the myAddRequirements requirement set, which links to lines of code in myAddBroken.m.

rs = slreq.load("myAddBroken");

Get a handle to the link set.

myLinkSet = slreq.find(Type="LinkSet");

Find the broken links in the link set. Display the number of broken links.

brokenLinks = getBrokenLinks(myLinkSet);
numBrokenLinks = numel(brokenLinks)

numBrokenLinks = 
1

Get a handle to the requirement that has the Summary property set to Add u and v.

req = slreq.find(Type="Requirement",Summary="Add u and v");

Repair the broken link by using the setDestination method.

setDestination(brokenLinks(1),req)

Confirm that there are no broken links.

brokenLinks = getBrokenLinks(myLinkSet)

brokenLinks =

     []

Version History

Introduced in R2019b

R2026a: Update links to external requirements

You can use external requirements as input arguments to the setDestination method.. To set the destination of a link to an external requirement, use a structure that has domain, artifact, and id fields or reqsys, doc, and id fields as an input to setDestination. When you use a structure with these fields as an input, Requirements Toolbox™ does not try to resolve the given destination. This may result in a broken link. For more information, see Load and Resolve Links.