Work with external requirement proxy objects
slreq.Reference are proxies for external requirement
objects that a third-party external application manages and maintains. Referenced
requirement objects are read-only but can be synchronized from an external application
and can exist only within a requirements set.
finds and returns a referenced requirement or a set of referenced requirements
ref = find(
ref in the requirements set
rs specified by
the properties matching
adds a referenced requirement
ref = add(
ref to a requirements set
rs which references requirements from the external document
FileName with properties and custom attributes
rs — Requirement set object
Requirement set, specified as an
FileName — Container identifier
File name for a top-level container identifier, such as a Microsoft® Office document name or an IBM® Rational® DOORS® Module unique ID.
ref — Referenced requirement
Referenced requirement, specified as an
Id — Referenced requirement ID
Referenced requirement ID, returned as a character vector.
CustomId — Referenced requirement Custom ID
Referenced requirement custom ID, returned as a character vector.
Artifact — Container identifier
Top-level container identifier, like a Microsoft Office document name or an IBM Rational DOORS Module unique ID.
ArtifactId — Requirement identifier
Unique requirement identifier in the source requirements document. For requirements imported from IBM Rational DOORS, the ArtifactId is the Numeric Object Id. For requirements imported from Microsoft Word, the bookmark names are used as the ArtifactId.
Domain — Requirements document custom link type
The custom link type of the requirements document. For more information, see Custom Link Types.
UpdatedOn — Date and time referenced requirement was last updated
The date and time the referenced requirement was last synchronized with
the external document, specified as a
datetime value. The
software automatically populates this property.
IsLocked — Referenced requirement lock indicator
1 (default) | 0
Indicates if the referenced requirement is locked.
for locked and
0 for unlocked.
Summary — Referenced requirement summary
Referenced requirement summary text, returned as a character vector.
Description — Referenced requirement description
Referenced requirement description text, returned as a multiline character vector.
Rationale — Referenced requirement rationale
Referenced requirement rationale text, returned as a multiline character vector.
Keywords — Referenced requirement keywords
Referenced requirement keywords, specified as a character array.
Type — Referenced requirement type enumeration
'Container' | string scalar | character vector
Referenced requirement type enumeration, specified as
'Container', or a string scalar or character vector
that specifies a custom requirement type. For more information, see Requirement Types.
SID — Referenced requirement Session Independent Identifier
The Session Independent Identifier corresponding to the referenced requirement.
FileRevision — Referenced requirement revision number
Referenced requirement revision number, specified as a scalar.
ModifiedOn — Date referenced requirement was modified
The date the referenced requirement was last modified, specified as a
datetime value. The software automatically populates
ModifiedBy — Referenced requirement modifier
The name of the individual or organization who last modified the referenced requirement.
CreatedOn — Date referenced requirement was created
The date the referenced requirement was created, specified as a
datetime value. The software automatically populates
CreatedBy — Referenced requirement creator
The name of the individual or organization who created the referenced requirement.
Dirty — Unsaved changes indicator
Indicates if the referenced requirement has unsaved changes.
0 for no unsaved changes and
1 for unsaved changes.
Comments — Referenced requirement comments
The comments that are attached with the referenced requirement, returned as a structure.
|add||Add referenced requirements|
|addComment||Add comments to referenced requirements|
|children||Find children references|
|find||Find children of parent referenced requirements|
|getAttribute||Get referenced requirement custom attributes|
|getImplementationStatus||Query referenced requirement implementation status summary|
|getVerificationStatus||Query referenced requirement verification status summary|
|isJustifiedFor||Check if referenced requirement is justified|
|justifyImplementation||Justify referenced requirements for implementation|
|justifyVerification||Justify referenced requirements for verification|
|parent||Find parent item of referenced requirement|
|remove||Remove referenced requirements|
|reqSet||Return parent requirements set|
|setAttribute||Set referenced requirement custom attributes|
|unlock||Unlock referenced requirements|
|unlockAll||Unlock all child referenced requirements for editing|
|updateFromDocument||Update referenced requirements from external requirements document|
Get the Handle to a Referenced Requirement
% Find a referenced requirement with Id R9 in a requirement set rs ref = find(rs, 'Type', 'Reference', 'Id', 'R9') ref = Reference with properties: Keywords: [0×0 char] Artifact: 'Req_doc.docx' Id: 'R9' Summary: 'System overview' Description: '' SID: 3 Domain: 'linktype_rmi_word' SynchronizedOn: 25-Jul-2017 11:34:02