Курс 6. Перехід на Holarch: аркуш вправ
Для команд, що переходять з інших інструментів. Одне практичне завдання й кілька запитань до кожного розділу, щоб опрацювати їх після кожного відео. Надрукуйте цю сторінку з браузера або працюйте на екрані. Відповіді починаються з нової сторінки наприкінці.
Перш ніж почати
- Спершу пройдіть
- Курс 1. Початок роботи, розділи 1.1–1.3.
- Тариф
- Безкоштовно
- Проєкт
- Ваші власні файли вимог або файли, експортовані з демо EO-1 для практики.
6.1 Планування міграції
Дивитися розділ 6.1 (3:00)
Практика
На демопроєкті CubeSat EO-1:
- Відкрийте свій демопроєкт EO-1 (якщо його немає, створіть: Керування проєктами → Файли проєкту ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)).
- Відкрийте Налаштування → Схема на бічній панелі, натисніть Вимога у розділі Класи і перелічіть атрибути, які могла б заповнити таблиця вимог (наприклад, Priority, Owner, Verification Method).
- Відкрийте сторінку схеми Мітки і знайдіть, де зберігаються види, як-от Performance Requirement.
- Припустімо, трекер постачальника має стовпець
Supplier Ref, якому немає місця: у Вимога натисніть + Атрибут, назвіть йогоSupplier Ref, оберіть текстовий тип і натисніть Додати атрибут. - Відкрийте Потреби та вимоги → Імпорт і експорт і прочитайте, які формати приймає зона перетягування і що пропонує картка Експорт.
Завдання виконано, коли Supplier Ref стоїть останнім у списку атрибутів Requirement і ви можете сказати, куди потрапить кожен стовпець типового трекера.
Запитання
- Чому варто вирішити, куди йде кожен вид даних, ще до імпорту?
- Для стовпця немає відповідного атрибута. Які у вас варіанти?
- Імпорт пройшов невдало. Як його скасувати?
- Коли використовувати Керування проєктами → Імпортувати проєкт (.json)… замість сторінки «Імпорт»?
6.2 Вимоги з Excel і CSV
Дивитися розділ 6.2 (2:32)
Практика
На демопроєкті CubeSat EO-1:
- Відкрийте свій демопроєкт EO-1 (якщо його немає, створіть: Керування проєктами → Файли проєкту ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)). У Базі даних знайдіть
class:Requirement, натисніть Експортувати…, оберіть Таблиця (CSV), позначте Пріоритет і Статус (залиште позначку Мітки) і натисніть Експортувати. - Відкрийте файл у програмі електронних таблиць. Залиште заголовок і рядки розділів 1 і 2, а потім додайте вгорі два рядки:
1,Mission Imaging, ClassStatementі2,Attitude Determination and Control, ClassStatement. Збережіть файл як .xlsx або .csv. - У Керуванні проєктами натисніть + Новий проєкт, назвіть його
EO-1 Import Practiceі натисніть Створити проєкт. - Відкрийте Потреби та вимоги → Імпорт і експорт, перетягніть файл, натисніть Продовжити і перевірте Поле Holarch кожного стовпця (для стовпців, які вам не потрібні, встановіть Пропустити).
- Натисніть Продовжити, залиште позначку Створити документ із цих N елементів і натисніть Імпортувати N елементів.
- У новому документі перевірте, що 1.6.1 і 1.6.2 стоять під 1.6, і виберіть 1.5, щоб побачити її мітки та статус.
Завдання виконано, коли новий документ показує розділи 1 і 2 з вимогами, вкладеними за номерами, а мітки й статуси збережено.
Запитання
- Як Holarch відновлює ієрархію рядків таблиці?
- Деякі рядки надійшли з неправильним класом. Чому?
- Потрібно оновити власників 50 наявних вимог з таблиці, а не створювати копії. Як це зробити?
6.3 Вимоги з Word і ReqIF
Дивитися розділ 6.3 (2:22)
Практика
На демопроєкті CubeSat EO-1:
- Відкрийте свій демопроєкт EO-1 (якщо його немає, створіть: Керування проєктами → Файли проєкту ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)). Відкрийте Документи → EO-1 System Requirements Specification і натисніть Видати ▾ → Специфікація (Word).
- У тому самому документі натисніть Видати ▾ → Вимоги (ReqIF)… і натисніть Експортувати.
- У Керуванні проєктами натисніть + Новий проєкт, назвіть його
EO-1 Import Practiceі натисніть Створити проєкт. Відкрийте Потреби та вимоги → Імпорт і експорт, перетягніть .docx, двічі натисніть Продовжити й імпортуйте файл. - Порівняйте новий документ із SRS: зверніть увагу, які заголовки стали Statement, а які речення з shall — Requirement, і як їх названо.
- Імпортуйте файл .reqif у той самий проєкт, потім відкрийте створений ним документ і виберіть 1.6 Revisit Time, щоб перевірити її дочірні елементи й мітки.
Завдання виконано, коли проєкт містить два документи, один з Word і один з ReqIF, і ви можете сказати, який зберіг початкові назви й номери.
Запитання
- Що імпорт Word сприймає як розділ, а що — як вимогу?
- Постачальник може надіслати Word або ReqIF. Чому варто просити ReqIF?
- Зв’язок ReqIF має назву, якої Holarch не знає. Що відбувається?
6.4 Моделі з інших інструментів
Дивитися розділ 6.4 (2:44)
Практика
На демопроєкті CubeSat EO-1:
- Відкрийте свій демопроєкт EO-1 (якщо його немає, створіть: Керування проєктами → Файли проєкту ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)). Відкрийте Потреби та вимоги → Імпорт і експорт, натисніть Експортувати UML/SysML (XMI)… на картці «Експорт», залиште Формат OMG XMI 2.5.1 (.xmi) і натисніть Експортувати. Цей файл замінює експорт з інструмента SysML, як-от Cameo чи Enterprise Architect.
- У Керуванні проєктами натисніть + Новий проєкт, назвіть його
EO-1 Import Practiceі натисніть Створити проєкт. Відкрийте Потреби та вимоги → Імпорт і експорт, перетягніть файл .xmi, перевірте, що Формат показує UML/SysML (.xmi, .uml, .mdzip), двічі натисніть Продовжити, прочитайте Перегляд і натисніть Імпортувати N елементів. - У Базі даних знайдіть
class:Asset, виберіть Payload Camera і перевірте в Трасування, що вона є частиною EO-1 Spacecraft і які дії виконує. - Відкрийте Діаграми, натисніть + Нова діаграма, оберіть Діаграма Asset, оберіть EO-1 Spacecraft у Діаграма для і натисніть Створити.
- Увімкніть Виконувані дії, щоб показати функції кожної підсистеми.
Завдання виконано, коли Діаграма Asset нового проєкту показує підсистеми космічного апарата з діями, які вони виконують.
Запитання
- Які файли з інструмента SysML v1 може імпортувати Holarch і як їх отримати?
- Чому після імпорту діаграми можна швидко відновити?
- Ви імпортуєте пізніший експорт тієї самої моделі. Чому не з’являються копії?
6.5 Упорядкування після імпорту
Дивитися розділ 6.5 (2:40)
Практика
На демопроєкті CubeSat EO-1:
- Відкрийте свій проєкт
EO-1 Import Practiceз попередніх розділів (або імпортуйте CSV з вимогами EO-1, як у розділі 2). - Відкрийте Потреби та вимоги → Якість, оберіть один з імпортованих документів на панелі області й натисніть Перевірити якість.
- Якщо ви імпортували ті самі вимоги двічі (Word і ReqIF), позначте рядок дубліката в Базі даних і видаліть його через Видалити елемент… на панелі групових дій. Перепишіть 2.5 Safe Mode Recovery так, щоб вона була вимірюваною, і знову перевірте якість.
- Відкрийте Верифікація → Перевірки моделі і відкрийте правило Requirement.8, Leaf requirements no design entity meets.
- Якщо ви імпортували й елементи Asset (розділ 4), виберіть 2.1 Pointing Accuracy і в Трасування додайте satisfied by через + → Зв’язати наявний… до ADCS. Знову запустіть перевірки моделі.
Завдання виконано, коли 2.5 отримує вищу оцінку, ніж раніше, а Requirement.8 більше не показує 2.1.
Запитання
- Що аналізує перевірка якості, а що — перевірки моделі?
- Чому автоматична оцінка якості ніколи не перевищує 78%?
- Навіщо поєднувати вимоги й частини одразу після міграції?
Відповіді
6.1 Планування міграції
- Дані, що потрапляють у правильні класи, мітки, атрибути й зв’язки, одразу працюють у простеженні, перевірках якості та звітах. Виправлення після імпорту означає редагування багатьох елементів вручну.
- Додайте атрибут у «Налаштування → Схема» до імпорту або на кроці «Відповідність» зіставте стовпець із «Новий атрибут» (його буде додано до схеми).
- Натисніть ⌘Z / Ctrl+Z один раз: імпорт зі сторінки «Імпорт» — це один крок відмінення.
- Щоб відновити цілий проєкт як новий, окремий проєкт. Сторінка «Імпорт» об’єднує елементи файлу з відкритим проєктом.
6.2 Вимоги з Excel і CSV
- Зі стовпця «ID батьківського рядка» чи «Батьківський номер», якщо його зіставлено, інакше з номера структури: 1.2 стає під 1. Якщо батьківського елемента немає, використовується найближчий наявний предок.
- Стовпець Class з назвами, яких схема не знає, повертається до класу для рядків без класу з попередженням. Використовуйте назви класів з редактора схеми.
- Експортуйте їх зі стовпцем ID, відредагуйте файл та імпортуйте його, зіставивши стовпець ID з «Глобальний ID» і встановивши «Зіставляти наявні сутності за» на «Глобальний ID». Тоді «Перегляд» покаже їх у «Оновлені елементи».
6.3 Вимоги з Word і ReqIF
- Абзаци зі стилями заголовків Word стають Statement (розділами). Абзац із shall, must, will чи should стає Requirement з назвою за першими словами після дієслова. Заголовки, набрані звичайним жирним текстом, читаються як звичайний текст.
- ReqIF передає ідентифікатор, ієрархію, атрибути й зв’язки кожної вимоги. Коли постачальник надсилає новіший файл, його імпорт оновлює ті самі елементи, а не додає копії.
- Він надходить як traced to. Якщо схема не дозволяє traced to між цими двома класами, зв’язок пропускається з попередженням.
6.4 Моделі з інших інструментів
- XMI 2.x із профілем SysML 1.x з Cameo/MagicDraw, Enterprise Architect, Rhapsody чи Papyrus (експортуйте його з інструмента), проєкт Cameo чи MagicDraw .mdzip безпосередньо та файл Papyrus .uml. Окремо вимоги можна передати й у ReqIF, а таблиці — в Excel чи CSV.
- Компонування діаграм з іншого інструмента не імпортується, а зв’язки — так. Holarch малює діаграми Asset, ієрархії та інші за цими зв’язками.
- Кожен імпортований елемент зберігає свій XMI id, а «Зіставляти наявні сутності за» для файлів XMI типово встановлено на XMI ID, тож пізніший імпорт оновлює ці елементи. Наявні зв’язки не додаються вдруге.
6.5 Упорядкування після імпорту
- Перевірка якості оцінює формулювання кожної вимоги за властивостями доброї вимоги. Перевірки моделі шукають прогалини в усій моделі, як-от вимоги, яких ніщо не задовольняє, ізольовані елементи чи дії, яких ніхто не виконує.
- Correct і Feasible потребують людського судження, тому перевірка ніколи не позначає їх виконаними. Ви позначаєте їх після рецензування вимоги.
- Вони надходять із різних файлів без зв’язків між собою. Відтоді кожен зв’язок satisfied by живить простежуваність, покриття й перевірки моделі.
Опубліковано Holarch