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 v2 | 0 |
Преобразованный текст проходит проверку без ошибок и предупреждений, а одна и та же модель каждый раз преобразуется в один и тот же текст. Что было приближено и пропущено
Импорт модели SysML v1
Импортируйте файл XMI или проект .mdzip модели SysML v1 в проект SysML v2. До создания чего-либо отчёт о преобразовании перечисляет каждый элемент как преобразованный, приближённый или пропущенный, с указанием причины, и сохраняется как файл CSV. Пример — модель CubeSat EO-1: 1042 элемента, импортированы без проблем.
Что даёт конвертер
Модель SysML v2, с которой можно работать, и понятный список того, что нужно проверить.
Без перерисовки
Блоки становятся part def, порты, соединители и потоки предметов переносятся, требования сохраняют свои идентификаторы и текст, а связи satisfy, verify и allocate остаются прослеженными.
Отчёт по каждому элементу
Каждый элемент модели v1 указан со своим видом в v1, результатом, полученным именем в SysML v2 и, для всего приближённого или пропущенного, причиной, изложенной словами. Фильтруйте отчёт на экране или скачайте его в формате CSV.
Проверено до импорта
Преобразованный текст проверяет тот же движок, который проверяет Редактор SysML v2 во время ввода. Сначала вы видите результат, текст и отчёт; импорт — один шаг отмены.
Повторный импорт по мере изменения модели v1
Элементы получают идентификаторы из идентификаторов XMI модели v1. Импортируйте более новый экспорт в тот же проект, и элементы обновятся на месте, даже если их переименовали или переместили, вместе с раскладками диаграмм, комментариями, связями и историей.
Модель, с которой можно работать
Редактор, представления, требования, верификация и другие страницы проекта SysML v2 читают преобразованную модель так же, как любую другую.
Ваша модель v1 остаётся как есть
Holarch читает её экспорт и никогда не записывает обратно, поэтому модель v1 остаётся эталоном, пока команда рецензирует версию SysML v2.
Как это работает
- Перетащите файл. В проекте SysML v2 выберите Модель → Импорт и экспорт, затем В этот проект или В новый проект SysML v2 и перетащите файл
.mdzip,.xmi,.umlили.xml. Карточка хода выполнения показывает чтение, преобразование и проверку. - Изучите отчёт. Преобразование из SysML v1 показывает количества, сообщает, проходит ли текст проверку без проблем, и перечисляет приближённые и пропущенные элементы с причиной для каждого. Показать текст SysML v2 открывает результат; скачайте отчёт или файл
.sysml, чтобы сохранить их. - Импортируйте. Снимите отметки с ненужных пакетов и выполните импорт. Одно действие Отменить снова удаляет весь импорт.
Пошагово, с настройками экспорта каждого инструмента: Импорт моделей 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 v1 | SysML 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, derive | requirement с идентификатором и текстом, satisfy, verify, соединения вывода |
| Allocate, refine, trace | allocate; 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. Уже есть учётная запись? Начните пробный период в разделе Настройки учётной записи → Тариф и оплата.