Указание продукта
В этой части руководства мы рассмотрим один из основных пользовательских сценариев, который поможет вам начать работу с Requirements Portal:
-
Сбор и формулирование требований
-
Декомпозиция требований
-
Проверка и улучшение требований
-
Утверждение и выпуск спецификаций
Создание нового проекта
-
Нажмите раскрывающееся меню Project в левом верхнем углу и нажмите кнопку
.
-
На открывшейся странице настройки проекта введите подходящее (и уникальное) имя проекта (например,
Valifan) в поле Project name, а затем нажмите кнопку
.
Определение требований заинтересованных сторон
Большинство процессов проектирования и разработки систем следуют 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 Module, при верификации и т. д.).
Декомпозиция требований с отношениями «родитель–потомок»
-
Нажмите элемент управления 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.