exponenta event banner

slreq.import

Импорт требований из внешних документов

Описание

slreq.import(docPath) импортирует содержимое требований как ссылочные требования из внешнего документа, расположенного по адресу docPath. Импортированные потребности сохраняются в новом наборе потребностей с тем же именем, что и внешний документ. Этот метод импорта используется для импорта содержимого требований из документов Microsoft ® Office и из файлов в формате обмена требованиями (.reqif и .reqifz).

[refCount, reqSetFilePath, reqSetObj] = slreq.import(docPath) импортирует содержимое требований как ссылочные требования из внешнего документа, расположенного по адресу docPath и возвращает количество импортированных ссылок refCount. Импортированные потребности сохраняются в наборе потребностей. reqSetObj расположен по адресу reqSetFilePath с тем же именем, что и внешний документ.

slreq.import(docType) импортирует содержимое требований как ссылочные требования из внешнего документа зарегистрированного типа docType. Импортированные потребности сохраняются в новом наборе потребностей с тем же именем, что и внешний документ.

slreq.import(docPath,Name,Value) импортирует содержимое требований как ссылочные требования из внешнего документа, расположенного по адресу docPath с опциями, заданными одним или несколькими Name, Value аргументы пары.

slreq.import(reqifFile) импортирует содержимое требований из файла ReqIF reqifFile с использованием предварительно сконфигурированного сопоставления атрибутов.

slreq.import(reqifFile, 'mappingFile', mapFilePath) импортирует содержимое требований из файла ReqIF reqifFile с использованием сопоставления атрибутов, указанного в mapFilePath.

slreq.import('clearcache') очищает временные HTML-файлы, создаваемые при импорте требований к форматированному тексту.

Примеры

Импорт ссылочных требований

% 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');

Дополнительные сведения об импорте ссылочных требований из сторонних приложений см. в разделе Импорт требований из сторонних приложений.

Входные аргументы

свернуть все

Путь к файлу документа внешних требований, указанный как символьный вектор.

Вид документа внешних требований, указанный как символьный вектор.

Пример: 'linktype_rmi_doors'

Путь к файлу ReqIF, указанный как символьный вектор.

Путь к файлу сопоставления атрибутов, указанный как символьный вектор.

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'ReqSet','design_specs.slreqx'

Параметр импорта требований в виде ссылок, заданный как логическое значение. Стоимость false поддерживается только для импорта из документов Microsoft Office.

Имя существующего набора требований, в который импортируются требования, указанное как символьный вектор.

Пример: 'ReqSet', 'My_Requirements_Set'

Параметр импорта требований в виде форматированного текста, заданного как логическое значение.

Пример: 'RichText', true

Возможность импорта содержимого требований с помощью пользовательских закладок. Это значение равно true по умолчанию для документов Microsoft Word и false по умолчанию для электронных таблиц Microsoft Excel ®.

Пример: 'bookmarks', false

Шаблон регулярного выражения для поиска идентификаторов в документах Microsoft Office.

Пример: 'match', '^REQ\d+'

Имена импортируемых атрибутов, указанные как массив ячеек.

Примечание

При импорте требований из электронной таблицы Microsoft Excel длина этого массива ячеек должна соответствовать числу столбцов, указанному для импорта с помощью 'columns' аргумент.

Пример: 'attributes', {'Test Status', 'Test Procedure'}

Диапазон столбцов для импорта из электронной таблицы Microsoft Excel, указанный как double массив.

Пример: 'columns', [1 6]

Диапазон строк для импорта из электронной таблицы Microsoft Excel, указанный как double массив.

Пример: 'rows', [3 35]

Столбец в электронной таблице Microsoft Excel, который должен соответствовать полю идентификатора в наборе требований, указанному как double.

Пример: 'idColumn', 1

Столбец в электронной таблице Microsoft Excel, который должен соответствовать полю Сводка в наборе требований, указанному как double.

Пример: 'summaryColumn', 4

Столбец в электронной таблице Microsoft Excel, который должен соответствовать полю Ключевые слова в наборе требований, указанном как double.

Пример: 'keywordsColumn', 3

Столбец в электронной таблице Microsoft Excel, который должен соответствовать полю Описание в наборе требований, указанному как double.

Пример: 'descriptionColumn', 2

Столбец в электронной таблице Microsoft Excel, который должен соответствовать полю Обоснование в наборе требований, указанному как double.

Пример: 'rationaleColumn', 5

Столбец в электронной таблице Microsoft Excel, который должен соответствовать полю Пользовательские атрибуты в наборе требований, указанному как double.

Пример: 'attributeColumn', 6

Импорт из электронных таблиц Microsoft Excel, указанных в стандартном формате USDM (Universal Specification Descripting Manage). Укажите значения в виде символьного вектора с префиксом идентификатора, а затем символ-разделитель.

Пример: 'RQ -' будет соответствовать записям с идентификаторами, аналогичными RQ01, RQ01-2, RQ01-2-1 и т.д.

Импортировать из формата ReqIF, указав сопоставление атрибутов как разделенную запятыми пару, состоящую из 'attr2reqprop' и containers.Map объект. Например:

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);

Пример: slreq.import('myfile.reqif', 'attr2reqprop', attrMap);

Выходные аргументы

свернуть все

Количество связанных требований, импортированных, возвращенных как double.

Путь к файлу набора требований, в который импортируются требования, возвращаемый в виде символьного вектора.

Обрабатывать набор требований, в который импортируются требования, возвращаемый как slreq.ReqSet объект.

Представлен в R2018a