Holarch

Обучение · Курс 6. Переход на Holarch

Курс 6. Переход на Holarch: лист упражнений

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

Перед началом

Сначала пройдите
Курс 1. Начало работы, главы 1.1–1.3.
Тариф
Бесплатно
Проект
Ваши собственные файлы требований или файлы, экспортированные для практики из демо EO-1.

6.1 Планирование перехода

Смотреть главу 6.1 (3:00)

Практика

На демо-проекте CubeSat EO-1:

  1. Откройте свой демо-проект EO-1 (если его нет, создайте: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия)).
  2. Откройте Настройки → Схема на боковой панели, щёлкните Требование в разделе Классы и перечислите атрибуты, которые могла бы заполнить таблица требований (например, Priority, Owner, Verification Method).
  3. Откройте страницу Метки схемы и найдите, где хранятся виды, такие как Performance Requirement.
  4. Допустим, в трекере поставщика есть столбец Supplier Ref, которому некуда попасть: у Требование нажмите + Атрибут, назовите его Supplier Ref, выберите текстовый тип и нажмите Добавить атрибут.
  5. Откройте Потребности и требования → Импорт и экспорт и посмотрите, какие форматы принимает область перетаскивания и что предлагает карточка Экспорт.

Готово, когда Supplier Ref стоит последним в списке атрибутов Requirement и вы можете сказать, куда попадёт каждый столбец типичного трекера.

Вопросы

  1. Зачем решать, куда пойдёт каждый вид данных, до импорта?
  2. Для столбца нет подходящего атрибута. Какие есть варианты?
  3. Импорт прошёл неправильно. Как его отменить?
  4. Когда использовать «Управление проектами → Импортировать проект (.json)…», а не страницу импорта?

6.2 Требования из Excel и CSV

Смотреть главу 6.2 (2:32)

Практика

На демо-проекте CubeSat EO-1:

  1. Откройте свой демо-проект EO-1 (если его нет, создайте: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия)). В Базе данных выполните поиск class:Requirement, нажмите Экспортировать…, выберите Таблица (CSV), отметьте Статус и Приоритет (оставьте отмеченным Метки) и нажмите Экспорт.
  2. Откройте файл в приложении электронных таблиц. Оставьте заголовок и строки разделов 1 и 2, затем добавьте сверху две строки: 1, Mission Imaging, Class Statement и 2, Attitude Determination and Control, Class Statement. Сохраните файл как .xlsx или .csv.
  3. В разделе Управление проектами нажмите + Новый проект, назовите его EO-1 Import Practice и нажмите Создать проект.
  4. Откройте Потребности и требования → Импорт и экспорт, перетащите файл, нажмите Продолжить и проверьте Поле Holarch каждого столбца (для ненужных столбцов задайте Пропустить).
  5. Нажмите Продолжить, оставьте отмеченным Создать документ из этих N элементов и нажмите Импортировать N элементов.
  6. В новом документе убедитесь, что 1.6.1 и 1.6.2 находятся под 1.6, и выберите 1.5, чтобы увидеть его метки и статус.

Готово, когда новый документ показывает разделы 1 и 2 с требованиями, вложенными по номерам, а метки и статусы сохранены.

Вопросы

  1. Как Holarch восстанавливает иерархию строк таблицы?
  2. Некоторые строки пришли с неверным классом. Почему?
  3. Нужно обновить владельцев 50 существующих требований из таблицы, а не создавать копии. Как это сделать?

6.3 Требования из Word и ReqIF

Смотреть главу 6.3 (2:22)

Практика

На демо-проекте CubeSat EO-1:

  1. Откройте свой демо-проект EO-1 (если его нет, создайте: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия)). Откройте Документы → EO-1 System Requirements Specification и нажмите Поставка ▾ → Спецификация (Word).
  2. В том же документе нажмите Поставка ▾ → Требования (ReqIF)… и нажмите Экспорт.
  3. В разделе Управление проектами нажмите + Новый проект, назовите его EO-1 Import Practice и нажмите Создать проект. Откройте Потребности и требования → Импорт и экспорт, перетащите .docx, дважды нажмите Продолжить и импортируйте его.
  4. Сравните новый документ с SRS: отметьте, какие заголовки стали Statement, а какие предложения с shall — Requirement, и как они были названы.
  5. Импортируйте файл .reqif в тот же проект, затем откройте созданный им документ и выберите 1.6 Revisit Time, чтобы проверить его дочерние элементы и метки.

Готово, когда в проекте два документа — один из Word и один из ReqIF — и вы можете сказать, какой из них сохранил исходные имена и номера.

Вопросы

  1. Что импорт Word считает разделом, а что — требованием?
  2. Поставщик может прислать Word или ReqIF. Почему стоит просить ReqIF?
  3. У связи ReqIF имя, которого Holarch не знает. Что происходит?

6.4 Модели из других инструментов

Смотреть главу 6.4 (2:44)

Практика

На демо-проекте CubeSat EO-1:

  1. Откройте свой демо-проект EO-1 (если его нет, создайте: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия)). Откройте Потребности и требования → Импорт и экспорт, нажмите Экспортировать UML/SysML (XMI)… на карточке «Экспорт», оставьте Формат OMG XMI 2.5.1 (.xmi) и нажмите Экспорт. Этот файл заменяет экспорт из инструмента SysML, например Cameo или Enterprise Architect.
  2. В разделе Управление проектами нажмите + Новый проект, назовите его EO-1 Import Practice и нажмите Создать проект. Откройте Потребности и требования → Импорт и экспорт, перетащите файл .xmi, убедитесь, что Формат показывает UML/SysML (.xmi, .uml, .mdzip), дважды нажмите Продолжить, прочитайте Проверка и нажмите Импортировать N элементов.
  3. В Базе данных выполните поиск class:Asset, выберите Payload Camera и проверьте в разделе Трассировка, что она входит в EO-1 Spacecraft и какие действия выполняет.
  4. Откройте Диаграммы, нажмите + Новая диаграмма, выберите Диаграмма Asset, выберите EO-1 Spacecraft в поле Диаграмма для и нажмите Создать.
  5. Включите Выполняемые Action, чтобы перечислить функции каждой подсистемы.

Готово, когда диаграмма Asset нового проекта показывает подсистемы космического аппарата с выполняемыми ими действиями.

Вопросы

  1. Какие файлы из инструмента SysML v1 может импортировать Holarch и как их получить?
  2. Почему после импорта можно быстро восстановить диаграммы?
  3. Вы импортируете более поздний экспорт той же модели. Почему не появляются копии?

6.5 Наведение порядка после импорта

Смотреть главу 6.5 (2:40)

Практика

На демо-проекте CubeSat EO-1:

  1. Откройте свой проект EO-1 Import Practice из предыдущих глав (или импортируйте CSV с требованиями EO-1, как в главе 2).
  2. Откройте Потребности и требования → Качество, выберите один из импортированных документов на панели области и нажмите Проверить качество.
  3. Если вы импортировали одни и те же требования дважды (Word и ReqIF), отметьте строку дубликата в Базе данных и удалите её командой Удалить элемент… на панели массовых действий. Перепишите 2.5 Safe Mode Recovery так, чтобы его можно было измерить, затем снова проверьте качество.
  4. Откройте Верификация → Проверки модели и откройте правило Requirement.8 «Leaf requirements no design entity meets».
  5. Если вы импортировали и активы (глава 4), выберите 2.1 Pointing Accuracy и в разделе Трассировка добавьте satisfied by к ADCS через + → Связать существующий…. Снова запустите проверки модели.

Готово, когда оценка 2.5 выше прежней, а Requirement.8 больше не показывает 2.1.

Вопросы

  1. Что проверяет проверка качества, а что — проверки модели?
  2. Почему автоматическая оценка качества никогда не превышает 78%?
  3. Зачем связывать требования и части сразу после перехода?

Ответы

6.1 Планирование перехода

  1. Данные, попавшие в правильные классы, метки, атрибуты и связи, сразу работают в прослеживании, проверках качества и отчётах. Исправление после импорта означает ручное редактирование множества элементов.
  2. Добавьте атрибут в «Настройки → Схема» до импорта или сопоставьте столбец с «Новый атрибут» (добавляется в схему) на шаге «Сопоставление».
  3. Нажмите ⌘Z / Ctrl+Z один раз: импорт со страницы импорта — один шаг отмены.
  4. Чтобы восстановить весь проект как новый, отдельный проект. Страница импорта объединяет элементы файла с открытым проектом.

6.2 Требования из Excel и CSV

  1. По столбцу «ID родительской строки» или «Номер родителя», если он сопоставлен, иначе по номеру в структуре: 1.2 попадает под 1. Если родителя нет, используется ближайший существующий предок.
  2. Столбец Class с именами, которых схема не знает, заменяется значением «Класс для строк без класса» с предупреждением. Используйте имена классов из редактора схемы.
  3. Экспортируйте их со столбцом ID, отредактируйте файл и импортируйте его, сопоставив столбец ID с «Глобальный ID» и задав «Сопоставлять существующие сущности по» значение «Глобальный ID». Тогда «Проверка» покажет их в разделе «Обновлённые элементы».

6.3 Требования из Word и ReqIF

  1. Абзацы со стилями заголовков Word становятся Statement (разделами). Абзац со словами shall, must, will или should становится Requirement, названным по первым словам после глагола. Заголовки, набранные обычным полужирным текстом, читаются как обычный текст.
  2. ReqIF переносит идентификатор, иерархию, атрибуты и связи каждого требования. Когда поставщик присылает более новый файл, его импорт обновляет те же элементы, а не добавляет копии.
  3. Она приходит как traced to. Если схема не допускает traced to между этими двумя классами, связь пропускается с предупреждением.

6.4 Модели из других инструментов

  1. XMI 2.x с профилем SysML 1.x из Cameo/MagicDraw, Enterprise Architect, Rhapsody или Papyrus (экспортируйте его из инструмента), напрямую проект Cameo или MagicDraw .mdzip и файл Papyrus .uml. Одни только требования можно также передать в ReqIF, а таблицы — в Excel или CSV.
  2. Компоновки диаграмм из другого инструмента не импортируются, а связи — импортируются. Holarch рисует по этим связям диаграммы Asset, иерархии и другие.
  3. Каждый импортированный элемент сохраняет свой XMI id, а «Сопоставлять существующие сущности по» для файлов XMI по умолчанию равно XMI ID, поэтому более поздний импорт обновляет эти элементы. Уже имеющиеся связи повторно не добавляются.

6.5 Наведение порядка после импорта

  1. Проверка качества оценивает формулировку каждого требования по качествам хорошего требования. Проверки модели просматривают всю модель в поисках пробелов, таких как требования, которым ничто не удовлетворяет, обособленные элементы или действия, которые никто не выполняет.
  2. Для Correct и Feasible нужно суждение человека, поэтому проверка никогда не отмечает их выполненными. Вы отмечаете их сами после рецензирования требования.
  3. Они приходят из разных файлов без связей между собой. Каждая связь satisfied by с этого момента питает прослеживаемость, покрытие и проверки модели.

Издатель: Holarch