slreq.import

Import requirements from external documents

Syntax

slreq.import(docPath)

[refCount, reqSetFilePath, reqSetObj] = slreq.import(docPath)

slreq.import(docType)

slreq.import(docPath,Name,Value)

slreq.import(reqifFile)

slreq.import(reqifFile, 'mappingFile', mapFilePath)

slreq.import('clearcache')

Description

slreq.import(docPath) imports requirements content as referenced requirements from an external document located at docPath. The imported requirements are saved in a new requirement set with the same name as the external document. Use this import method to import requirements content from Microsoft^® Office documents and from files in the Requirements Interchange Format (.reqif and .reqifz).

[refCount, reqSetFilePath, reqSetObj] = slreq.import(docPath) imports requirements content as referenced requirements from an external document located at docPath and returns the number of references imported refCount. The imported requirements are saved in the requirement set reqSetObj located at reqSetFilePath with the same name as the external document.

slreq.import(docType) imports requirements content as referenced requirements from an external document that is of a registered document type docType. The imported requirements are saved in a new requirement set with the same name as the external document.

slreq.import(docPath,Name,Value) imports requirements content as referenced requirements from an external document located at docPath with options specified by one or more Name, Value pair arguments.

slreq.import(reqifFile) imports requirement content from the ReqIF file reqifFile using a pre-configured attribute mapping.

slreq.import(reqifFile, 'mappingFile', mapFilePath) imports requirement content from the ReqIF file reqifFile using the attribute mapping specified by mapFilePath.

slreq.import('clearcache') cleans up temporary HTML files that are created when importing rich text requirements.

Examples

Import Referenced Requirements

% Import referenced requirements from Microsoft Office documents
slreq.import('Specification002.docx');
slreq.import('D:/Projects/Requirements/Safety321.xlsx');

% Import referenced requirements from an IBM Rational DOORS Module
slreq.import('linktype_rmi_doors');

For more information on importing referenced requirements from third-party applications, see Import Requirements from Third-Party Applications.

Input Arguments

docPath — Document location

character vector

The file path of the external requirements document, specified as a character vector.

docType — Document type

character vector

The document type of the external requirements document, specified as a character vector.

Example: 'linktype_rmi_doors'

reqifFile — ReqIF file location

character vector

The file path of the ReqIF file, specified as a character vector.

mapFilePath — Attribute mapping file location

character vector

The file path of the attribute mapping file, specified as a character vector.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'ReqSet','design_specs.slreqx'

AsReference — Option to import as references

true (default) | false

Option to import requirements as references, specified as a Boolean value. The value false is supported only for import from Microsoft Office documents.

attr2reqprop — ReqIF™ attribute mapping

containers.Map object

Import from ReqIF format, specifying the attribute mapping as a comma-separated pair consisting of 'attr2reqprop' and a containers.Map object. For example:

attrMap = containers.Map('KeyType','char','ValueType','char')
attrMap('SourceID') = 'Custom ID'; % Built-in attribute
attrMap('ReqIF.ChapterName') = 'Summary'; % Built-in attribute
attrMap('Data Class') = 'MyDataClass'; % Custom attribute

slreq.import('myfile.reqif','attr2reqprop',attrMap);

Example: slreq.import('myfile.reqif','attr2reqprop',attrMap);

attributeColumn — Custom Attributes Column

double array

Column in the Microsoft Excel^® spreadsheet that you want to map as custom attributes of the requirements in your requirement set, specified as a double array.

Example: 'attributeColumn',[4 6]

attributes — Attribute names

cell array

Attribute names for custom attribute columns, specified as a cell array of character vectors.

Note

When importing requirements from a Microsoft Excel spreadsheet, the length of this cell array must match the number of columns specified for import using the attributeColumn argument.

Example: 'attributes',{'Test Status','Test Procedure'}

bookmarks — Option to import requirements using bookmarks

0 (default) | 1

Option to import requirements content using user-defined bookmarks, specified as a 1 or 0 of data type logical.

By default, Requirements Toolbox™ sets the value to 1 for Microsoft Word documents and 0 for Microsoft Excel spreadsheets.

Example: 'bookmarks',false

columns — Range of columns

double array

Range of columns to import from Microsoft Excel spreadsheet, specified as a double array.

Example: 'columns',[1 6]

createdByColumn — Created By Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the CreatedBy property of the requirements in your requirement set, specified as a double.

Example: 'createdByColumn',5

descriptionColumn — Description Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the Description property of the requirements in your requirement set, specified as a double.

Example: 'descriptionColumn',2

idColumn — ID Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the ID property of the requirements in your requirement set, specified as a double.

Example: 'idColumn',1

keywords — Attribute to map to Keywords

string scalar | character vector

Name of the attribute from the external document that you want to map to the Keywords property for the imported requirements.

Use this argument when you import from IBM^® Rational^® DOORS^® or custom document types.

Example: "keywords","Requirement Keywords"

keywordsColumn — Keywords Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the Keywords property of the requirements in your requirement set, specified as a double.

Example: 'keywordsColumn',3

match — Regular expression pattern

character vector

Regular expression pattern for ID search in Microsoft Office documents.

Example: 'match','^REQ\d+'

modifiedByColumn — Modified By Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the ModifiedBy property of the requirements in your requirement set, specified as a double.

Example: 'modifiedByColumn',6

postImportFcn — Custom post-import callback

string scalar | character vector

Custom post-import callback script name to use during import, specified as a string scalar or character vector.

The script that you assign to this callback executes after you import or update requirements.

Example: "postImportFcn","myPostImportScript"

preImportFcn — Custom pre-import callback

string scalar | character vector

Custom pre-import callback script name to use during import, specified as a string scalar or character vector.

The script that you assign to this callback executes before you import or update requirements.

Example: "preImportFcn","myPreImportScript"

rationale — Attribute to map to Rationale

string scalar | character vector

Name of the attribute from the external document that you want to map to the Rationale property for the imported requirements.

Use this argument when you import from IBM Rational DOORS or custom document types.

Example: "rationale","Requirement Rationale"

rationaleColumn — Rationale Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the Rationale property of the requirements in your requirement set, specified as a double.

Example: 'rationaleColumn',5

ReqSet — Requirement Set

character vector

The name for the requirement set that you import requirements into, specified as a character vector.

If the requirement set exists, the requirements import under a new Import node. If the requirement set does not exist, Requirements Toolbox creates it.

Example: 'ReqSet','My_Requirements_Set'

RichText — Option to import rich text requirements

false (default) | true

Option to import requirements as rich text, specified as a Boolean value.

Example: 'RichText',true

rows — Range of rows

double array

Range of rows to import from Microsoft Excel spreadsheet, specified as a double array.

Example: 'rows',[3 35]

sheet — Worksheet name

character vector

Worksheet name from Microsoft Excel workbook, specified as a character vector.

Example: 'sheet','Sheet1'

summaryColumn — Summary Column

double

Column in the Microsoft Excel spreadsheet that you want to map to the Summary property of the requirements in your requirement set, specified as a double.

Example: 'summaryColumn',4

USDM — USDM Format Import Option

character vector

Import from Microsoft Excel spreadsheets specified in the USDM (Universal Specification Describing Manner) standard format. Specify values as a character vector with the ID prefix optionally followed by a separator character.

Example: 'RQ -' will match entries with IDs similar to RQ01, RQ01-2, RQ01-2-1 etc.

Output Arguments

refCount — Imported referenced requirements count

double

Number of referenced requirements imported, returned as a double.

reqSetFilePath — Requirement set file path

character vector

The file path of the requirement set to which you import requirements to, returned as a character vector.

reqSetObj — Requirement set object

slreq.ReqSet object

Handle to the requirement set to which you import requirements to, returned as an slreq.ReqSet object.

Version History

Introduced in R2018a