Указание продукта
В этой части руководства мы рассмотрим один из основных пользовательских сценариев, который поможет вам начать работу с Requirements Portal:
-
Сбор и написание требований
-
Декомпозиция требований
-
Проверка и улучшение требований
-
Утверждение и выпуск спецификаций
Создание нового проекта
-
На странице Home Requirements Portal (доступ к ней осуществляется при открытии Requirements Portal из меню с девятью точками в правом верхнем углу браузерного интерфейса Workspace – , нажмите кнопку
над списком проектов требований.
-
Откроется окно Create Requirements Project, в котором можно указать сведения о проекте:
-
Project Name – введите подходящее (и уникальное) имя проекта (например,
Valifan). -
Description – введите необязательное описание проекта (например,
Amazing Valifan project). -
Electronics Project – оставьте это поле пустым.
После указания сведений о проекте нажмите кнопку
.
-
-
Проект требований появится в списке на странице Home. Нажмите на его имя, чтобы открыть его в новой вкладке браузера.
Определение требований заинтересованных сторон
Большинство процессов проектирования и разработки систем следуют V-циклу. Первый этап V-цикла — это понимание бизнес-потребностей и определение потребностей заинтересованных сторон. Затем эти потребности преобразуются в требования заинтересованных сторон, которые можно создавать напрямую, импортировать через CSV/XLSX или даже создавать с помощью ValiAssistant на базе ИИ. В этой части руководства мы сосредоточимся на методе импорта.
-
Загрузите следующий CSV-файл, содержащий требования заинтересованных сторон:
-
Если вы еще не там, перейдите в модуль Requirements, щелкнув запись Requirements в дереве проекта слева.
-
Нажмите кнопку
на открывшейся странице и выберите Import Requirements в появившемся меню.
-
В открывшемся окне Document Importer нажмите ссылку open the legacy importer here.
-
Откроется мастер Import Requirements. В области Create a specification задайте Name спецификации (например,
Stakeholder_requirements), затем нажмите кнопку
.
-
На следующем шаге необходимо загрузить CSV, чтобы мастер импорта мог прочитать и импортировать файл. Перетащите загруженный CSV-файл в область Drop file мастера Import Requirements (или щелкните по этой области, чтобы загрузить файл через диалоговое окно).
-
На следующем шаге убедитесь, что столбцы данных из CSV-файла правильно сопоставлены со столбцами в Requirements Portal. При необходимости используйте раскрывающиеся списки Map To в верхней части таблицы.
-
Следующая страница мастера уведомит вас об успешном импорте. Нажмите элемент управления Check now в верхней части окна, чтобы преобразовать значения и единицы измерения в параметры (valis) в соответствии с подходом data-driven system engineering.
-
В открывшемся окне Valify Requirements вы увидите уведомление о том, что пять требований будут valified. Нажмите
, чтобы продолжить, и получите уведомление о том, что найдено два vali. Нажмите
, чтобы продолжить, а затем нажмите
.
-
Как видите, 50 dB и 50 W были преобразованы из обычного текста в valis, которые мы сможем использовать позже.
Закройте окно Valify Requirements, чтобы продолжить. Все требования были добавлены, а все обнаруженные значения преобразованы в valis. Valis выделены в требованиях.
Добавление системных требований
В типовом процессе системной инженерии системные требования создаются на основе требований заинтересованных сторон. Большинство технических проектов должны соответствовать строгим требованиям, например требованиям к массе, энергопотреблению и стоимости. Requirements Portal предоставляет комплексное представление о том, насколько хорошо проект соответствует всем этим требованиям.
Теперь мы вручную создадим несколько системных требований.
-
Щелкните правой кнопкой мыши запись Requirements в дереве проекта слева и выберите Create Specification в появившемся меню. В окне Create new specification введите
Fan_Specsв поле Name и нажмите
.
-
Щелкните запись только что созданной спецификации в дереве проекта. Находясь в этой спецификации, нажмите кнопку
и выберите Create Requirement в появившемся меню.
-
Откроется окно Create new requirement. В этом окне:
-
В поле Specification убедитесь, что выбрана правильная спецификация (
Fan_Specs). -
В поле Identifier введите уникальный идентификатор, например,
R-Fan-001. -
В поле Requirement text введите
The Mass of the fan shall not exceed 300g. -
Убедитесь, что параметр Check for possible Valis включен.
-
-
В появившемся окне Valify Requirements нажмите кнопку
. В требовании будет найден vali. Нажмите кнопку
, чтобы преобразовать значение в vali, затем нажмите кнопку
, чтобы продолжить, а затем нажмите кнопку
, чтобы завершить процесс.
-
Аналогичным образом добавьте еще одно требование с идентификатором
R-Fan-002и текстом требованияThe Mass of the propeller shall not exceed 50g, но на этот раз отключите параметр Check for possible Valis (позже vali будет создан вручную из значения в этом требовании).
-
Добавленные требования будут перечислены при выборе спецификации Fan_Specs. Обратите внимание, что у R-Fan-001 есть vali, а у R-Fan-002 vali пока нет.
Создание requirement valis внутри требования
Теперь мы вручную создадим новый vali внутри поля текста требования.
-
Дважды щелкните ячейку в столбце Text требования R-Fan-002 и удалите текст
50g.
-
Введите
$, чтобы открыть всплывающее окно со списком valis/объектов внутри проекта. В правом верхнем углу всплывающего окна нажмите кнопку
, чтобы создать vali.
-
В открывшемся окне Create new. На вкладке Vali этого окна введите следующие данные для нового vali:
-
Name:
Req_Mass_Propeller -
Formula and unit:
50g -
Display unit:
g
-
-
Нажмите кнопку
, чтобы создать новый vali и вставить его в поле Text требования.
-
Теперь текст
50gотображается иначе, чем обычный текст, что указывает на vali. Теперь этот vali можно использовать в различных частях проекта (например, в отчетах, модуле Blocks, верификации и т. д.).
Декомпозиция требований с помощью связей родитель-потомок
-
Нажмите элемент управления Columns справа от таблицы и убедитесь, что элементы для столбцов Parents и Children отмечены, чтобы они отображались в таблице.
Снова нажмите элемент управления Columns, чтобы скрыть список.
-
Дважды щелкните ячейку в столбце Parent требования R-Fan-002 и выберите требование R-Fan-001 во всплывающем окне, чтобы связать оба требования. Обратите внимание, что R-Fan-002 будет автоматически добавлено в столбец Children для R-Fan-001.
-
Нажмите вкладку Connections в верхней части таблицы требований, чтобы открыть граф связей, показывающий отношение родитель-потомок для выбранной спецификации.
Генерация требований с помощью ValiAssistant
Чтобы ускорить процесс управления требованиями, вы можете генерировать требования/декомпозировать требования с помощью функции ИИ ValiAssistant. Мы используем ее, чтобы создать два требования по безопасности для учебного проекта.
-
Нажмите кнопку
в правом верхнем углу, чтобы открыть окно ValiAssistant - Generate Requirements. Убедитесь, что в раскрывающемся списке выбран параметр Generate Requirements, и нажмите кнопку
.
-
На следующей странице вы можете описать свой продукт, систему, подсистему и предоставить как можно больше информации, чтобы ИИ смог сформулировать наилучшие требования на основе вашего описания. Поскольку нас интересуют требования безопасности, запросите два требования безопасности для нашего вентилятора, введя текст
Create 2 safety requirements for designing a fanв поле под заголовком Generate Description.В текстовом поле под заголовком Prompt Extension вы можете дополнительно настроить запрос. Нам нужны требования, написанные в формате INCOSE; введите в поле текст
Apply the INCOSE guide to writing requirements.
-
На следующей странице будет представлен результат работы ИИ, и вы сможете просмотреть, изменить, принять или отклонить любые предложения.
-
Закройте диалоговое окно, информирующее об успешной генерации требований. Сгенерированные требования будут показаны в таблице спецификации Fan_Spec.
Обновление, управление и проверка требований
На протяжении процесса разработки требования нередко развиваются и обновляются под влиянием различных факторов, таких как отзывы заинтересованных сторон и проектные ограничения. В Requirements Portal вы можете напрямую обновлять требования, дважды щелкая по полям столбцов или в разделе сведений о требовании, при этом все изменения записываются в историю для удобного отслеживания.
-
Перейдите в режим редактирования текста требования R-Fan-003 или R-Fan-004, дважды щелкнув по его ячейке в столбце Text. Измените текст на
The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts.и нажмитеEnterили щелкните в любом месте таблицы вне ячейки, чтобы завершить редактирование. -
Нажмите идентификатор измененного требования, чтобы открыть его подробное представление, где можно настроить дополнительные поля, подписаться, назначить владельцев, добавить обоснование, создать родительские/дочерние связи и т. д.
-
Трассируемость — ключевая концепция Requirements Portal, и все изменения отслеживаются в истории требований и других объектов. Нажмите History, чтобы открыть представление, в котором отображается информация о версиях, о том, кто и когда внес изменение, а также о полях и действиях.
Проверка требований
На ранних этапах жизненного цикла продукта крайне важно проверять требования перед переходом к процессу проектирования. Requirements Portal предоставляет удобный способ управления состояниями требований с помощью столбца State. По умолчанию включены такие состояния, как Draft, In Review и Final, но при необходимости можно добавлять дополнительные состояния.
В этой части руководства вы назначите состояние Draft недавно добавленным требованиям, обеспечив структурированный и организованный рабочий процесс.
-
Находясь в спецификации Fan_Spec, нажмите элемент управления Columns справа от таблицы и убедитесь, что пункт для столбца State отмечен, чтобы он отображался в таблице.
-
Установите флажок слева от заголовка столбца Identifier, чтобы выбрать все требования в пределах спецификации.
-
Дважды щелкните ячейку любого требования в столбце State (при необходимости прокрутите таблицу вправо, чтобы увидеть столбец), чтобы открыть раскрывающийся список с доступными вариантами состояния. Выберите Draft в раскрывающемся списке и подтвердите обновление. Все требования получат состояние Draft.
)