SysML v2
Імпорт моделей SysML v1
Перетворіть модель SysML 1.x з Cameo, MagicDraw, Enterprise Architect, Rhapsody або Papyrus на текст SysML v2, перегляньте, що змінило форму, та імпортуйте її в проєкт SysML v2.
На цій сторінці
Огляд
Ви можете перенести модель SysML 1.x у проєкт SysML v2. Holarch читає файл XMI моделі, перетворює його на текст SysML v2, перевіряє текст і показує звіт про перетворення, перш ніж щось зміниться.
- Вхід: модель SysML 1.x як XMI (
.xmi,.uml,.xml) або проєкт Cameo чи MagicDraw (.mdzip). - Вихід: текст SysML v2 у вашому проєкті (одне натискання “Відмінити” повертає все назад) або новий проєкт SysML v2.
- Звіт: кожен елемент v1 з його результатом: Перетворено, Наближено або Пропущено, і причина.
Перетворення відповідає трансформації SysML v1 у SysML v2 зі специфікації OMG SysML 2.0 там, де модель, передана як XMI, містить для цього достатньо подробиць.
Поняття
Перетворено, наближено й пропущено
Кожен елемент моделі v1 отримує один результат:
- Перетворено: елемент має прямий відповідник у SysML v2, як-от блок, що стає
part def. - Наближено: елемент збережено в зміненій формі. Наприклад, повний порт, типізований блоком інтерфейсу, стає портом, а перехід через псевдостан вибору стає окремим переходом для кожного шляху.
- Пропущено: SysML v2 не має відповідника, або елемент вказує на щось, чого немає у файлі. Приклади — кінцеві вузли потоку, розділи діяльності, розширення варіантів використання та специфікації екземплярів.
Звіт словами пояснює причину для кожного наближеного й пропущеного елемента.
Пакет SysMLv1Library
Деякі властивості SysML v1 не мають ключового слова SysML v2, як-от isEncapsulated блока чи відношення refine. Перетворювач зберігає їх як метадані з пакета SysMLv1Library, наприклад @SysMLv1Library::RefineData { isRefine = true; }. Пакет входить до бібліотеки Holarch, тож ці імена розв’язуються в кожному проєкті SysML v2.
Непрозорі тіла стають текстовими представленнями
Непрозорі поведінки, непрозорі дії, умови й специфікації обмежень містять текст мовою на кшталт OCL чи англійської. Перетворювач зберігає кожне тіло як текстове представлення: language "OCL" /* … */. Тіла мовою SysML або KerML перевіряються, як і решта тексту. Див. Текстові представлення.
Як користуватися
Коли й навіщо
Використовуйте імпорт, коли команда переносить наявну модель SysML 1.x на SysML v2 або хоче повторно використати її частини. Перетворений текст — це відправна точка: звіт показує, що переглянути вручну.
Імпорт моделі SysML v1 у проєкт
- Відкрийте проєкт SysML v2 і натисніть Модель → Імпорт і експорт.
- У розділі Імпортувати виберіть У цей проєкт або У новий проєкт SysML v2.
- Перетягніть файл
.xmi,.uml,.xmlабо.mdzipна поле або клацніть поле, щоб його вибрати. Ви бачите картку поступу з етапами Читання файлу XMI…, Перетворення на SysML v2… і Перевірка результату…. - Прочитайте Перетворення з SysML v1 угорі попереднього перегляду. Там указано кількість перетворених, наближених і пропущених елементів і чи проходить текст SysML v2 перевірку без проблем.
- За допомогою Показати перелічіть наближені й пропущені елементи, лише одну з цих груп або всі елементи. Кожен рядок містить елемент, його вид у SysML v1, результат з ключовим словом SysML v2 і кваліфікованою назвою, а також Чому.
- Відкрийте Показати текст SysML v2, щоб прочитати результат перед імпортом.
- Зніміть позначку з непотрібних пакетів у таблиці нижче, потім натисніть Імпортувати N пакетів (або Створити проєкт). Модель імпортується, і одне натискання “Відмінити” повертає все назад. Відмінити знову вилучає її.
Імпорт новішої версії тієї самої моделі
Коли модель SysML v1 змінюється, експортуйте її знову й імпортуйте новий файл у той самий проєкт (У цей проєкт). Кожен перетворений елемент бере ідентифікатор з ідентифікатора елемента у файлі XMI (xmi:id), тож імпорт оновлює елементи на місці: елемент, перейменований або переміщений до іншого пакета в інструменті SysML v1, лишається тим самим елементом зі своїми розміщеннями діаграм, коментарями, зв’язками та історією. Звіт показує, скільки елементів беруть ідентифікатори з моделі SysML v1. Елементи без назви (з’єднувачі, послідовності) зіставляються за їхнім місцем у моделі.
Проєкт, імпортований з моделі SysML v1 до того, як Holarch почав виводити ідентифікатори з файлу XMI, зберігає свої ідентифікатори: новіший експорт оновлює його елементи за назвою, а нові в моделі SysML v1 елементи беруть ідентифікатори з неї.
Збереження звіту й тексту
- Натисніть Завантажити звіт, щоб отримати файл CSV з кожним елементом, його результатом, шляхом у SysML v2 і причиною.
- Натисніть Завантажити текст SysML v2, щоб отримати перетворений файл
.sysml.
Експорт моделі з вашого інструмента SysML v1
- Cameo Systems Modeler і MagicDraw: імпортуйте проєкт
.mdzipнапряму або скористайтеся File → Export To → Eclipse UML2 (v5.x) XMI File та імпортуйте файл.xmi. - Enterprise Architect: виберіть пакет, виберіть Publish → Export XML, виберіть XMI 2.1 і імпортуйте файл
.xml. Файли проєктів Enterprise Architect (.eap,.qea) не можна прочитати напряму. - IBM Rhapsody: експортуйте модель за допомогою XMI toolkit (XMI 2.x) і імпортуйте файл.
- Eclipse Papyrus: імпортуйте файл
.umlмоделі.
Приклад: модель CubeSat EO-1
Демопроєкт CubeSat EO-1 — це проєкт LML. Його експорт SysML v1 дає реалістичну тестову модель.
- Відкрийте демопроєкт CubeSat EO-1 і експортуйте його як UML/SysML XMI у форматі OMG XMI 2.5.1 (див. Експорт моделі UML/SysML (XMI)).
- Відкрийте проєкт SysML v2, натисніть Модель → Імпорт і експорт, виберіть У новий проєкт SysML v2 і перетягніть файл
.xmi. Звіт показує: 1,042 елементи, 1,007 перетворено, 32 наближено, 3 пропущено. Текст SysML v2 проходить перевірку без проблем. - Установіть для Показати значення Пропущено. Три рядки — це розширення варіанта використання, якого в SysML v2 немає, і два зв’язки трасування до елементів без назви, на які текст SysML v2 не може посилатися.
- Натисніть Створити проєкт. Новий проєкт SysML v2 відкривається в Редакторі зі структурою, функціями, вимогами й трасами супутника.
Поради та поширені помилки
- Імпортуйте один файл XMI за раз, без інших файлів. Імпортуйте один файл SysML v1 XMI за раз, без інших файлів.
- Давайте назви елементам, до яких трасуєте. Зв’язки з безіменними елементами пропускаються, бо текст SysML v2 посилається на елементи за назвою.
- Імпортуйте повторно, а не створюйте заново. Імпортуйте новіший експорт у той самий проєкт, а не в новий: елементи зберігають ідентифікатори лише в межах проєкту, де вони є.
- Спершу перевірте наближення. Це місця, де значення може відрізнятися від моделі v1, як-от порти, типізовані блоками, чи кінці з’єднувачів усередині частин.
- Елементи з однаковою назвою в одному місці перейменовуються із суфіксом на кшталт
_2. Звіт перелічує кожне перейменування. - Вимоги, що зберігаються в інструменті керування вимогами (DOORS, Polarion, Jama, codebeamer), надходять як ReqIF, а не XMI. Імпортуйте файл
.reqifна тій самій сторінці: він стає вимогами SysML v2 з таким самим звітом (Імпортувати й експортувати вимоги ReqIF).
Що перетворюється
| SysML v1 | SysML v2 |
|---|---|
| Модель, пакет | package |
| Блок, актор | part def |
| Тип значення, тип даних, перелік | attribute def, enum def (типи значень з відомою одиницею SI спеціалізують величину ISQ) |
| Сигнал | item def |
| Блок інтерфейсу | port def |
| Властивості частин, посилань і значень | part, ref part, attribute, з кратностями та значеннями за замовчуванням |
| Проксі-порт, властивість потоку | port, in/out item або attribute |
| Повний порт | part з @SysMLv1Library::PortData |
| З’єднувач, зв’язувальний з’єднувач, потік елементів | connect, bind, flow |
| Узагальнення | :> |
| Діяльність, дія виклику поведінки, піни | action def, action, параметри |
| Потоки керування й об’єктів, умови | послідовності з умовами if і else, потоки між параметрами |
| Початковий, кінцевий, рішення, злиття, розгалуження, з’єднання | start, done, decide, merge, fork, join |
| Автомат станів, стани, області | state def, state, паралельні стани |
| Переходи, тригери сигналу й часу | transition з accept, accept after, умовами й ефектами |
| Взаємодія | occurrence def з лініями життя та повідомленнями |
| Варіант використання, суб’єкт, include | use case def, subject, include |
| Вимога (ідентифікатор і текст) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify у меті верифікації, з’єднання derivation |
| Refine, trace | dependency з метаданими SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Блок обмежень, обмеження | constraint def, assert constraint |
| Стереотипи й теговані значення | metadata def для кожного стереотипу, застосований з його тегами |
| Коментар, документація | doc, comment |
Обмеження
- Один файл розміром не більше 64 MB.
- Не більше 250,000 елементів із вкладеністю не глибше 512 рівнів. Модель з глибшою вкладеністю або з циклом володіння не імпортується.
- У перетвореній моделі елементи з вкладеністю глибше 128 рівнів пропускаються з причиною nesting.
- Перетворений текст — не більше 8 MB.
- Діаграми та їхнє розміщення не перетворюються. Створіть подання в проєкті SysML v2.
Повідомлення
| Повідомлення | Що робити |
|---|---|
| Імпортуйте один файл SysML v1 XMI за раз, без інших файлів. | Імпортуйте файл XMI окремо. |
| <file> не містить елементів UML чи SysML. Експортуйте модель як XMI 2.x і імпортуйте знову. | Експортуйте модель знову як XMI 2.x. |
| У <file> не знайдено моделі UML. У Cameo або MagicDraw експортуйте модель як Eclipse UML2 XMI і імпортуйте файл .xmi. | Експортуйте проєкт як XMI. |
| Модель SysML v1 має понад 250,000 елементів. Експортуйте меншу частину моделі. | Експортуйте по одному пакету. |
| Перетворений текст SysML v2 був би більшим за 8 MB. Експортуйте меншу частину моделі. | Експортуйте по одному пакету. |
Пов’язані сторінки
- Обмін моделями SysML v2
- Імпортувати й експортувати вимоги ReqIF: вимоги з DOORS, Polarion та інших інструментів керування вимогами.
- Текстова нотація SysML v2
- Перетворення між LML і SysML v2
SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.