Holarch

SysML v2

Імпорт моделей SysML v1

Перетворіть модель SysML 1.x з Cameo, MagicDraw, Enterprise Architect, Rhapsody або Papyrus на текст SysML v2, перегляньте, що змінило форму, та імпортуйте її в проєкт SysML v2.

Як цим користуватися →

На цій сторінці
  1. Огляд
  2. Поняття
    1. Перетворено, наближено й пропущено
    2. Пакет SysMLv1Library
    3. Непрозорі тіла стають текстовими представленнями
  3. Як користуватися
    1. Коли й навіщо
    2. Імпорт моделі SysML v1 у проєкт
    3. Імпорт новішої версії тієї самої моделі
    4. Збереження звіту й тексту
    5. Експорт моделі з вашого інструмента SysML v1
  4. Приклад: модель CubeSat EO-1
  5. Поради та поширені помилки
  6. Що перетворюється
  7. Обмеження
  8. Повідомлення
  9. Пов’язані сторінки

Огляд

Ви можете перенести модель 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 у проєкт

  1. Відкрийте проєкт SysML v2 і натисніть Модель → Імпорт і експорт.
  2. У розділі Імпортувати виберіть У цей проєкт або У новий проєкт SysML v2.
  3. Перетягніть файл .xmi, .uml, .xml або .mdzip на поле або клацніть поле, щоб його вибрати. Ви бачите картку поступу з етапами Читання файлу XMI…, Перетворення на SysML v2… і Перевірка результату….
  4. Прочитайте Перетворення з SysML v1 угорі попереднього перегляду. Там указано кількість перетворених, наближених і пропущених елементів і чи проходить текст SysML v2 перевірку без проблем.
  5. За допомогою Показати перелічіть наближені й пропущені елементи, лише одну з цих груп або всі елементи. Кожен рядок містить елемент, його вид у SysML v1, результат з ключовим словом SysML v2 і кваліфікованою назвою, а також Чому.
  6. Відкрийте Показати текст SysML v2, щоб прочитати результат перед імпортом.
  7. Зніміть позначку з непотрібних пакетів у таблиці нижче, потім натисніть Імпортувати 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 дає реалістичну тестову модель.

  1. Відкрийте демопроєкт CubeSat EO-1 і експортуйте його як UML/SysML XMI у форматі OMG XMI 2.5.1 (див. Експорт моделі UML/SysML (XMI)).
  2. Відкрийте проєкт SysML v2, натисніть Модель → Імпорт і експорт, виберіть У новий проєкт SysML v2 і перетягніть файл .xmi. Звіт показує: 1,042 елементи, 1,007 перетворено, 32 наближено, 3 пропущено. Текст SysML v2 проходить перевірку без проблем.
  3. Установіть для Показати значення Пропущено. Три рядки — це розширення варіанта використання, якого в SysML v2 немає, і два зв’язки трасування до елементів без назви, на які текст SysML v2 не може посилатися.
  4. Натисніть Створити проєкт. Новий проєкт SysML v2 відкривається в Редакторі зі структурою, функціями, вимогами й трасами супутника.

Поради та поширені помилки

  • Імпортуйте один файл XMI за раз, без інших файлів. Імпортуйте один файл SysML v1 XMI за раз, без інших файлів.
  • Давайте назви елементам, до яких трасуєте. Зв’язки з безіменними елементами пропускаються, бо текст SysML v2 посилається на елементи за назвою.
  • Імпортуйте повторно, а не створюйте заново. Імпортуйте новіший експорт у той самий проєкт, а не в новий: елементи зберігають ідентифікатори лише в межах проєкту, де вони є.
  • Спершу перевірте наближення. Це місця, де значення може відрізнятися від моделі v1, як-от порти, типізовані блоками, чи кінці з’єднувачів усередині частин.
  • Елементи з однаковою назвою в одному місці перейменовуються із суфіксом на кшталт _2. Звіт перелічує кожне перейменування.
  • Вимоги, що зберігаються в інструменті керування вимогами (DOORS, Polarion, Jama, codebeamer), надходять як ReqIF, а не XMI. Імпортуйте файл .reqif на тій самій сторінці: він стає вимогами SysML v2 з таким самим звітом (Імпортувати й експортувати вимоги ReqIF).

Що перетворюється

SysML v1SysML 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 з лініями життя та повідомленнями
Варіант використання, суб’єкт, includeuse case def, subject, include
Вимога (ідентифікатор і текст)requirement <'id'> Name { doc /* text */ }
Satisfy, verify, derive requirementsatisfy, verify у меті верифікації, з’єднання derivation
Refine, tracedependency з метаданими SysMLv1Library
Allocate, dependencyallocate, 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® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.