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: 1 042 елементи, імпортовано без проблем.

Імпорт моделі SysML v1 на сторінці «Відео»

Що дає конвертер

Модель 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, умовами та ефектами
Requirement, 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, експортоване як XMI SysML 1.6 та імпортоване в новий проєкт SysML v2: прочитано 1 042 елементи, 1 007 перетворено, 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 — це власний експорт Holarch у SysML 1.6, тож він використовує ту частину 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 перетвореного тексту. Більшу модель експортуйте по одному пакету. На перетворену модель поширюється ліміт елементів на проєкт вашого тарифу: 1 000 на 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. Уже маєте обліковий запис? Почніть пробний період у розділі Налаштування облікового запису → Тариф і оплата.