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

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

AI Assisted Requirements Importer

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

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

С помощью AI-assisted Importer в требования можно импортировать следующие поля:

  • Идентификатор

  • Текст

  • Методы

  • Применимые блоки

  • Заголовок

  • Обоснование

  • Родительские элементы

  • Дочерние элементы

  • Тип

  • Состояние

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

  • Комментарий по соответствию

  • Владелец

  • Теги

  • Путь к разделу

Доступ к Importer

AI Assisted Importer может быть включен или отключен администратором с помощью параметра External Provider на странице Settings – ValiAssistant (доступ к которой осуществляется нажатием значка в левом нижнем углу, выбором Settings в появившемся меню, а затем выбором ValiAssistant из списка на левой панели).

Когда параметр External Provider отключен, доступен и может использоваться только устаревший импортёр. Подробнее об устаревшем импортёре см. в разделе Legacy Importer ниже.

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

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

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

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

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

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

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

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

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

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

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

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

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

Legacy Importer

При открытии Importer (подробнее) вы можете выбрать продолжение работы с устаревшим инструментом импорта для загрузки структурированных данных требований. Кроме того, устаревший импортёр доступен только тогда, когда параметр External Provider отключен администратором в настройках Requirements & System Portal.

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

Спецификация

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

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

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

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

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

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

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

Загрузка

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

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

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

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

Проверка

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Идентификатор

    • Текст

    • Заголовок

    • Обоснование

    • Родительские элементы

    • Дочерние элементы

    • Путь к разделу

    • Тип

    • Состояние

    • Теги

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

    • Комментарий по соответствию

    • Методы V&V

    • Применимость

    • Применимые блоки

    • Владелец

    • Теги

    • Пользовательские столбцы

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

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

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

  • Для пользовательских столбцов доступны следующие типы: Select, Multiselect, Text, Date, Number.

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

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

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

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

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

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

  • Утверждение о соответствии требования не существует в проекте

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

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

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

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

Независимо от того, был ли импорт успешным или нет, вы можете повторно выполнить импорт или начать новый импорт, нажав 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