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

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

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

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

• Рецензирование и улучшение требований

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

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

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

   

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

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

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

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

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

   

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

   

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

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

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

   Valifan_stakeholder_Requirements.csv

2. Если вы еще не там, перейдите в Requirements Module, щелкнув элемент 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. Новая спецификация создана, и все требования импортированы в нее. Обнаруженные значения и единицы измерения были преобразованы из обычного текста в valis (параметры), которые выделены в требованиях.

    

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

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

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

   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 пока нет.

   

Создание Requirement Valis внутри требования

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

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

   

2. Введите $, чтобы открыть всплывающее окно со списком valis/объектов внутри проекта. В правом верхнем углу всплывающего окна нажмите кнопку , чтобы создать 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 теперь можно использовать в различных частях проекта (например, в отчетах, Blocks Module, верификации и т. д.).

   

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

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

   

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

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

   

   

    

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

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

   

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

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

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.