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

Вы можете быстро и легко загрузить имеющиеся данные требований в Requirements & Systems Portal с помощью Import Wizard, доступного в Requirements Module. Используя извлечение данных на базе ИИ, вы можете импортировать требования из неструктурированных файлов PDF, Word, Excel и CSV, сокращая время и усилия, необходимые для ручного переноса данных требований, и повышая точность и эффективность их сбора.

На этой странице описана более новая версия мастера импорта (в настоящее время в Beta). Если у вас нет к ней доступа в вашем экземпляре Requirements & Systems Portal, будет использоваться предыдущая версия импортера (см. сворачиваемый раздел Previous Iteration of the Importer, чтобы узнать больше).

Доступ к импортеру

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

Загрузка файла

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

Файлы в форматах *.pdf и *.docx можно импортировать только с помощью ИИ-импортера, который включен по умолчанию. При необходимости администратор Workspace может отключить его с помощью параметра External Provider на странице Settings – ValiAssistant (доступ к которой осуществляется нажатием значка в левом нижнем углу, выбором Settings в появившемся меню, а затем выбором ValiAssistant из списка на левой панели) – .

Когда параметр External Provider отключен, с помощью классического импортера можно импортировать только файлы форматов *.xlsx и *.csv. В этом случае в верхней части окна Import Requirements будет показано соответствующее сообщение ().

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

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

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

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

Для загруженного файла *.xlsx или *.csv вы можете продолжить работу с классическим импортером, включив параметр Classic Import (Non-AI) в левом нижнем углу окна.

Проверка извлеченных данных

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

Интерфейс страницы проверки ИИ-импортера

Интерфейс страницы проверки классического импортера

 

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

При создании новой спецификации должны соблюдаться правила именования. Имя спецификации не может содержать следующие символы: \ / ? % * : | " < >. Кроме того, начальные и конечные пробелы будут игнорироваться.

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

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

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

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

Включите параметр Parametrize values, чтобы проверить предлагаемые требования на наличие возможных количественных параметров и преобразовать их в Valis.

При использовании классического импортера также доступны следующие параметры:

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

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

Вы можете выбрать требования, которые хотите импортировать, установив флажки слева от соответствующих строк.

Сопоставление данных

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

Кроме того, вы можете сопоставить данные столбца с новым пользовательским столбцом, введя его нужное имя в поле Search/Add custom в раскрывающемся списке, а затем выбрав <custom_column_name> (Create new) из этого списка.

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

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

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

  • Identifier

  • Text

  • Title

  • Rationale

  • Children

  • Parents

  • Section

  • Path to Section

  • Applicable Block

  • Compliance Comment

  • Type

  • State

  • Compliance

  • V&V Status

  • V&V Methods

  • Applicability

  • Owner

  • Tags

  • Custom columns

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

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

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

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

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

  • Type

  • State

  • Compliance

  • Tags

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

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

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

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

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

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

  • Попытка импортировать требование с выражением соответствия, которое в настоящий момент не определено в Requirements & Systems Portal.

  • Попытка импортировать требование с типом, который в настоящий момент не определен в Requirements & Systems Portal.

  • Попытка импортировать требование с состоянием, которое в настоящий момент не определено в Requirements & Systems Portal.

  • Попытка импортировать требование с тегом, который в настоящий момент не определен в Requirements & Systems Portal.

  • Попытка импортировать требование с условием применимости, которое в настоящий момент не определено в Requirements & Systems Portal.

  • Попытка импортировать требование с методом, который в настоящий момент не определен в Requirements & Systems Portal.

  • Попытка импортировать требование с применимым блоком, который в настоящий момент не определен в Requirements & Systems Portal.

  • Попытка импортировать владельца, который в настоящий момент не определен в Requirements & Systems Portal.

  • Попытка импортировать более одного владельца, состояния или типа, которые в настоящий момент не определены в Requirements & Systems Portal.

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

Previous Iteration of the Importer

Если у вас нет доступа к более новой версии Importer, описанной выше, используется его предыдущая версия. См. раскрывающийся раздел ниже, чтобы узнать больше.

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

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

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

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

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

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

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

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

      • Identifier

      • Text

      • Title

      • Rationale

      • Parents

      • Children

      • Path to Section

      • Type

      • State

      • Tags

      • Compliance

      • Compliance comment

      • V&V Methods

      • Applicability

      • Applicable Blocks

      • Owner

      • Tags

      • Custom Columns

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

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

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

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

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

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

      • Type

      • State

      • Compliance

      • Tags

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

    Execution Report (Previous Iteration)

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

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

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

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

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

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

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

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

    • Условие Applicability не существует

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

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

    Дополнительную информацию см. на странице Parametrize Requirements .

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

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

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

    Content