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., и сколько элементов к ней относится. В General View, Interconnection View и Grid варианты, которые она не выбирает, и другие конфигурации скрыты, а каждая точка вариации показывает свой выбор, например 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 линейки продуктов или Нет правил: разрешено любое сочетание вариантов.
  • Конфигурации: таблица конфигураций и их вердиктов.
  • Сочетания: сколько существует сочетаний вариантов и сколько из них правила разрешают, исключают или оставляют неизвестными.
  • Новая конфигурация…

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

  • Конфигурирует: линейка продуктов.
  • Статус: вердикт; при его изменении о нём сообщается программам чтения с экрана.
  • Один список на точку вариации: выбранный вариант или Не выбрано. Одно нажатие “Отменить” отменяет изменение.
  • Правила: каждое правило как Выполнено, Нарушено или Неизвестно.
  • Показать в представлении ▾: 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® и OMG® — зарегистрированные товарные знаки Object Management Group, Inc. в США и других странах.