Holarch

SysML v1 в SysML v2

Перенесите модель SysML v1 в SysML v2 без перерисовки.

Перетащите модель SysML v1, сохранённую как XMI (.xmi, .xml, .uml) или как архив проекта .mdzip, в проект SysML v2. Holarch преобразует её в текст SysML v2, проверяет текст и до импорта сообщает о каждом элементе, был ли он преобразован, приближён или пропущен, с указанием причины.

Конвертер входит в каждый тариф, включая Free. Новые учётные записи при первом входе получают 30-дневный пробный период Individual: 10 000 элементов на проект, без карты, по окончании возврат на Free. Уже есть учётная запись? Начать пробный период.

Доказательство: модель CubeSat EO-1

РезультатЭлементы
Преобразовано1,007
Приближено32
Пропущено3
Прочитано элементов1,042
Проблемы в тексте SysML v20

Преобразованный текст проходит проверку без ошибок и предупреждений, а одна и та же модель каждый раз преобразуется в один и тот же текст. Что было приближено и пропущено

Импорт модели SysML v1

Импортируйте файл XMI или проект .mdzip модели SysML v1 в проект SysML v2. До создания чего-либо отчёт о преобразовании перечисляет каждый элемент как преобразованный, приближённый или пропущенный, с указанием причины, и сохраняется как файл CSV. Пример — модель CubeSat EO-1: 1042 элемента, импортированы без проблем.

Import a SysML v1 Model на странице «Видео»

Что даёт конвертер

Модель SysML v2, с которой можно работать, и понятный список того, что нужно проверить.

Без перерисовки

Блоки становятся part def, порты, соединители и потоки предметов переносятся, требования сохраняют свои идентификаторы и текст, а связи satisfy, verify и allocate остаются прослеженными.

Отчёт по каждому элементу

Каждый элемент модели v1 указан со своим видом в v1, результатом, полученным именем в SysML v2 и, для всего приближённого или пропущенного, причиной, изложенной словами. Фильтруйте отчёт на экране или скачайте его в формате CSV.

Проверено до импорта

Преобразованный текст проверяет тот же движок, который проверяет Редактор SysML v2 во время ввода. Сначала вы видите результат, текст и отчёт; импорт — один шаг отмены.

Повторный импорт по мере изменения модели v1

Элементы получают идентификаторы из идентификаторов XMI модели v1. Импортируйте более новый экспорт в тот же проект, и элементы обновятся на месте, даже если их переименовали или переместили, вместе с раскладками диаграмм, комментариями, связями и историей.

Модель, с которой можно работать

Редактор, представления, требования, верификация и другие страницы проекта SysML v2 читают преобразованную модель так же, как любую другую.

Ваша модель v1 остаётся как есть

Holarch читает её экспорт и никогда не записывает обратно, поэтому модель v1 остаётся эталоном, пока команда рецензирует версию SysML v2.

Как это работает

  1. Перетащите файл. В проекте SysML v2 выберите Модель → Импорт и экспорт, затем В этот проект или В новый проект SysML v2 и перетащите файл .mdzip, .xmi, .uml или .xml. Карточка хода выполнения показывает чтение, преобразование и проверку.
  2. Изучите отчёт. Преобразование из SysML v1 показывает количества, сообщает, проходит ли текст проверку без проблем, и перечисляет приближённые и пропущенные элементы с причиной для каждого. Показать текст SysML v2 открывает результат; скачайте отчёт или файл .sysml, чтобы сохранить их.
  3. Импортируйте. Снимите отметки с ненужных пакетов и выполните импорт. Одно действие Отменить снова удаляет весь импорт.

Пошагово, с настройками экспорта каждого инструмента: Импорт моделей SysML v1 в Docs и руководство по миграции для планирования перехода целой программы.

Преобразованный блок

part def Rover {
  @SysMLv1Library::BlockData { isEncapsulated = true; }
  part battery : Battery;
  part computer : Computer;
  attribute 'power budget' : Types::Power = 120 [SI::W];
  connection 'power bus' connect battery.'out' to computer.'in';
  satisfy Requirements::'Power Margin' by battery;
  flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}

Результат конвертера для инкапсулированного блока с двумя частями, свойством-значением в ваттах, соединителем между прокси-портами с потоком предметов и связью satisfy. Руководство по миграции показывает всю небольшую модель до и после.

Что он читает

  • SysML v1 как XMI 2.x: UML 2.5 с профилем SysML 1.x.
  • .xmi: файл XMI.
  • .xml: XMI, сохранённый с расширением .xml.
  • .uml: файл модели XMI.
  • .mdzip: сжатый архив проекта, содержащий модель в виде XMI; Holarch читает XMI внутри.
  • Другие форматы проектов: инструмент, хранящий модели в собственном формате проекта, сначала экспортирует модель в XMI.

Один файл на импорт, до 64 MB, 250 000 элементов и 512 уровней вложенности.

Что получается на выходе

  • Текст SysML v2 в открытом проекте или в новом проекте SysML v2, импортированный одним шагом отмены.
  • Проверка текста, показанная до импорта.
  • Отчёт о преобразовании по каждому элементу, с фильтрацией на экране и возможностью скачать в формате CSV.
  • Файл .sysml для скачивания — для рецензирования или для другого инструмента SysML v2.

Преобразование основано на преобразовании SysML v1 в SysML v2 из спецификации OMG SysML 2.0.

Преобразовано, приближено или пропущено

Каждый элемент модели v1 получает один из трёх результатов, поэтому вы точно знаете, куда смотреть.

Преобразовано

У элемента есть прямой аналог в SysML v2. Блок становится part def, интерфейсный блок — port def, требование сохраняет свой идентификатор и текст.

Приближено

Элемент сохраняется в изменённой форме. Полный порт, типизированный интерфейсным блоком, становится портом; переход через узел выбора становится одним переходом на каждый путь; единица измерения, не входящая в отображаемые единицы SI, становится вещественным числом с единицей в документации.

Пропущено

У SysML v2 нет аналога, или элемент указывает на то, чего нет в файле. Примеры — конечные узлы потока, разделы деятельности, расширения вариантов использования и связи с безымянными элементами.

Свойства SysML v1 без ключевого слова SysML v2, например инкапсулированный блок, полный порт или связь refine, сохраняются как метаданные из пакета SysMLv1Library, который Holarch загружает в каждом проекте SysML v2. Ваши собственные стереотипы становятся определениями метаданных с их помеченными значениями, а непрозрачные поведения, охранные условия и ограничения сохраняют свои тела как текстовые представления, например language "OCL" /* … */.

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

Основные соответствия. В Docs перечислены все.

SysML v1SysML v2
Пакетpackage, с вложенностью как в v1
Блок, акторpart def
Тип значения, перечислениеattribute def, enum def; тип значения с известной единицей SI специализирует величину ISQ
Свойства-части, свойства-ссылки и свойства-значенияpart, ref part, attribute, с кратностями и значениями по умолчанию
Интерфейсный блок, прокси-порт, свойство потокаport def, port, направленный item или attribute
Соединитель, связывающий соединитель, поток предметовconnect, bind, flow
Деятельность, действия, потоки управления и объектовaction def, действия, последования с охранными условиями, потоки между параметрами
Машина состояний, состояния, переходыstate def, состояния, переходы с accept, охранными условиями и эффектами
Требование, satisfy, verify, deriverequirement с идентификатором и текстом, satisfy, verify, соединения вывода
Allocate, refine, traceallocate; dependency с метаданными SysMLv1Library
Вариант использования, взаимодействие, блок ограниченийuse case def, occurrence def с сообщениями, constraint def
Стереотипы и помеченные значенияmetadata def на каждый стереотип, применённый с его тегами

Разобранный пример: модель CubeSat EO-1

Демо-проект CubeSat EO-1, экспортированный как SysML 1.6 XMI и импортированный в новый проект SysML v2: прочитано 1042 элемента, 1007 преобразованы, 32 приближены, 3 пропущены. Текст SysML v2 проходит проверку без ошибок и предупреждений, а новый проект открывается со структурой, функциями, требованиями и прослеживаемостью спутника. Все приближённые и пропущенные элементы по причинам:

ЭлементыРезультатПричина
10 соединителейПриближеноКонец соединителя находится внутри части; путь к нему выведен из типов частей.
8 переходовПриближено4 триггера изменения и времени, например when Undervoltage, сохранены как документация; 4 события без сигнала, например Contact Start, получили определение предмета с этим именем.
6 потоков предметовПриближеноИмя используется дважды в одном месте; поток переименован с суффиксом.
5 типов значенийПриближеноЕдиница измерения (%, GB, Mbps, mNms, W/m^2) не входит в единицы SI, которые отображает Holarch; тип значения — вещественное число с единицей в документации.
2 потока управленияПриближеноВетвь без охранного условия рядом с ветвями с охранными условиями; она получила охранное условие true.
1 конечное состояниеПриближеноКонечное состояние стало обычным состоянием.
1 расширение варианта использованияПропущеноВ SysML v2 нет расширений вариантов использования.
2 связи traceПропущеноОни указывают на элементы без имени, на которые текст SysML v2 не может ссылаться.

Файл EO-1 — собственный экспорт SysML 1.6 из Holarch, поэтому он использует ту часть SysML v1, которую записывает Holarch. Модель из другого инструмента обычно использует больше возможностей языка, и её цифры будут другими: значение имеет отчёт по вашей собственной модели, и вы видите его до импорта. Тестовые модели Holarch, написанные в формах XMI нескольких инструментов SysML v1, также преобразуются в текст, проходящий проверку без проблем, а одна и та же модель каждый раз преобразуется в один и тот же текст.

Вопросы

Что теряется при преобразовании?

Диаграммы и их раскладка не преобразуются: создайте в проекте SysML v2 представления для важных диаграмм. Элементы, у которых нет аналога в SysML v2, пропускаются, например расширения вариантов использования, конечные узлы потока и разделы деятельности, а также связи с безымянными элементами, потому что текст SysML v2 ссылается на элементы по имени (дайте имена элементам, к которым ведёте прослеживаемость, до экспорта). Приближённые элементы сохраняются в изменённой форме; именно в них смысл может отличаться от модели v1, поэтому проверьте их в первую очередь. Отчёт называет каждый из них с указанием причины.

Готова ли преобразованная модель к использованию?

Она проходит проверку без проблем, и каждая страница проекта SysML v2 с ней работает, но считайте её отправной точкой. Некоторые различия между языками требуют решения на уровне моделирования, а не только перевода. Что поддерживают проекты SysML v2 и известные пробелы: Охват языка SysML v2.

Насколько большую модель можно преобразовать?

Один файл размером не более 64 MB, не более 250 000 элементов с вложенностью не глубже 512 уровней и не более 8 MB преобразованного текста. Экспортируйте большую модель по одному пакету за раз. К преобразованной модели применяется предел элементов на проект вашего тарифа: 1000 на Free, 10 000 на Individual и 50 000 на Team. См. что считается элементом. Для модели более 10 000 элементов запросите оценку Team.

Можно ли продолжать работать в инструменте SysML v1?

Да. Holarch читает экспорт и никогда не изменяет модель v1. Когда модель v1 меняется, экспортируйте её снова и импортируйте новый файл в тот же проект: элементы получают идентификаторы из файла XMI, поэтому обновляются на месте, даже после переименования или перемещения. Элементы с одинаковым именем в одном месте переименовываются с суффиксом, например _2, и отчёт перечисляет каждое переименование.

Куда попадает мой файл?

Holarch читает и преобразует файл XMI или .mdzip в вашем браузере; сам файл не загружается на сервер. На app.holarch.app преобразованный текст SysML v2 отправляется в Holarch для подготовки предварительного просмотра и сохраняется в вашем проекте только при импорте. Облачный сервис не принимает CUI и материалы, подпадающие под экспортный контроль; для них Holarch работает в вашей собственной среде (Enterprise). Подробнее — в разделе Безопасность.

А как быть с требованиями, которые хранятся в системе управления требованиями?

Они переносятся в формате ReqIF (.reqif, .reqifz) — стандартном формате обмена требованиями. Holarch импортирует и экспортирует ReqIF в проектах LML и SysML v2. В проекте SysML v2 файл ReqIF становится требованиями, определениями требований и пакетами с отчётом о том, что было преобразовано, а требования экспортируются обратно со своими исходными идентификаторами. При нашем круговом обмене демонстрационного проекта CubeSat EO-1 из Holarch в ReqIF и обратно все 407 элементов и 979 значений атрибутов вернулись без изменений. ReqIF в проектах LML · ReqIF в проектах SysML v2

Сколько стоит конвертер?

Ничего сверх тарифа: он входит в каждый тариф, включая Free. Тарифы различаются числом элементов на проект и тем, что в них входит помимо моделирования; см. Цены.

Встраиваете миграцию в собственный инструмент?

Конвертер — часть Holarch Language Engine, движка, на котором работают проекты SysML v2 в Holarch, и лицензируется поставщикам инструментов и интеграторам как дополнение миграции. Это тот же конвертер, что работает в Holarch.

  • Ваш продукт читает файл XMI, движок преобразует: отправьте модель v1 в виде JSON в документированной нейтральной форме и получите обратно в виде JSON текст SysML v2, его проверку движком и отчёт по каждому элементу с постоянным кодом причины и полученным именем в SysML v2.
  • Работает там же, где ваш продукт: в браузере как WebAssembly в Web Worker или на вашем сервере через Node.js или расширение Python с дополнением серверного использования.
  • Воспроизводимо и ограниченно: одна и та же модель каждый раз преобразуется в один и тот же текст; модели до 250 000 элементов, а для модели большего размера возвращается ответ с ошибкой, а не зависание.
  • Включается вашим лицензионным токеном, без пересборки и изменения кода. Бесплатный 60-дневный ознакомительный период проходит на вашем собственном компьютере, с документацией и примерами.

Запрос и ответ на него

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

Запрос v1_convert в справочнике API движка. Движок также предлагает симуляцию и серверное использование в качестве дополнений.

Посмотрите на свою модель в SysML v2.

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

Новые учётные записи при первом входе получают 30-дневный пробный период Individual: 10 000 элементов на проект, без карты, по окончании возврат на Free. Уже есть учётная запись? Начните пробный период в разделе Настройки учётной записи → Тариф и оплата.