Указание продукта

В этой части руководства мы рассмотрим один из основных пользовательских сценариев, который поможет вам начать работу с Requirements Portal:

• Сбор и формулирование требований

• Декомпозиция требований

• Проверка и улучшение требований

• Утверждение и выпуск спецификаций

Создание нового проекта

1. На странице Home в Requirements Portal (она открывается при запуске Requirements Portal из меню с девятью точками в правом верхнем углу веб-интерфейса рабочего пространства — ) нажмите кнопку  над списком проектов требований.

   

2. Откроется окно Create Requirements Project, в котором можно указать сведения о проекте:

   • Project Name — введите подходящее уникальное имя проекта (например, Valifan).

   • Description — при необходимости введите описание проекта (например, Amazing Valifan project).

   • Electronics Project — оставьте это поле пустым. 

   Указав сведения о проекте, нажмите кнопку .

   

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

   

Определение требований заинтересованных сторон

При проектировании и разработке большинства систем используется V-образный цикл. Первый этап V-образного цикла — понимание потребностей бизнеса и выявление потребностей заинтересованных сторон. Затем эти потребности преобразуются в требования заинтересованных сторон, которые можно создавать непосредственно в системе, импортировать из CSV/XLSX или даже создавать с помощью Engineering Assistant на базе ИИ. В этой части руководства мы сосредоточимся на импорте.

1. Скачайте следующий CSV-файл с требованиями заинтересованных сторон:

   Valifan_stakeholder_Requirements.csv

2. Если модуль требований еще не открыт, перейдите в него, нажав пункт Requirements в дереве проекта слева.

3. На открывшейся странице нажмите кнопку  и выберите Import Requirements в появившемся меню.

   

4. В открывшемся окне Document Importer перетащите скачанный CSV-файл в область Drop your file here или нажмите ссылку upload from your computer для загрузки CSV-файла, чтобы мастер импорта мог прочитать и импортировать его.

   

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

   

6. На следующем этапе выберите + Add specification в раскрывающемся списке слева вверху и введите имя новой спецификации (например,Stakeholder_requirements), в которую будут импортированы требования.

   

7. Убедитесь, что столбцы данных CSV-файла правильно сопоставлены со столбцами в Requirements Portal. При необходимости используйте раскрывающиеся списки в заголовках столбцов.

   

8. Убедитесь, что параметр Parametrize values включен и все требования выбраны для импорта (установлены все флажки в крайнем левом столбце таблицы), затем нажмите , чтобы продолжить.

   

9. На следующей странице мастера появится уведомление об успешном импорте. Закройте окно, чтобы продолжить.

   

10. Новая спецификация создана, и все требования импортированы в нее. Обнаруженные значения и единицы измерения преобразованы из обычного текста в vali (параметры), которые выделены в тексте требований.

    

Добавление системных требований

В типичном процессе системной инженерии системные требования создаются на основе требований заинтересованных сторон. Большинство технических проектов должны соответствовать строгим требованиям, например к массе, энергопотреблению и стоимости. Requirements Portal позволяет получить полное представление о том, насколько проект соответствует всем этим требованиям.

Теперь мы создадим несколько системных требований вручную.

1. Щелкните правой кнопкой мыши пункт Requirements в дереве проекта слева и выберите Create Specification в появившемся меню. В окне Create new specification введите Fan_Specs в поле Name и нажмите .

   

2. Выберите только что созданную спецификацию в дереве проекта. Открыв эту спецификацию, нажмите  кнопку  и выберите Create Requirement в появившемся меню.

   

3. Откроется окно Create Requirement. В этом окне:

   1. В поле Identifier введите уникальный идентификатор, например R-Fan-001.

   2. В поле Text введите The Mass of the fan shall not exceed 300g.

   3. Нажмите кнопку  и убедитесь, что в поле Specification выбрана нужная спецификация (Fan_Specs).

   4. Убедитесь, что параметр Parametrize values включен.

      Когда этот параметр включен, числовые значения в требовании проверяются и сразу преобразуются в vali с помощью функции параметризации.

   5. Нажмите кнопку .

   

4. Аналогичным образом добавьте еще одно требование с идентификатором R-Fan-002 и текстом The Mass of the propeller shall not exceed 50g, но на этот раз отключите параметр Parametrize values (позже мы вручную создадим vali из значения в этом требовании).

   

5. Добавленные требования отобразятся в списке при выборе спецификации Fan_Specs. Обратите внимание: у R-Fan-001 есть vali, а у R-Fan-002 его пока нет.

   

Создание vali в тексте требования

Теперь мы вручную создадим новый vali в поле текста требования.

1. Дважды щелкните ячейку в столбце Text для требования R-Fan-002 и удалите текст 50g.

   

2. Введите $, чтобы открыть всплывающее окно со списком vali и объектов проекта. В правом верхнем углу этого окна нажмите кнопку , чтобы создать vali.

   

3. В открывшемся окне Create new перейдите на вкладку Vali и введите следующие данные для нового vali:

   1. Name: Req_Mass_Propeller

   2. Formula and unit: 50g

   3. Display unit: g

      Поле Display unit необязательно для заполнения. Если оставить его пустым, единица измерения будет взята из поля Formula and unit. 

   

4. Нажмите кнопку , чтобы создать новый vali и вставить его в поле Text требования, затем нажмите Enter или щелкните в любом месте таблицы за пределами ячейки, чтобы завершить редактирование.

5. Теперь текст 50g отображается иначе, чем обычный текст, что указывает на vali. Этот vali можно использовать в разных частях проекта (например, в отчетах, модуле блоков, при верификации и т. д.).

   

Декомпозиция требований с помощью связей «родитель — потомок»

1. Нажмите элемент управления Columns справа от таблицы и убедитесь, что пункты для столбцов Parents и Children отмечены, чтобы эти столбцы отображались в таблице.

   

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

2. Дважды щелкните ячейку в столбце Parent для требования R-Fan-002 и выберите требование R-Fan-001 во всплывающем окне, чтобы связать оба требования. Обратите внимание: R-Fan-002 будет автоматически добавлено в столбец Children требования R-Fan-001.

   

   

    

3. Нажмите вкладку Connections в верхней части таблицы требований, чтобы открыть граф связей, показывающий связи «родитель — потомок» в выбранной спецификации.

   Синие рамки вокруг требований обозначают спецификацию, к которой они относятся.

   

Создание требований с помощью инженерного помощника

Чтобы ускорить процесс управления требованиями, вы можете создавать требования и выполнять их декомпозицию с помощью инженерного помощника. Мы используем его, чтобы создать два требования безопасности для учебного проекта.

1. Нажмите кнопку  в правом верхнем углу, чтобы открыть панель Engineering Assistant.

   

    

2. На панели Engineering Assistant вы можете описать свое изделие, систему или подсистему и предоставить как можно больше информации, чтобы ИИ предложил требования, наиболее точно соответствующие вашему описанию. Поскольку нас интересуют требования безопасности, запросите два требования безопасности для нашего вентилятора, введя запрос в поле Ask anything в нижней части панели:

   Create 2 safety requirements for designing a fan. Apply the INCOSE guide to writing requirements.

   Нажмите  или клавишу Enter, чтобы продолжить.

   

3. Предложенные требования появятся в табличной области спецификации. Нажмите кнопку  на панели Engineering Assistant, чтобы создать новые требования на основе предложений.

   

   

    

4. Созданные требования можно изменить в любой момент. При необходимости измените идентификаторы созданных требований на R-Fan-003 и R-Fan-004: дважды щелкните соответствующие ячейки в столбце Identifier, введите текст, а затем нажмите Enter или щелкните в любом месте таблицы за пределами ячейки, чтобы завершить редактирование.

Обновление, управление и проверка требований

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

1. Перейдите в режим редактирования текста требования 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 или щелкните в любом месте таблицы за пределами ячейки, чтобы завершить редактирование.

   

   

   

    

2. Нажмите идентификатор измененного требования, чтобы открыть его подробное представление. Здесь можно настроить дополнительные поля, подписаться на обновления, назначить ответственных, добавить обоснование, создать родительские и дочерние связи и т. д.

   

3. Прослеживаемость — ключевой принцип Requirements Portal: все изменения фиксируются в истории требований и других объектов. Нажмите History, чтобы открыть представление с информацией о версиях, авторах и времени изменений, полях и действиях.

   

Валидация требований

На ранних этапах жизненного цикла изделия важно выполнить валидацию требований, прежде чем переходить к проектированию. Requirements Portal позволяет удобно управлять состояниями требований с помощью столбца State. По умолчанию доступны состояния Draft, In Review и Final, но вы можете добавить другие состояния в соответствии со своими потребностями.

В этой части руководства вы назначите вновь добавленным требованиям состояние Draft, обеспечив структурированный и упорядоченный рабочий процесс.

1. В спецификации Fan_Spec нажмите элемент управления Columns справа от таблицы и убедитесь, что пункт для столбца State отмечен, чтобы этот столбец отображался в таблице.

   

2. Установите флажок слева от заголовка столбца Identifier, чтобы выбрать все требования в спецификации.

   

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