slreq.import

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

Описание

slreq.import(docPath) импортирует содержимое требований как ссылочные требования из внешнего документа, расположенного в docPath. Импортированные требования сохраняются в новом наборе требований с таким же именем, как и внешний документ. Используйте этот метод импорта для импорта содержимого требований из Microsoft® Документы офиса и из файлов в формате обмена требованиями (.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 по умолчанию для документов и false Microsoft Word по умолчанию для 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 (универсальный метод описания спецификаций). Задайте значения как вектора символов с префиксом идентификатора, за которым опционально следует диафрагма символа.

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

Импорт из формата ReqIF, задающий сопоставление атрибутов как разделенную разделенными запятой парами, состоящую из 'attr2reqprop' и a 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