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., и сколько элементов к ней относится. В General View, Interconnection View и Grid варианты, которые она не выбирает, и другие конфигурации скрыты, а каждая точка вариации показывает свой выбор, например 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 линейки продуктов или Нет правил: разрешено любое сочетание вариантов.
- Конфигурации: таблица конфигураций и их вердиктов.
- Сочетания: сколько существует сочетаний вариантов и сколько из них правила разрешают, исключают или оставляют неизвестными.
- Новая конфигурация…
Конфигурация
- Конфигурирует: линейка продуктов.
- Статус: вердикт; при его изменении о нём сообщается программам чтения с экрана.
- Один список на точку вариации: выбранный вариант или Не выбрано. Одно нажатие “Отменить” отменяет изменение.
- Правила: каждое правило как Выполнено, Нарушено или Неизвестно.
- Показать в представлении ▾: General View, Interconnection View и Grid, которые показывают линейку продуктов, открываются как эта конфигурация.
Точка вариации и вариант
- Точка вариации перечисляет свои Варианты и в разделе Выбрано в — что выбирает каждая конфигурация.
- Вариант показывает, для чего он является вариантом (Вариант для), и какие конфигурации его выбирают.
Просмотр как конфигурации
- Где: на верхней панели, как только в модели появляется конфигурация. Один выбор на вкладку браузера: General View, Interconnection View и Grid, база данных, инспектор и страница «Линейка продуктов» следуют ему.
- Элемент управления: Просмотреть как ▾ (пока вы ничего не выбрали, кнопка называется Все конфигурации ▾). Меню перечисляет Все конфигурации, конфигурации каждой линейки продуктов с их вердиктами, Применимость ▸ (показать модель для серийного номера, даты сборки или обоих: Серийный номер и дата… — изделие с этим серийным номером, собранное в эту дату) и Управление линейкой продуктов. На баннере под верхней панелью есть Изменить ▾ и Выйти.
- Что меняется: варианты, которые конфигурация не выбирает, и другие конфигурации той же линейки продуктов скрываются вместе со всем, чем владеют. Точки вариации показывают свой выбор. Компоновки не перестраиваются и общие для всех конфигураций.
- Редактирование: тарифы Individual и Team. Правки подчиняются правилам из раздела Показать модель как одну конфигурацию. На тарифе Free, а также для пользователей с доступом на просмотр представление доступно только для чтения, и баннер объясняет причину.
- Сетка: таблица не включает скрытые элементы и называет выбор над таблицей. Матрица показывает всю линейку продуктов.
- Для каждой вкладки: выбор сохраняется для вкладки браузера, пока вы его не измените. Изображения представления в списке «Диаграммы» показывают всю линейку продуктов.
- Программы чтения с экрана: при переключении объявляются конфигурация и число относящихся к ней элементов, например Просмотр конфигурации plugInHybrid. Относится элементов: …., с добавлением Только для чтения., если редактировать нельзя.
Сообщения
| Сообщение | Что делать |
|---|---|
| В модели ещё нет точек вариации. Добавьте вариацию в Редакторе («Вставить ▾ → Вариация») и повторите попытку. | Сначала отметьте точку вариации. |
| В модели ещё нет конфигураций или вариантов. … (+ Из линейки продуктов…) | Сначала добавьте точку вариации или конфигурацию. |
| Введите имя конфигурации. | Введите имя в поле Имя. |
| … уже используется в …. Выберите другое имя. | Другой элемент в том же пакете имеет это имя. |
| Имена содержат от 1 до 1 000 символов без переносов строк. Измените имя. | Сократите имя или удалите перенос строки. |
| Отклонённый выбор или конфигурация | Это добавило бы ошибку в модель; сообщение называет ошибку. Исправьте текст или выберите другой вариант. |
| Средство проверки SysML недоступно, поэтому точки вариации нельзя прочитать. | Перезагрузите страницу или создайте конфигурацию в Редакторе через Вставить ▾ → Конфигурация. |
Ограничения
- Для очень большой линейки продуктов подсчёт сочетаний проверяет только первые сочетания; конфигурации всегда проверяются полностью.
- На тарифе Free представление, показанное как одна конфигурация, доступно только для чтения.
- Пока нет: выпуск или вывод из обращения конфигурации SysML v2. Каждая конфигурация SysML v2 находится в статусе Draft, поэтому управление конфигурацией её не блокирует.
- Вариативность охватывает модель SysML v2. Элементы Holarch рядом с ней (риски, тесты, задачи, разделы документов) относятся ко всем конфигурациям, кроме созданных, пока показана конфигурация: они относятся к этой конфигурации. Их поле Applies To в проекте SysML v2 пока нельзя редактировать.
Связанные страницы
- Текстовая нотация SysML v2: вариации, варианты и конфигурации
- Представления SysML v2
- Анализ SysML v2: анализ компромиссов
SysML® и OMG® — зарегистрированные товарные знаки Object Management Group, Inc. в США и других странах.