Holarch

SysML v2

Преобразование между LML и SysML v2

Создание копии проекта LML в SysML v2 или копии проекта SysML v2 в LML с отчётом о том, что преобразуется, а что нет.

Как использовать →

На этой странице
  1. Обзор
  2. Понятия
    1. Копия, а не смена типа
    2. Как соотносятся два языка
    3. Данные Holarch переносятся вместе с моделью
    4. Что не преобразуется
  3. Как использовать
    1. Когда и зачем
    2. Создание преобразованной копии
    3. Проверка копии
    4. Рабочий пример: демо Hybrid Car как копия LML
    5. Советы и рекомендации
    6. Типичные ошибки
  4. Справочник по отчёту
    1. LML в SysML v2
    2. SysML v2 в LML
    3. CSV отчёта
  5. Сообщения
  6. Ограничения
  7. Связанные страницы

Обзор

Тип проекта, LML или SysML v2, задаётся при его создании. Чтобы работать с моделью LML в SysML v2 или с моделью SysML v2 на страницах LML, создайте преобразованную копию:

  • Создать копию SysML v2… в проекте LML записывает его модель как текст SysML v2 в новый проект SysML v2.
  • Создать копию LML… в проекте SysML v2 превращает его модель в сущности и связи LML в новом проекте LML.

Исходный проект никогда не меняется. Перед созданием копии отчёт перечисляет, что преобразуется (с количеством), и что нет (с причиной). Тот же отчёт сохраняется в новом проекте.

Понятия

Копия, а не смена типа

Преобразование всегда создаёт новый проект. Можно продолжать работать в оригинале и преобразовать его снова позже; каждое преобразование создаёт ещё один новый проект. Копия никак не связана с оригиналом.

Как соотносятся два языка

LML и SysML v2 описывают многие одинаковые вещи по-разному. Преобразование использует это соответствие в обоих направлениях:

LMLSysML v2
AssetОпределение части с использованием части везде, где оно используется
Декомпозиция Asset (decomposed by)Использование части в определении родителя
PortИспользование порта
Characteristic у AssetИспользование атрибута
ConduitИспользование соединения или использование интерфейса, если оба конца — порты
Input/OutputОпределение предмета с параметрами-предметами in и out и потоками
Requirement (Number, Name, Description)Использование требования (краткое имя, имя, doc)
satisfied bysatisfy
Test CaseИспользование верификации с целью verify
Test SuiteПакет случаев верификации
Action со своим потокомИспользование действия с последовательностями
Блоки SYNC и параллельные блокиРазветвление и соединение
ORРешение и слияние
LOOPДействие цикла
performed byperform
Характеристики состояния и переходыОпределение состояния с переходами, которое проявляет часть
Equation и её переменныеОпределение ограничения с его параметрами

Данные Holarch переносятся вместе с моделью

Некоторым данным нет места ни в одном из языков. Это данные Holarch, и они копируются вместе со своими связями:

  • Риски, решения, задачи, затраты, расписания, проблемы, документы и доски копируются и остаются связанными с преобразованными элементами.
  • Статус требований и методы верификации остаются у каждого требования; результаты тестов остаются у каждого тестового случая. Пользовательские состояния рабочих процессов классов тоже сохраняются.
  • Изменения схемы переносятся в обоих направлениях, включая рабочие процессы классов с их состояниями, выведенными состояниями, переходами и утверждающими.
  • Комментарии обсуждений следуют за своим элементом.
  • Вероятности ветвей решений остаются со своими ветвями для Симулятора.
  • Копия LML, созданная из копии SysML v2, получает обратно атрибуты и метки LML, которые сохранило первое преобразование.

Что не преобразуется

  • Макеты диаграмм. Представления и диаграммы в копии рисуются заново.
  • История, базовые линии и запросы на изменение. Копия начинается без них.
  • Элементы, которым нет места в одном из языков, например Measure и Resource в LML или перечисления, вычисления и случаи анализа в SysML v2.

Отчёт называет каждый такой элемент и указывает причину. См. Справочник по отчёту.

Как использовать

Когда и зачем

Преобразуйте, когда язык проекта больше не подходит для работы:

  • LML в SysML v2: ваша команда или заказчик теперь работает в SysML v2, или модель нужно передавать в инструменты SysML v2. Преобразуйте, затем экспортируйте .sysml или JSON (см. Обмен моделями SysML v2).
  • SysML v2 в LML: вам нужна страница или диаграмма LML, которой нет в проектах SysML v2, или вы хотите получить модель в форме жизненного цикла Holarch для рецензирования.

Преобразуйте, когда модель стабилизировалась, и прочитайте отчёт, прежде чем полагаться на копию.

Создание преобразованной копии

  1. На странице Управление проектами нажмите ⋯ в строке проекта.
  2. Выберите Создать копию SysML v2… (для проекта LML) или Создать копию LML… (для проекта SysML v2).

    Holarch проверяет преобразование; в большом проекте внизу окна появляется индикатор хода выполнения с надписью “Проверка преобразования…”. Затем открывается диалог с отчётом.

  3. Прочитайте отчёт:
    • Преобразовано перечисляет каждый вид элементов, их количество и то, чем они становятся, например “Требования 24 использования требований”.
    • Не преобразовано перечисляет каждый вид элементов, который не преобразуется, их количество и причину.
  4. Нажмите Скачать отчёт (CSV), чтобы сохранить отчёт с одной строкой на элемент, если он нужен вне Holarch.
  5. Введите Имя нового проекта. По умолчанию это имя оригинала, за которым следует “(SysML v2)” или “(LML)”.
  6. Нажмите Создать копию.

    Уведомление сообщает “Создано: «<name>»”. Копия открывается на своей Главной странице.

  7. Откройте в копии документ Conversion report. Он перечисляет каждый элемент, который не преобразовался, по номеру и имени.

Проверка копии

  1. В копии SysML v2 откройте Модель → Редактор.

    Модель — один пакет верхнего уровня, названный по проекту. Он содержит пакеты Architecture, System, Items, Requirements, Verification, Behavior, Constraints и Views (только те, в которых есть содержимое).

  2. Ищите отметки проблем на полях. Если в преобразованном тексте есть проблемы, диалог сообщил об этом до создания копии: “В преобразованном тексте проблем: N. Копия показывает их в своём Редакторе.”
  3. Откройте представления в разделе Представления (Architecture Overview, System Connections), чтобы увидеть заново нарисованную структуру.
  4. В копии LML откройте базу данных и диаграммы, чтобы проверить Asset, Requirement и потоки действий.

Рабочий пример: демо Hybrid Car как копия LML

Сначала создайте демо-проект: на странице Управление проектами нажмите Файлы проектов ▾ → Новый демо-проект → Hybrid Car (SysML v2).

  1. На странице Управление проектами нажмите ⋯ у Hybrid Car (SysML v2 demo) и выберите Создать копию LML…. Копия будет называться “Hybrid Car (SysML v2 demo) (LML)”.
  2. Прочитайте отчёт.

    В разделе Преобразовано: использования частей становятся Asset, использования портов — Port, атрибуты — Characteristic, использования соединений и интерфейсов — Conduit, использования и определения требований — Requirement, использования верификации — Test Case, действия — Action, а состояния и переходы — своими аналогами в LML.

    В разделе Не преобразовано, среди прочего:

    • Специализации: в LML нет специализации; в части копируются характеристики их общих определений. SportCar :> Car — один из примеров.
    • Переопределения: переопределяющая характеристика заменяет унаследованную в каждой скопированной части. Батарея седана копируется со значением 48 кг.
    • Перечисления (DriveMode, FuelKind): значения атрибутов сохраняются как текст.
    • Вычисления (PowerToWeight, ElectricRange) и Случаи анализа (PowerToWeightAnalysis).
    • Связывающие соединители (bind output = transmission.output;): в LML нет связывания между характеристиками.
    • Значения атрибутов: сохраняются как текст в Value каждой Characteristic; единицы и выражения не вычисляются.
    • Представления: диаграммы в копии LML рисуются заново.
  3. Нажмите Создать копию.

    Открывается копия LML. fleet.sedan и его части — это Asset; требование Sedan Mass (VR-1.1) — Requirement, которому удовлетворяет Asset седана. Риски, решения и задачи демо-проекта тоже копируются и связываются с преобразованными элементами.

Чтобы попробовать обратное направление, создайте демо-проект CubeSat EO-1 (проект LML) и выберите для него Создать копию SysML v2….

Советы и рекомендации

  • Приведите проект LML в порядок перед преобразованием: подключите каждый Conduit ровно к двум Asset или Port, привяжите каждую Characteristic к Asset или Equation и удалите пустые Test Suite. Иначе они будут указаны как непреобразованные.
  • В LML записывайте метки ветвей OR как логические выражения над значениями модели (например, speed > 3), если хотите, чтобы они стали сторожевыми условиями. Остальные метки становятся комментариями doc у последовательностей.
  • В SysML v2 задайте акторам тип — определение части, а параметрам-предметам — определение предмета. Нетипизированные не преобразуются.
  • Сохраняйте оригинал. После крупных изменений преобразуйте его заново, а не редактируйте оба проекта параллельно.

Типичные ошибки

  • Ожидание, что оригинал изменится. Он не меняется. Копия — отдельный проект.
  • Ожидание, что диаграммы сохранят макет. Макеты не преобразуются; заново расположите новые представления или диаграммы.
  • В копии LML не хватает частей. У определения части, которое не использует ни одна часть, нет Asset в LML, потому что в LML есть только экземпляры. Используйте определение в части, затем преобразуйте снова.
  • В отчёте есть элемент “does not resolve”. Имя в тексте SysML v2 ни на что не указывает. Исправьте имя в Редакторе, затем преобразуйте снова.

Справочник по отчёту

LML в SysML v2

К преобразуемым элементам относятся Asset (определения частей с их использованиями), Characteristic (атрибуты), Port, Conduit (соединения или интерфейсы), Input/Output (определения предметов), Requirement, Action и варианты использования, потоки предметов между действиями, State, Transition, Equation (определения ограничений), Performs, Test Suite, Test Case, Verifies, Satisfies, а также элементы Holarch (копируются со своими связями): артефакты, утверждения, задачи, риски, элементы расписания, затраты, проблемы, решения, опасности и виды отказов. Рабочие процессы классов (изменения схемы проекта) переносятся со своими пользовательскими состояниями, переходами и утверждающими, поэтому требования и тестовые случаи сохраняют свои пользовательские значения Status. Копия сохраняет переключатели проекта «Формальная программа» и «Безопасность и надёжность».

Не преобразованоПричина
Asset в цикле декомпозицииAsset, который содержит сам себя, не может занять место в дереве частей. Его определение части преобразуется; как часть оно не используется.
Conduit, у которых не ровно два концаСоединение SysML связывает два конца. Подключите Conduit к двум Asset или Port, затем преобразуйте снова.
Предметы, которые передаёт ConduitСоединения в этом преобразовании не несут предметов. Предметы преобразуются как определения предметов и потоки между действиями.
Conduit, декомпозированные на другие ConduitСоединения SysML здесь не вкладываются; каждый Conduit становится отдельным соединением.
Счётчики и сценарии цикловЦикл SysML здесь повторяется до выполнения условия; счётчик сохраняется как данные Holarch и восстанавливается командой «Создать копию LML».
Метки и вероятности ветвей решенийЕсли каждая метка решения — логическое выражение над значениями модели, метки становятся его сторожевыми условиями; иначе они становятся комментариями doc у последовательностей. Вероятности сохраняются как данные Holarch для Симулятора, и то и другое восстанавливается командой «Создать копию LML».
Элементы OR, SYNC и LOOPКонструкции преобразуются в узлы решения/слияния, разветвления/соединения и цикла; элементы, которые их называли, не сохраняются.
Действия входа, выполнения и выхода у состоянийЭти действия преобразуются как действия; тела состояний SysML этим преобразованием не заполняются.
Переходы не между двумя состояниями одной машиныПереход SysML связывает два состояния одного определения состояний.
Сторожевые условия и триггеры переходовВ LML они записываются свободным текстом; они сохраняются как данные Holarch, а не как выражения SysML, и восстанавливаются командой «Создать копию LML».
Состояния, не заданные AssetСостоянию нужен Asset, поведение которого оно описывает.
Выражения EquationВыражения используют имена, которые не являются характеристиками SysML; каждое сохраняется как комментарий в своём определении ограничения.
Test Suite без тестовых случаевНабор становится пакетом своих случаев верификации; пустому набору нечего содержать.
Тестовые случаи, верифицирующие что-то, кроме требованияСлучай верификации SysML верифицирует только требования.
Циклы тестированияПрогоны тестов, записанные на наборе, не являются частью модели; сохраняется последний результат каждого случая.
Требования, которым удовлетворяют элементы других видовНапример, в SysML требование не удовлетворяет другому требованию; используйте вывод (derivation) в тексте.
Другие связиВ этом преобразовании для них нет связи SysML; отчёт называет каждую.
MeasureУ мер эффективности в этом преобразовании нет элемента SysML.
ResourceКоличества ресурсов (consumes, produces) относятся к симулятору LML и не имеют здесь элемента SysML.
Characteristic, не привязанные к Asset или EquationАтрибуту нужен владелец: задайте его через Asset или сделайте его переменной Equation.
Элементы других классовУ этого класса нет ни элемента SysML, ни места Holarch в проекте SysML v2.
Характеристики и конфигурацииПока нет: характеристики и конфигурации линейки продуктов не становятся точками вариации, вариантами и конфигурациями SysML v2. Отчёт перечисляет их как элементы Feature и элементы Configuration; смоделируйте варианты заново в копии (см. Варианты и конфигурации SysML v2).
Базовые линииБазовые линии проекта LML не применяются к новой модели; копия начинается без базовых линий.
ИсторияИстория изменений в копии начинается заново.
Запросы на изменениеЗапросы на изменение LML предлагают изменения элементов LML, которых в копии нет.
Макеты диаграммДиаграммы рисуются заново как представления SysML v2; положения не переносятся.
Преобразованные элементы в структуре документовДокументы копируются; требования и другие элементы модели в их структуре теперь являются элементами SysML и появляются в модели, а не в структуре документа.

SysML v2 в LML

Каждое использование части становится Asset, в который копируются части, порты и атрибуты его определения (и определений, которые оно специализирует). Переопределения заменяют то, что переопределяют. Соединения и интерфейсы становятся Conduit между этими Asset. Требования, случаи верификации, satisfy, verify, perform, параметры-предметы, состояния и переходы отображаются обратно, как в таблице выше. Последовательности становятся потоками действий; сторожевые условия решения (или комментарии doc его последовательностей) становятся метками ветвей OR вместе с их вероятностями. Изменения схемы проекта переносятся, включая рабочие процессы классов с их пользовательскими состояниями, переходами и утверждающими, поэтому требования и тестовые случаи сохраняют свои пользовательские значения Status.

Не преобразованоПричина
Соединения с неразрешёнными концамиИсправьте имена концов в тексте, затем преобразуйте снова.
Соединения внутри определений, которые не использует ни одна частьКаждое соединение становится Conduit между частями каждой части, в которой оно есть; это определение ничем не используется.
Связывающие соединителиВ LML нет связывания (равенства) между характеристиками.
Неразрешённые связи verifyИсправьте имя требования в цели верификации, затем преобразуйте снова.
Параметры-предметы без определения предметаЧтобы преобразовать параметр, задайте ему тип item def.
Акторы без определения части в моделиЧтобы преобразовать актора, задайте ему тип part def.
Использования perform, которые не разрешаются в действие и частьВыполняйте действие (perform) из определения части или использования части, затем преобразуйте снова.
Неразрешённые связи satisfyИсправьте имена в утверждении satisfy, затем преобразуйте снова.
Последовательности, не образующие структурированный потокПотоки действий LML — это последовательности с параллельными блоками, блоками решения и цикла; другие графы последовательностей линеаризуются.
Определения состояний, которые не проявляет ни одна частьСостояния преобразуются без Asset, поведение которого они описывают.
Переходы, которые не разрешаются в два состоянияИсправьте имена состояний, затем преобразуйте снова.
Триггеры переходов (accept)Переходы LML сохраняют триггер только как свободный текст; принимаемый сигнал не связывается.
Определения портов, интерфейсов и соединенийОни преобразуются в Port и Conduit там, где их используют части; в LML нет типов портов, интерфейсов и соединений.
Определения атрибутов (типы значений)У характеристик LML нет типов.
Перечисления и значения перечисленийВ LML нет перечислений; значения атрибутов сохраняются как текст.
Вычисления, случаи анализа, интересыВ LML нет вычислений, случаев анализа и интересов заинтересованных сторон.
Представления и точки зренияДиаграммы в копии LML рисуются заново.
Действия присваивания, if, send и acceptУ действий LML нет операторов.
ЗависимостиВ LML нет общей зависимости.
Распределения (allocations)Для действий, выполняемых частями, используйте perform в тексте.
МетаданныеВ LML нет метаданных.
Вхождения (occurrences)В LML нет вхождений.
Включённые варианты использованияОтношения включения между вариантами использования не преобразуются.
ПсевдонимыУ каждой сущности LML одно имя.
Ссылочные использования (параметры вычислений и случаев)В LML нет параметров, кроме переменных Equation.
СпециализацииВ LML нет специализации; в части копируются характеристики их общих определений.
ПереопределенияПереопределяющая характеристика заменяет унаследованную в каждой скопированной части.
Подмножества (subsettings)В LML нет подмножеств.
ИмпортыВ LML нет пространств имён; каждая сущность видна во всём проекте.
Определения в отличие от использованийВ LML есть только экземпляры: определение части становится Asset тех частей, которые его используют, а его текст попадает в их описания.
Кратности, кроме кратностей частейМесто в LML есть только у кратностей частей (Multiplicity у decomposed by).
Значения атрибутовЗначения сохраняются как текст в Value каждой характеристики; единицы и выражения не вычисляются.
Базовые линииБазовые линии проекта SysML v2 не применяются к копии LML; она начинается без базовых линий.
ИсторияИстория изменений в копии начинается заново.
Запросы на изменениеЗапросы на изменение SysML предлагают изменения текста, которые не применяются к сущностям LML.

CSV отчёта

Скачать отчёт (CSV) записывает одну строку на каждый вид преобразованных элементов и одну строку на каждый непреобразованный элемент. Столбцы: Результат (Преобразовано или Не преобразовано), Что, Количество, Чем становится или причина, Номер и Имя.

Сообщения

СообщениеЗначение и исправление
Проверка преобразования… (индикатор хода выполнения)Отчёт готовится.
Это уже проект SysML v2. Выберите вместо этого «Создать копию LML…».Выбрано неверное направление.
Это уже проект LML. Выберите вместо этого «Создать копию SysML v2…».Выбрано неверное направление.
В преобразованном тексте проблем: N. Копия показывает их в своём Редакторе.Копию можно создать; исправьте проблемы в её Редакторе.
Преобразованный текст не разбирается (…). Проект не скопирован; сообщите об этом, приложив файл проекта.Преобразование не удалось. Обратитесь в поддержку, приложив файл проекта.
Проверка SysML не запустилась. Перезагрузите страницу и повторите попытку.Перезагрузите страницу и повторите попытку.
Не удалось прочитать проект. Перезагрузите страницу и повторите попытку.Перезагрузите страницу и повторите попытку.
Копия не создана: … Перезагрузите страницу и повторите попытку.Перезагрузите страницу и повторите попытку.
Создано: «<name>»Копия создана и открыта.

Ограничения

  • Макеты диаграмм, история, базовые линии и запросы на изменение не преобразуются.
  • Пока нет: преобразование линейки продуктов LML (характеристик и конфигураций) в варианты SysML v2.
  • Документ отчёта перечисляет до 500 элементов каждого вида.

SysML® и OMG® — зарегистрированные товарные знаки Object Management Group, Inc. в США и других странах.