Определение продукта

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

• Сбор и написание требований

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

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

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

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

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

   

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

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

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

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

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

   

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

   

4. Перейдите в модуль Project, нажав значок на панели навигации модулей слева, и выберите запись About в списке Overview. Здесь вы можете в любое время изменить имя и описание проекта.

   
   Основная информация о проекте, такая как имя, описание, изображение, а также даты начала и окончания, доступна на странице About Project.

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

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

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

1. Загрузите следующий CSV-файл, содержащий требования заинтересованных сторон:

   Valifan_stakeholder_Requirements.csv

2. Перейдите в модуль Requirements, нажав значок на панели навигации модулей слева.

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

   

4. Откроется мастер Import Requirements. В области Create a specification задайте Name спецификации (например, Stakeholder_requirements), затем нажмите кнопку .

   

5. На следующем шаге необходимо загрузить CSV-файл, чтобы мастер импорта мог прочитать и импортировать его. Перетащите загруженный CSV-файл в область Drop file мастера Import Requirements (или щелкните по этой области, чтобы загрузить файл через диалоговое окно).

   

    Нажмите , чтобы продолжить.

6. На следующем шаге убедитесь, что столбцы данных из CSV-файла правильно сопоставлены со столбцами в Requirements and Systems Portal. При необходимости используйте раскрывающиеся списки Map To в верхней части таблицы. 

   

   Нажмите , чтобы продолжить.

7. Следующая страница мастера сообщит об успешном импорте. Нажмите элемент управления Check now в верхней части окна, чтобы преобразовать значения и единицы измерения в параметры (valis) в соответствии с подходом data-driven system engineering.

   

8. В открывшемся окне Valify Requirements вы увидите уведомление о том, что пять требований будут valified. Нажмите , чтобы продолжить, и получите уведомление о том, что найдено два vali. Нажмите , чтобы продолжить, а затем нажмите .

   

9. Как видите, 50 dB и 50 W были преобразованы из обычного текста в vali, которые мы сможем использовать позже.

   

   Закройте окно Valify Requirements, чтобы продолжить. Все требования были добавлены, а все обнаруженные значения преобразованы в vali. Vali выделены в требованиях.

   

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

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

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

1. Нажмите кнопку . В появившемся окне Create new specification введите Fan_Specs в поле Name  и нажмите .

   

2. Щелкните запись только что созданной спецификации в списке слева. Находясь в этой спецификации, нажмите кнопку (либо кнопку в правом верхнем углу).

   

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

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

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

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

   4. Убедитесь, что включен параметр Check for possible Valis.

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

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

   

4. В появившемся окне Valify Requirements нажмите кнопку . В требовании будет найден vali. Нажмите кнопку , чтобы преобразовать значение в vali, затем нажмите кнопку , чтобы продолжить, и после этого нажмите кнопку , чтобы завершить процесс.

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

   

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

   

Создание requirement valis внутри требования

Теперь мы вручную создадим новый 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 требования.

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

   

Декомпозиция требований с помощью связей родитель–дочерний элемент

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

   

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

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

   ❯ ❮ Javascript ID: RSP_FanTutorial_Requirements_ParentsChildren_Add

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

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

   

Генерация требований с помощью ValiAssistant

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

1. Нажмите кнопку  вверху, чтобы открыть окно ValiAssistant - Generate Requirements.

   

   Функция предлагает различные варианты использования AI для требований, включая генерацию требований, декомпозицию требований, создание сводки, валидацию требований, поиск несоответствий и т. д.

   Убедитесь, что выбран параметр Generate Requirements, и нажмите кнопку .

2. На следующей странице вы можете описать свой продукт, систему, подсистему и предоставить как можно больше информации, чтобы AI мог сформировать наилучшие требования на основе вашего описания. Поскольку нас интересуют требования безопасности, запросите два требования безопасности для нашего вентилятора, введя текст Create 2 safety requirements for designing a fan в поле под заголовком Generate Description.

   В текстовом поле под заголовком Customize ValiAssistant output вы можете дополнительно настроить запрос. Нам нужны требования, написанные в формате INCOSE; введите текст Apply the INCOSE guide to writing requirements в поле.

   

   Нажмите  , чтобы продолжить.

3. На следующей странице будет представлен результат работы AI, и вы сможете просмотреть, изменить, а также принять или отклонить любые предложения.

   

   Нажмите  , чтобы продолжить.

4. Закройте диалоговое окно, информирующее об успешной генерации требований. Сгенерированные требования будут показаны в таблице спецификации Fan_Spec.

   

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

В процессе разработки требования нередко развиваются и обновляются под влиянием различных факторов, таких как отзывы заинтересованных сторон и проектные ограничения. В Requirements & Systems 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 или щелкните в любом месте таблицы вне ячейки, чтобы завершить редактирование.

   ❯ ❮ Javascript ID: RSP_FanTutorial_Requirements_UpdateManageReview

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

   

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

   

Создание обсуждений по требованию

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

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

1. Нажмите кнопку  в поле Identifier требования R-Fan-002 и выберите команду Add » Discussion в появившемся меню.

   

2. Откроется окно Discussions relating to. В этом окне вы можете просматривать все обсуждения, комментировать существующие обсуждения и начинать новые. Введите @ в текстовое поле окна, чтобы отобразить раскрывающийся список пользователей.

   

3. Выберите любого пользователя из списка (отмеченный пользователь получит уведомление) и добавьте следующий текст: Is it feasible to have propellers for 50g, or do we need more mass allocation?

   

4. Нажмите , а затем в окне Discussions relating to. Обсуждение будет добавлено, и в таблице спецификаций появится значок .

   

5. Нажмите значок в верхней части страницы, чтобы открыть панель Discussions, из которой у вас будет доступ ко всем обсуждениям по спецификации или по всему модулю. Обсуждения можно создавать практически для любого объекта в Requirements & Systems Portal.

   

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

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

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

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

   

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

   

3. Дважды щелкните ячейку в столбце State, чтобы открыть раскрывающийся список с доступными вариантами состояния.

   

4. Выберите Draft в раскрывающемся списке и подтвердите обновление. Все требования получат состояние Draft.

   

Создание анализа/документации

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

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

1. Перейдите в модуль Analyses, щелкнув значок ​ на панели навигации модулей слева.

2. Нажмите кнопку  на открывшейся странице, чтобы создать новый анализ. В открывшемся окне Create Document введите Project_Summary в поле Document Name и нажмите .

   

3. Откроется новый анализ.

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

   Анализ состоит из блоков, которые могут содержать текст, изображения, видео, диаграммы или таблицы. Щелкните внутри существующего блока 1. Write heading... и введите Introduction.

   

4. Щелкните внутри существующего блока Write text... и добавьте в него следующее предложение: The ValiFan is designed in a way that it works with less power than conventional Fans.

   

5. Щелкните вне блока, чтобы сохранить содержимое.

6. Можно добавлять дополнительные блоки различных типов (текст, изображения, ссылки на требования и valis, бюджеты, графики или диаграммы). Мы создадим таблицу требований из спецификаций заинтересованных сторон. Нажмите элемент управления Click to add new block, и в открывшемся окне Add Block разверните элемент Table и выберите Requirements.

   

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

   

8. В открывшемся всплывающем окне нажмите значок , чтобы отобразить список доступных столбцов. Снимите выделение со всех столбцов в списке и оставьте выбранными только элементы Text и Specification.

   

9. Наведите курсор на заголовок столбца Specification, нажмите значок , а затем во всплывающем окне нажмите значок , чтобы получить доступ к параметрам фильтрации. Отключите запись спецификации Fan_Specs и оставьте включенной запись Stakeholder_requirements.

   

10. Теперь отображаются только требования спецификации Stakeholder_requirements. Фильтры можно применять к любому столбцу, что обеспечивает гибкость при представлении требований. 

    

11. Вы можете поделиться созданным анализом с коллегами, заинтересованными сторонами или любым человеком вне Requirements & Systems Portal. Для этого нажмите кнопку в правом верхнем углу страницы и выберите Share в появившемся меню. В открывшемся окне Share analysis выберите любого пользователя в раскрывающемся списке View as и нажмите кнопку . Это создаст новую ссылку, которую можно скопировать и отправить.

    

    • Общий анализ — это веб-представление документа, которое создается в Requirements & Systems Portal и остается актуальным с учетом последних изменений.

    • К веб-представлению может получить доступ любой пользователь без предоставления доступа к вашему Workspace.