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

Вы можете быстро и легко загрузить имеющиеся данные требований в 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 доступен из Requirements Module () — нажмите кнопку  в правом верхнем углу страницы. Кроме того, если в просматриваемой спецификации нет требований, импортёр можно открыть, нажав кнопку 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, которое появится в окне.

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

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

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

Устаревший импортёр

При открытии Importer (узнать больше) вы можете выбрать продолжение работы с устаревшим инструментом импорта для загрузки структурированных данных требований. Процесс проводит вас через три основных этапа: 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 можно импортировать с более чем одним значением для каждого требования. Для этого каждое значение должно быть разделено запятой.

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

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

Execution Report

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

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

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

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

  • Заявление о соответствии требованиям отсутствует в проекте

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

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

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

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

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