SysML v2
Варіанти та конфігурації SysML v2
Моделюйте лінійку продуктів у проєкті SysML v2: точки варіативності, варіанти, правила й конфігурації в Оглядачі та інспекторі, “Нова конфігурація…”, подання, показані як одна конфігурація, і аналізи компромісів між конфігураціями.
На цій сторінці
Огляд
Лінійка продуктів — це один проєкт із кількома точками, у яких її продукти відрізняються, як-от розмір батареї або наявність зарядного пристрою. Ви моделюєте лінійку один раз, а потім переглядаєте, перевіряєте й порівнюєте будь-який окремий продукт без копіювання моделі.
У 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 також підраховує комбінації варіантів і скільки з них дозволяють правила. Для дуже великої лінійки продуктів він перевіряє лише перші комбінації й повідомляє, скільки перевірив.
Як користуватися
Коли й навіщо
Використовуйте варіативність, коли кілька продуктів мають спільну більшу частину одного проєкту: комплектації автомобіля, експортні версії, набори датчиків, продукт з опцією та без неї. Змоделюйте спільний проєкт один раз, позначте точки, де продукти відрізняються, і додайте конфігурацію для кожного продукту. Тоді кожен продукт залишається узгодженим із кожною зміною спільного проєкту.
Позначити точку варіації
- Відкрийте Редактор і пакет, який містить проєкт.
- Усередині визначення лінійки продуктів виберіть Вставити ▾ → Варіація. Заповніть назву й тип точки.
- Усередині варіації виберіть Вставити ▾ → Варіант один раз для кожного варіанта вибору.
- Щоб повторно використовувати набір варіантів вибору, виберіть Вставити ▾ → Варіація на рівні пакета. Це записує визначення варіації; типізуйте ним частину.
Тепер Оглядач показує лінійку продуктів зі значком складених блоків, а точку — з ромбом.
Додати правило
- Усередині визначення лінійки продуктів напишіть assert constraint щодо її точок, наприклад
assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }. - Виберіть лінійку продуктів в Оглядачі.
Ви бачите правило в розділі Правила секції Лінійка продуктів інспектора та кількість комбінацій, які воно виключає.
Створити конфігурацію
- У Оглядачі відкрийте меню рядка (⋯, клацання правою кнопкою або Shift+F10) лінійки продуктів або її групи Конфігурації.
- Виберіть Нова конфігурація….
- Перевірте Конфігурує: лінійку продуктів, до якої належить конфігурація.
- Введіть Назва, наприклад
longRangeHybrid. - У розділі Вибори варіантів виберіть один варіант для кожної точки варіації. Вердикт одразу з’являється під варіантами вибору, наприклад Коректна: виконує кожне правило або Порушує правило wallboxNeedsLargePack.
- Натисніть Створити.
Конфігурацію записано в текст після останньої конфігурації лінійки продуктів із позначкою @HolarchConfiguration, і одне натискання “Відмінити” повертає все назад. Оглядач виділяє її в групі Конфігурації лінійки продуктів.
Діалог також можна відкрити через Нова конфігурація… в секції Лінійка продуктів інспектора або з ⌘K / Ctrl+K.
Змінити вибір конфігурації
- Виберіть конфігурацію в Оглядачі (або в поданні).
- У секції Конфігурація інспектора виберіть інший варіант у списку точки.
Прив’язку в тексті переписано (part :>> pack = BatteryPack::standardPack;), і вердикт оновлюється; одне натискання “Відмінити” повертає все назад. Виберіть Не вибрано, щоб вилучити вибір. Вибір, який додав би помилку до моделі, відхиляють із причиною.
Показати модель як одну конфігурацію
- На верхній панелі натисніть Переглянути як ▾ (поки ви не виберете конфігурацію, там написано Усі конфігурації ▾) і виберіть конфігурацію. Банер під верхньою панеллю повідомляє, наприклад, Перегляд конфігурації plugInHybrid. і скільки елементів застосовано. У Загальних поданнях, Поданнях взаємозв’язків і Сітках варіанти, яких вона не вибирає, та інші конфігурації приховано, а кожна точка варіації показує свій вибір, як-от pack : BatteryPack = largePack. База даних, інспектор і сторінка “Лінійка продуктів” дотримуються того самого вибору.
- Щоб повернутися, виберіть Переглянути як ▾ → Усі конфігурації або натисніть Вийти в банері.
У тарифах Individual і Team можна редагувати, поки показано конфігурацію; кожна зміна — це зміна тексту SysML v2, перевірена перед застосуванням, і кожну з них повертає назад одне натискання “Відмінити”:
- Вибір варіанта записує прив’язку в конфігурації (
part :>> pack = BatteryPack::largePack;). - Змінене значення атрибута стає власним значенням конфігурації; визначення зберігає своє значення.
- Нові частини й дії належать конфігурації.
- Видалення успадкованого елемента, який можна пропустити, записує
part :>> roofBox[0];у конфігурації. Обов’язковий успадкований елемент там видалити не можна; змініть його в Редакторі. - Ризик, завдання або інший створений вами елемент Holarch стосується конфігурації.
У тарифі Free подання конфігурації доступне лише для читання. З інспектора конфігурації Показати в поданні ▾ відкриває подання її лінійки продуктів, показане як ця конфігурація.
Порівняти конфігурації в аналізі компромісів
- Відкрийте Ризики, проблеми та рішення → Аналізи компромісів і аналіз (або натисніть + Новий аналіз компромісів).
- У розділі Альтернативи натисніть + З лінійки продуктів….
- У полі Від виберіть Конфігурації … (лінійки продуктів) або Варіанти … (точки варіації).
- Зніміть позначку з елементів, які вам не потрібні, і натисніть Додати.
Кожна конфігурація або варіант стає альтернативою, пов’язаною з елементом моделі. Додайте критерії й значення, як у будь-якому аналізі компромісів, або скористайтеся Отримати значення з моделі.
Приклад: демопроєкт Hybrid Car
Створіть демопроєкт через Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2) на сторінці “Керування проєктами”.
- Відкрийте Модель → Оглядач і розгорніть Vehicles.
BatteryPackіCarLineмають значки лінійки продуктів;CarLineмає групу Конфігурації зlongRangeHybrid,plugInHybridіselfChargingHybrid. - Виберіть
CarLine. Секція Лінійка продуктів перелічує точкиpack(standardPack, largePack) іcharger(noCharger, wallbox), правилоwallboxNeedsLargePackі три конфігурації, усі Коректна. Вона повідомляє про 4 комбінації: 3 дозволено правилами, 1 виключено (wallbox зі стандартним блоком батарей). - Виберіть
selfChargingHybridі змініть charger на wallbox. Вердикт стає Порушує правило wallboxNeedsLargePack. Натисніть ⌘Z / Ctrl+Z, щоб відмінити. - Відкрийте подання
carLineVariants(Діаграми). Виберіть Переглянути як ▾ → plugInHybrid. БлокBatteryPackзалишає лишеlargePack, а блокCarLineпоказує pack : BatteryPack = largePack і variation charger : Component = wallbox. - Відкрийте Аналізи компромісів → 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 v2: варіації, варіанти та конфігурації
- Подання SysML v2
- Аналіз SysML v2: аналізи компромісів
SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.