Holarch

SysML v2

Варіанти та конфігурації SysML v2

Моделюйте лінійку продуктів у проєкті SysML v2: точки варіативності, варіанти, правила й конфігурації в Оглядачі та інспекторі, “Нова конфігурація…”, подання, показані як одна конфігурація, і аналізи компромісів між конфігураціями.

Як цим користуватися →

На цій сторінці
  1. Огляд
  2. Поняття
    1. Точки варіації та варіанти
    2. Лінійки продуктів
    3. Правила
    4. Конфігурації
  3. Як користуватися
    1. Коли й навіщо
    2. Позначити точку варіації
    3. Додати правило
    4. Створити конфігурацію
    5. Змінити вибір конфігурації
    6. Показати модель як одну конфігурацію
    7. Порівняти конфігурації в аналізі компромісів
    8. Приклад: демопроєкт Hybrid Car
    9. Поради та добрі практики
    10. Типові помилки
    11. Як це пов’язано з іншими функціями
  4. Оглядач
  5. Інспектор
    1. Лінійка продуктів
    2. Конфігурація
    3. Точка варіації та варіант
  6. Перегляд як конфігурації
  7. Повідомлення
  8. Обмеження
  9. Пов’язані сторінки

Огляд

Лінійка продуктів — це один проєкт із кількома точками, у яких її продукти відрізняються, як-от розмір батареї або наявність зарядного пристрою. Ви моделюєте лінійку один раз, а потім переглядаєте, перевіряєте й порівнюєте будь-який окремий продукт без копіювання моделі.

У SysML v2 це вбудовано в мову. Holarch показує це в усьому застосунку:

  • Оглядач позначає лінійки продуктів, точки варіації, варіанти й конфігурації та перелічує конфігурації кожної лінійки продуктів.
  • Інспектор показує точки, правила й конфігурації лінійки продуктів із вердиктом для кожної та дає змогу змінювати вибір конфігурації.
  • Нова конфігурація… створює конфігурацію з діалогу, який перевіряє правила під час вибору.
  • Переглянути як ▾ на верхній панелі показує подання, базу даних, інспектор і сторінку “Лінійка продуктів” як одну конфігурацію.
  • Аналізи компромісів можуть порівнювати конфігурації лінійки продуктів або варіанти точки.

Варіативність у тексті доступна в кожному тарифі. У тарифі Free сторінка “Лінійка продуктів”, “Нова конфігурація…” і зміна вибору конфігурації в інспекторі доступні лише для читання; їх редагування входить до тарифів Individual і Team. Див. Лінійки продуктів: тарифи.

Поняття

Точки варіації та варіанти

Точка варіації — це місце в проєкті, де продукти відрізняються. Її варіанти — це дозволені варіанти вибору.

  • Використання варіації — це точка всередині одного проєкту: variation part charger : Component { variant part noCharger; variant part wallbox; }.
  • Визначення варіації — це багаторазовий набір варіантів вибору: variation part def BatteryPack { variant part standardPack; variant part largePack; }. Використання, типізоване ним, як-от part pack : BatteryPack;, — теж точка.

Лінійки продуктів

Лінійка продуктів — це визначення або використання, яке володіє точками варіації або успадковує їх. У демопроєкті Hybrid Car лінійкою продуктів є CarLine: вона спеціалізує Car і додає точки pack і charger. Визначення, яке спеціалізує лінійку продуктів, — теж лінійка продуктів.

Правила

Правило — це assert constraint лінійки продуктів. Воно виключає комбінації варіантів. У демопроєкті wallboxNeedsLargePack указує, що зарядний пристрій wallbox потребує великого блока батарей:

assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }

Поки точку не вибрано, правило щодо неї ані виконується, ані порушується: його вердикт невідомий.

Конфігурації

Конфігурація — це один продукт лінійки. Це використання, типізоване лінійкою продуктів, яке прив’язує один варіант до кожної точки. Holarch позначає її через @HolarchConfiguration (пакет HolarchVariability), тож Редактор зазначає кожну точку, яку ще не вибрано:

part plugInHybrid : CarLine {
  @HolarchConfiguration;
  part :>> pack = BatteryPack::largePack;
  part :>> charger = charger::wallbox;
}

Кожна конфігурація має вердикт:

ВисновокЗначення
КоректнаДля кожної точки вибрано один варіант, і кожне правило виконано.
Порушує правило …Правило порушено; вердикт називає його.
НеповнаДля точки ще не вибрано варіант; вердикт називає її.
НевідомоПравило не вдалося обчислити, наприклад тому, що значення, яке воно читає, відсутнє.

Holarch також підраховує комбінації варіантів і скільки з них дозволяють правила. Для дуже великої лінійки продуктів він перевіряє лише перші комбінації й повідомляє, скільки перевірив.

Як користуватися

Коли й навіщо

Використовуйте варіативність, коли кілька продуктів мають спільну більшу частину одного проєкту: комплектації автомобіля, експортні версії, набори датчиків, продукт з опцією та без неї. Змоделюйте спільний проєкт один раз, позначте точки, де продукти відрізняються, і додайте конфігурацію для кожного продукту. Тоді кожен продукт залишається узгодженим із кожною зміною спільного проєкту.

Позначити точку варіації

  1. Відкрийте Редактор і пакет, який містить проєкт.
  2. Усередині визначення лінійки продуктів виберіть Вставити ▾ → Варіація. Заповніть назву й тип точки.
  3. Усередині варіації виберіть Вставити ▾ → Варіант один раз для кожного варіанта вибору.
  4. Щоб повторно використовувати набір варіантів вибору, виберіть Вставити ▾ → Варіація на рівні пакета. Це записує визначення варіації; типізуйте ним частину.

Тепер Оглядач показує лінійку продуктів зі значком складених блоків, а точку — з ромбом.

Додати правило

  1. Усередині визначення лінійки продуктів напишіть assert constraint щодо її точок, наприклад assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }.
  2. Виберіть лінійку продуктів в Оглядачі.

Ви бачите правило в розділі Правила секції Лінійка продуктів інспектора та кількість комбінацій, які воно виключає.

Створити конфігурацію

  1. У Оглядачі відкрийте меню рядка (⋯, клацання правою кнопкою або Shift+F10) лінійки продуктів або її групи Конфігурації.
  2. Виберіть Нова конфігурація….
  3. Перевірте Конфігурує: лінійку продуктів, до якої належить конфігурація.
  4. Введіть Назва, наприклад longRangeHybrid.
  5. У розділі Вибори варіантів виберіть один варіант для кожної точки варіації. Вердикт одразу з’являється під варіантами вибору, наприклад Коректна: виконує кожне правило або Порушує правило wallboxNeedsLargePack.
  6. Натисніть Створити.

Конфігурацію записано в текст після останньої конфігурації лінійки продуктів із позначкою @HolarchConfiguration, і одне натискання “Відмінити” повертає все назад. Оглядач виділяє її в групі Конфігурації лінійки продуктів.

Діалог також можна відкрити через Нова конфігурація… в секції Лінійка продуктів інспектора або з ⌘K / Ctrl+K.

Змінити вибір конфігурації

  1. Виберіть конфігурацію в Оглядачі (або в поданні).
  2. У секції Конфігурація інспектора виберіть інший варіант у списку точки.

Прив’язку в тексті переписано (part :>> pack = BatteryPack::standardPack;), і вердикт оновлюється; одне натискання “Відмінити” повертає все назад. Виберіть Не вибрано, щоб вилучити вибір. Вибір, який додав би помилку до моделі, відхиляють із причиною.

Показати модель як одну конфігурацію

  1. На верхній панелі натисніть Переглянути як ▾ (поки ви не виберете конфігурацію, там написано Усі конфігурації ▾) і виберіть конфігурацію. Банер під верхньою панеллю повідомляє, наприклад, Перегляд конфігурації plugInHybrid. і скільки елементів застосовано. У Загальних поданнях, Поданнях взаємозв’язків і Сітках варіанти, яких вона не вибирає, та інші конфігурації приховано, а кожна точка варіації показує свій вибір, як-от pack : BatteryPack = largePack. База даних, інспектор і сторінка “Лінійка продуктів” дотримуються того самого вибору.
  2. Щоб повернутися, виберіть Переглянути як ▾ → Усі конфігурації або натисніть Вийти в банері.

У тарифах Individual і Team можна редагувати, поки показано конфігурацію; кожна зміна — це зміна тексту SysML v2, перевірена перед застосуванням, і кожну з них повертає назад одне натискання “Відмінити”:

  • Вибір варіанта записує прив’язку в конфігурації (part :>> pack = BatteryPack::largePack;).
  • Змінене значення атрибута стає власним значенням конфігурації; визначення зберігає своє значення.
  • Нові частини й дії належать конфігурації.
  • Видалення успадкованого елемента, який можна пропустити, записує part :>> roofBox[0]; у конфігурації. Обов’язковий успадкований елемент там видалити не можна; змініть його в Редакторі.
  • Ризик, завдання або інший створений вами елемент Holarch стосується конфігурації.

У тарифі Free подання конфігурації доступне лише для читання. З інспектора конфігурації Показати в поданні ▾ відкриває подання її лінійки продуктів, показане як ця конфігурація.

Порівняти конфігурації в аналізі компромісів

  1. Відкрийте Ризики, проблеми та рішення → Аналізи компромісів і аналіз (або натисніть + Новий аналіз компромісів).
  2. У розділі Альтернативи натисніть + З лінійки продуктів….
  3. У полі Від виберіть Конфігурації … (лінійки продуктів) або Варіанти … (точки варіації).
  4. Зніміть позначку з елементів, які вам не потрібні, і натисніть Додати.

Кожна конфігурація або варіант стає альтернативою, пов’язаною з елементом моделі. Додайте критерії й значення, як у будь-якому аналізі компромісів, або скористайтеся Отримати значення з моделі.

Приклад: демопроєкт Hybrid Car

Створіть демопроєкт через Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2) на сторінці “Керування проєктами”.

  1. Відкрийте Модель → Оглядач і розгорніть Vehicles. BatteryPack і CarLine мають значки лінійки продуктів; CarLine має групу Конфігурації з longRangeHybrid, plugInHybrid і selfChargingHybrid.
  2. Виберіть CarLine. Секція Лінійка продуктів перелічує точки pack (standardPack, largePack) і charger (noCharger, wallbox), правило wallboxNeedsLargePack і три конфігурації, усі Коректна. Вона повідомляє про 4 комбінації: 3 дозволено правилами, 1 виключено (wallbox зі стандартним блоком батарей).
  3. Виберіть selfChargingHybrid і змініть charger на wallbox. Вердикт стає Порушує правило wallboxNeedsLargePack. Натисніть ⌘Z / Ctrl+Z, щоб відмінити.
  4. Відкрийте подання carLineVariants (Діаграми). Виберіть Переглянути як ▾ → plugInHybrid. Блок BatteryPack залишає лише largePack, а блок CarLine показує pack : BatteryPack = largePack і variation charger : Component = wallbox.
  5. Відкрийте Аналізи компромісів → Configuration Line-up (TR-2). Його альтернативи — три конфігурації, оцінені за ціною, запасом ходу на електриці та зручністю заряджання.

Поради та добрі практики

  • Тримайте спільний проєкт у лінійці продуктів, а у варіантах — лише відмінності. Варіант перевизначає те, що змінює (attribute :>> capacity = 12 [kW*h];).
  • Пишіть правила, щойно дізнаєтеся, що комбінація недопустима. Тоді вердикти одразу виявлять погану конфігурацію.
  • Називайте конфігурації за продуктом, а не за варіантами вибору (plugInHybrid, а не largePackWallbox).
  • Використовуйте одне подання на лінійку продуктів і перемикайте його між конфігураціями замість одного подання на конфігурацію.

Типові помилки

  • Конфігурацію не наведено під її лінійкою продуктів. Вона має бути типізована лінійкою продуктів (part x : CarLine). Перевірте її Тип в інспекторі.
  • Вердикт залишається “Невідомо”. Правило читає значення, яке в цій конфігурації відсутнє. Виберіть варіант для кожної точки або задайте значенню значення за замовчуванням.
  • Вибір відхилено. Варіант не є одним із варіантів цієї точки. Виберіть зі списку в інспекторі або виправте назву в тексті.

Як це пов’язано з іншими функціями

  • Редактор: Вставити ▾ записує Варіацію, Варіант, Конфігурацію та Вибір варіанта. Усе тут — звичайний текст SysML v2, тож імпорти, експорти й інші інструменти SysML v2 його читають.
  • Аналізи компромісів: конфігурації й варіанти як альтернативи.
  • Структурні схеми надійності: варіанти точки варіації є альтернативами, тож діаграма враховує лише варіант, вибраний конфігурацією в Переглянути як ▾. Коли показано всі конфігурації, точка — це один блок із власними значеннями, а панель пропонує вибрати конфігурацію.
  • Перевірки моделі: Верифікація → Перевірки моделі повідомляє про кожну конфігурацію, яка порушує правило або залишає точку варіації без варіанта (ProductLine.3, помилка). Примітка — це вердикт, як-от Порушує правило wallboxNeedsLargePack, а порушені правила перелічено як пов’язані елементи. Виправити → Відкрити елемент відкриває конфігурацію. API і MCP повідомляють те саме зауваження (run_model_checks, GET …/model-checks).
  • Запити на зміну та історія: кожна зміна — звичайна зміна моделі, і кожну з них повертає назад одне натискання “Відмінити”.

Оглядач

  • Значки: складені блоки для лінійки продуктів, ромб для точки варіації, зафарбований ромб для варіанта, повзунки для конфігурації. Кожен значок має підказку.
  • Група “Конфігурації”: перший член рядка лінійки продуктів. Вона перелічує конфігурації лінійки продуктів, хоч би де їх оголошено; кожен рядок там представляє саму конфігурацію. Меню її рядка має Нова конфігурація….
  • Меню рядка: Нова конфігурація… на лінійці продуктів і на кожній її конфігурації.
  • Зчитувачі екрана: назва рядка повідомляє, що це, наприклад CarLine, part def, лінійка продуктів або plugInHybrid, part, конфігурація CarLine.

Інспектор

Лінійка продуктів

  • Точки варіації: кожна точка з варіантами, з яких вона вибирає.
  • Правила: assert constraint лінійки продуктів або Немає правил: дозволено кожну комбінацію варіантів.
  • Конфігурації: таблиця конфігурацій та їхніх вердиктів.
  • Комбінації: скільки існує комбінацій варіантів і скільки з них правила дозволяють, виключають або залишають невідомими.
  • Нова конфігурація…

Конфігурація

  • Конфігурує: лінійку продуктів.
  • Стан: вердикт, про зміну якого повідомляється зчитувачам екрана.
  • Один список на точку варіації: вибраний варіант або Не вибрано. Одне натискання “Відмінити” повертає зміну назад.
  • Правила: кожне правило як Виконано, Порушено або Невідомо.
  • Показати в поданні ▾: Загальні подання, Подання взаємозв’язків і Сітки, які показують лінійку продуктів, відкриті як ця конфігурація.

Точка варіації та варіант

  • Точка варіації перелічує свої Варіанти, а в розділі Вибрано в — що вибирає кожна конфігурація.
  • Варіант показує, для чого він є Варіант для, і які конфігурації його вибирають.

Перегляд як конфігурації

  • Де: верхня панель, щойно модель має конфігурацію. Один вибір на вкладку браузера: Загальні подання, Подання взаємозв’язків і Сітки, база даних, інспектор і сторінка “Лінійка продуктів” дотримуються його.
  • Елемент керування: Переглянути як ▾ (поки ви не виберете конфігурацію, там написано Усі конфігурації ▾). Меню перелічує Усі конфігурації, конфігурації кожної лінійки продуктів з їхніми вердиктами, Застосовність ▸ (показати модель для серійного номера, дати складання або обох: Серійний номер і дата… — це екземпляр із цим серійним номером, складений цієї дати) і Керувати лінійкою продуктів. Банер під верхньою панеллю має Змінити ▾ і Вийти.
  • Що змінюється: варіанти, яких конфігурація не вибирає, та інші конфігурації тієї самої лінійки продуктів приховано разом із тим, чим вони володіють. Точки варіації показують свій вибір. Компонування не переставляються й спільні для всіх конфігурацій.
  • Редагування: тарифи Individual і Team. Зміни підлягають правилам із розділу Показати модель як одну конфігурацію. У тарифі Free, а також для людей із доступом на перегляд, подання доступне лише для читання, і банер пояснює чому.
  • Сітка: таблиця пропускає приховані елементи й називає варіанти вибору над таблицею. Матриця показує всю лінійку продуктів.
  • Для кожної вкладки: вибір зберігається для вкладки браузера, доки ви його не зміните. Зображення подання в списку “Діаграми” показують усю лінійку продуктів.
  • Зчитувачі екрана: перемикання озвучує конфігурацію й кількість застосованих елементів, наприклад Перегляд конфігурації plugInHybrid. … елементів застосовано., з доданим Лише для читання., коли редагувати не можна.

Повідомлення

ПовідомленняЩо робити
Модель ще не має точок варіації. Додайте варіацію в Редакторі (Вставити ▾ → Варіація), потім спробуйте ще раз.Спершу позначте точку варіації.
Модель ще не має конфігурацій або варіантів. … (+ З лінійки продуктів…)Спершу додайте точку варіації або конфігурацію.
Введіть назву конфігурації.Введіть назву в полі Назва.
… уже використано в …. Виберіть іншу назву.Інший елемент у тому самому пакеті має таку назву.
Назви мають від 1 до 1,000 символів і не містять розривів рядка. Змініть назву.Скоротіть назву або вилучіть розрив рядка.
Відхилений вибір або конфігураціяЦе додало б помилку до моделі; повідомлення називає помилку. Виправте текст або виберіть інший варіант.
Перевірка SysML недоступна, тож точки варіації не вдається прочитати.Перезавантажте сторінку або створіть конфігурацію в Редакторі через Вставити ▾ → Конфігурація.

Обмеження

  • Для дуже великої лінійки продуктів підрахунок комбінацій перевіряє лише перші комбінації; конфігурації завжди перевіряються повністю.
  • У тарифі Free подання, показане як одна конфігурація, доступне лише для читання.
  • Поки що ні: випуск або виведення конфігурації SysML v2. Кожна конфігурація SysML v2 має стан “Чернетка”, тож керування конфігурацією її не блокує.
  • Варіативність охоплює модель SysML v2. Елементи Holarch поруч із нею (ризики, тести, завдання, розділи документів) стосуються кожної конфігурації, крім створених, коли показано конфігурацію: вони стосуються цієї конфігурації. Їхнє поле “Застосовується до” у проєкті SysML v2 поки що не можна редагувати.

SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.