Импорт требований

Вы можете быстро и легко загрузить имеющиеся данные требований в Requirements Portal, используя Import Wizard в модуле Requirements Module.

AI Assisted Requirements Importer

Инженерия требований часто начинается с составления требований заинтересованных сторон в документах вроде PDF и таблиц Excel, где данные плохо структурированы. Ручное извлечение данных требований из таких неструктурированных документов может быть трудоёмким и подверженным ошибкам, и чтобы ускорить процесс фиксации требований в Requirements Portal, вы можете использовать возможности ИИ для импорта требований из неструктурированных файлов PDF, Excel, Word и CSV.

Функциональность AI-assisted Importer в настоящее время находится в статусе Beta.

Доступ к Importer

AI Assisted Importer доступен из Requirements Module () — нажмите кнопку  в левом верхнем углу страницы и выберите Create Requirement в появившемся меню. Кроме того, если в просматриваемой спецификации нет требований, importer можно открыть, нажав кнопку Import на странице.

Процесс импорта

После открытия importer отображается окно Document Import. Чтобы продолжить работу с AI Assisted Importer, нажмите кнопку .

В этом окне при желании можно выбрать использование legacy importer, нажав ссылку open the legacy importer here. Как пользоваться legacy importer, описано ниже на этой странице.

На следующем этапе вы можете загрузить файл поддерживаемого типа (*.pdf, *.docx, *.xlsx или .*csv). Для этого перетащите файл в соответствующую область окна или нажмите элемент управления select from your computer, чтобы найти и выбрать файл на жёстком диске.

Максимальный размер загружаемого файла — 100 МБ.

Хотя загружаемый файл может быть неструктурированным, вы можете воспользоваться ссылкой Excel template, чтобы скачать файл *.xlsx, который можно использовать для фиксации требований в структурированном виде.

После успешной загрузки файла его запись будет показана в окне. Удалить её из окна можно, нажав значок . Либо перетащите в окно другой файл, чтобы заменить текущий.

Нажмите кнопку  для продолжения. Importer обработает загруженный файл. По завершении процесса извлечённые данные будут представлены в виде таблицы предлагаемых требований. Вы можете выбрать требования для импорта, установив флажки слева от соответствующих строк.

По умолчанию извлечённые требования будут импортированы в спецификацию, которая была открыта на момент запуска Importer. Вы можете выбрать нужную спецификацию в раскрывающемся списке в верхней части окна Importer или создать новую спецификацию, выбрав пункт As new (creates new specification) в списке и задав имя новой спецификации в поле Specification name, которое появится в окне.

Нажмите кнопку  для продолжения. После завершения импорта появится окно подтверждения.

Если importer обнаружит проблемы в импортируемых требованиях, это будет указано в окне (). Нажмите ссылку, чтобы скачать отчёт с подробным описанием причин обнаруженных проблем. 

Нажмите кнопку  чтобы вернуться к этапу загрузки файла в importer, или нажмите  чтобы выйти из importer.

Legacy Importer

При открытии Importer (узнать больше) вы можете выбрать продолжение работы с legacy-инструментом импорта для загрузки структурированных данных требований. Процесс проводит вас через три основных этапа: Specification, Upload и Review. По завершении импорта спецификации отображается сводка, а также возможность выполнить дополнительные действия, например Valifying или импорт других файлов. Эти этапы и действия описаны в разделах ниже.

Specification

На этом этапе Import Wizard вы можете задать целевую спецификацию для импорта:

  • Используйте область Select a specification в левой части окна Import Requirements, чтобы выбрать существующую спецификацию и, при необходимости, её раздел.

  • Используйте область Create a specification в правой части окна Import Requirements, чтобы создать новую спецификацию (а также задать аббревиатуру и блок, к которому она будет привязана), не выходя из мастера импорта.

Нажмите нужную область, чтобы использовать предпочтительный способ.

 
  • Если Import Wizard запускается в контексте Specification или Section, они будут предварительно выбраны как место назначения импорта.

  • Если существующих спецификаций нет, необходимо создать новую.

  • При задании имени новой Specification необходимо соблюдать правила именования — допускаются только буквенно-цифровые символы и специальный символ _ (подчёркивание).

Upload

На этом этапе Import Wizard вы можете загрузить файл поддерживаемого типа. Для этого перетащите файл в правую часть окна Import Requirements или нажмите элемент управления Drop file, чтобы найти и выбрать файл на жёстком диске. После успешной загрузки файла в окне отображается уведомление.

 
  • Поддерживаются только файлы Excel (.xls, .xlsx) и Comma Separated Values (.csv). Файлы Excel Macro (.xlsm) не поддерживаются.

  • Если загружен неподдерживаемый файл, об этом сообщит сообщение об ошибке.

  • После загрузки файла вы можете либо продолжить процесс импорта, либо загрузить новый файл (заменив предыдущий).

Review

На этом этапе Import Wizard вы можете просмотреть результаты импорта данных из загруженного файла, настроить параметры файла и сопоставить данные из файла с полями требований.

Область Destination окна Import Requirements визуально показывает, куда будут импортированы данные (в терминах спецификации или раздела).

Область File options предоставляет следующие параметры:

  • Update requirements – если включено, любые существующие требования в целевой спецификации будут перезаписаны путём замены данных (данные из файла заменяют данные в спецификации).

    • Если параметр отключён и вы импортируете требования, чей Identifier уже существует в спецификации, выбранной как место назначения, Requirements Portal добавит суффикс _import к идентификаторам импортируемых требований, чтобы различать их.

    • Если параметр отключён и вы импортируете требования, чьи Identifiers уже существуют в текущем проекте, но не в спецификации, выбранной как место назначения, Requirements Portal добавит к идентификаторам значок предупреждения, сигнализирующий о дублирующемся идентификаторе в рамках одного проекта.

    • Если параметр включён, поддерживаются пустые значения в импортируемом файле, т. е. если значение в файле пустое, значение удаляется из требования. Это также относится к полям с множественным выбором, таким как Tags.

  • Use header row – вы можете выбрать, использовать ли строку заголовков загруженного файла или использовать общую эталонную строку заголовков, предоставляемую Requirements Portal (т. е. заголовки столбцов как A, B, C и т. д.).

    Requirements Portal считает строку Header первой строкой любого загруженного файла.

  • Sheet – если файл содержит несколько листов, вы можете выбрать, с какого листа выполнять импорт.

  • Starting row – вы можете выбрать, с какой строки импортируемого файла следует начинать сбор данных для вставки в Requirements Portal.

В таблице в нижней части окна Import Requirements вы видите предварительный просмотр загруженного файла и сопоставляете его столбцы с полями в Requirements Portal. Это позволяет определить, как данные из файла будут соответствовать конкретным полям в Requirements Portal, выбирая нужное поле в раскрывающемся списке Map To для каждого столбца. Если файл содержит заголовки, идентичные полям по умолчанию в Requirements Portal, эти поля будут сопоставлены автоматически. Однако при необходимости вы можете переопределить или скорректировать это автоматическое сопоставление.

  • Для сопоставления можно выбрать следующие поля:

    • Identifier

    • Text

    • Title

    • Rationale

    • Parents

    • Children

    • Path to Section

    • Type

    • State

    • Tags

    • Compliance

    • Compliance comment

    • Verification Methods

    • Applicability

    • Applicable Blocks

    • Owner

    • Tags

    • Custom Columns

  • Verification Methods, Applicability и Tags можно импортировать с более чем одним значением для каждого требования. Для этого каждое значение должно быть разделено запятой.

  • Если импортируемый verification method, applicable block, requirement type, state, compliance или tag в данный момент отсутствует в Requirements Portal, он будет автоматически создан во время импорта и добавлен к требованию.

  • Для Applicability составные типы блоков можно указывать с помощью /, например block_A/block_B.

  • Как минимум должен быть выбран столбец Identifier. В противном случае будет отображаться предупреждающее сообщение, пока это условие не будет выполнено ().

  • Следующие поля чувствительны к регистру:

    • Тип

    • Состояние

    • Соответствие

    • Теги

    Например, если тег TBD уже существует в Requirements Portal, а импортируется тег tbd, будет создан новый тег tbd и импортирован вместе с требованием.

Отчет о выполнении

После завершения процесса импорта, если импорт успешно выполнен, отображается сообщение об успехе и внесенные изменения. Если импорт не удался, будет отображено сообщение о неудаче. Пример успешного импорта показан ниже.

Если есть какие-либо некритические ошибки, они также будут отображены (). Возможные некритические ошибки:

  • Невозможно установить связь → идентификатор родительского или дочернего элемента не существует в проекте

  • Невозможно установить связь → идентификатор родительского или дочернего элемента дублируется в проекте

  • Заявление о соответствии требованиям (Requirement Compliance Statement) отсутствует в проекте

  • Тип требования отсутствует в проекте

  • Состояние требования отсутствует в проекте

  • Тег отсутствует в проекте

  • Условие применимости отсутствует

Независимо от того, был ли импорт успешным или нет, вы можете повторно импортировать или выполнить новый импорт, нажав Import new file (успех) или Try again (неудача), что вернет вас к этапу 1 (Specification).

После успешного импорта вы также можете запустить процесс Valify, нажав элемент управления Check now в верхней части окна. Этот процесс просканирует текст импортированных требований на предмет возможных количественно измеримых параметров, которые можно преобразовать в Valis внутри требования.

Дополнительные сведения см. на странице Valify Requirements.

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Доступность функциональных возможностей

Набор доступных функциональных возможностей зависит от вашего решения Altium – Altium Develop, редакция Altium Agile (Agile Teams или Agile Enterprise) или Altium Designer (на активной подписке).

Если вы не видите в своем ПО функцию, описанную здесь, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Content