SysML v2
Преобразование между LML и SysML v2
Создание копии проекта LML в SysML v2 или копии проекта SysML v2 в LML с отчётом о том, что преобразуется, а что нет.
На этой странице
Обзор
Тип проекта, LML или SysML v2, задаётся при его создании. Чтобы работать с моделью LML в SysML v2 или с моделью SysML v2 на страницах LML, создайте преобразованную копию:
- Создать копию SysML v2… в проекте LML записывает его модель как текст SysML v2 в новый проект SysML v2.
- Создать копию LML… в проекте SysML v2 превращает его модель в сущности и связи LML в новом проекте LML.
Исходный проект никогда не меняется. Перед созданием копии отчёт перечисляет, что преобразуется (с количеством), и что нет (с причиной). Тот же отчёт сохраняется в новом проекте.
Понятия
Копия, а не смена типа
Преобразование всегда создаёт новый проект. Можно продолжать работать в оригинале и преобразовать его снова позже; каждое преобразование создаёт ещё один новый проект. Копия никак не связана с оригиналом.
Как соотносятся два языка
LML и SysML v2 описывают многие одинаковые вещи по-разному. Преобразование использует это соответствие в обоих направлениях:
| LML | SysML v2 |
|---|---|
| Asset | Определение части с использованием части везде, где оно используется |
| Декомпозиция Asset (decomposed by) | Использование части в определении родителя |
| Port | Использование порта |
| Characteristic у Asset | Использование атрибута |
| Conduit | Использование соединения или использование интерфейса, если оба конца — порты |
| Input/Output | Определение предмета с параметрами-предметами in и out и потоками |
| Requirement (Number, Name, Description) | Использование требования (краткое имя, имя, doc) |
| satisfied by | satisfy |
| Test Case | Использование верификации с целью verify |
| Test Suite | Пакет случаев верификации |
| Action со своим потоком | Использование действия с последовательностями |
| Блоки SYNC и параллельные блоки | Разветвление и соединение |
| OR | Решение и слияние |
| LOOP | Действие цикла |
| performed by | perform |
| Характеристики состояния и переходы | Определение состояния с переходами, которое проявляет часть |
| 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 для рецензирования.
Преобразуйте, когда модель стабилизировалась, и прочитайте отчёт, прежде чем полагаться на копию.
Создание преобразованной копии
- На странице Управление проектами нажмите ⋯ в строке проекта.
- Выберите Создать копию SysML v2… (для проекта LML) или Создать копию LML… (для проекта SysML v2).
Holarch проверяет преобразование; в большом проекте внизу окна появляется индикатор хода выполнения с надписью “Проверка преобразования…”. Затем открывается диалог с отчётом.
- Прочитайте отчёт:
- Преобразовано перечисляет каждый вид элементов, их количество и то, чем они становятся, например “Требования 24 использования требований”.
- Не преобразовано перечисляет каждый вид элементов, который не преобразуется, их количество и причину.
- Нажмите Скачать отчёт (CSV), чтобы сохранить отчёт с одной строкой на элемент, если он нужен вне Holarch.
- Введите Имя нового проекта. По умолчанию это имя оригинала, за которым следует “(SysML v2)” или “(LML)”.
- Нажмите Создать копию.
Уведомление сообщает “Создано: «<name>»”. Копия открывается на своей Главной странице.
- Откройте в копии документ Conversion report. Он перечисляет каждый элемент, который не преобразовался, по номеру и имени.
Проверка копии
- В копии SysML v2 откройте Модель → Редактор.
Модель — один пакет верхнего уровня, названный по проекту. Он содержит пакеты Architecture, System, Items, Requirements, Verification, Behavior, Constraints и Views (только те, в которых есть содержимое).
- Ищите отметки проблем на полях. Если в преобразованном тексте есть проблемы, диалог сообщил об этом до создания копии: “В преобразованном тексте проблем: N. Копия показывает их в своём Редакторе.”
- Откройте представления в разделе Представления (Architecture Overview, System Connections), чтобы увидеть заново нарисованную структуру.
- В копии LML откройте базу данных и диаграммы, чтобы проверить Asset, Requirement и потоки действий.
Рабочий пример: демо Hybrid Car как копия LML
Сначала создайте демо-проект: на странице Управление проектами нажмите Файлы проектов ▾ → Новый демо-проект → Hybrid Car (SysML v2).
- На странице Управление проектами нажмите ⋯ у Hybrid Car (SysML v2 demo) и выберите Создать копию LML…. Копия будет называться “Hybrid Car (SysML v2 demo) (LML)”.
- Прочитайте отчёт.
В разделе Преобразовано: использования частей становятся 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 рисуются заново.
- Специализации: в LML нет специализации; в части копируются характеристики их общих определений.
- Нажмите Создать копию.
Открывается копия 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 v2
- Обмен моделями SysML v2
- Функции Holarch в проектах SysML v2
- Текстовая нотация SysML v2
SysML® и OMG® — зарегистрированные товарные знаки Object Management Group, Inc. в США и других странах.