Holarch

SysML v2

Перетворення між LML і SysML v2

Створіть копію проєкту LML у SysML v2 або копію проєкту SysML v2 в LML зі звітом про те, що перетворюється, а що ні.

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

На цій сторінці
  1. Огляд
  2. Поняття
    1. Копія, а не зміна типу
    2. Як відповідають одна одній дві мови
    3. Дані Holarch переносяться разом
    4. Що не перетворюється
  3. Як користуватися
    1. Коли й навіщо
    2. Створення перетвореної копії
    3. Перевірка копії
    4. Приклад: демопроєкт Hybrid Car як копія LML
    5. Поради та добрі практики
    6. Типові помилки
  4. Довідник звіту
    1. LML у SysML v2
    2. SysML v2 у LML
    3. CSV звіту
  5. Повідомлення
  6. Обмеження
  7. Пов’язані сторінки

Огляд

Тип проєкту, LML або SysML v2, фіксується під час його створення. Щоб працювати з моделлю LML у SysML v2 або з моделлю SysML v2 на сторінках LML, створіть перетворену копію:

  • Створити копію SysML v2… у проєкті LML записує його модель як текст SysML v2 у новий проєкт SysML v2.
  • Створити копію LML… у проєкті SysML v2 перетворює його модель на сутності та зв’язки LML у новому проєкті LML.

Початковий проєкт ніколи не змінюється. Перед створенням копії звіт перелічує, що перетворюється (з кількістю), а що ні (з причиною). Той самий звіт зберігається в новому проєкті.

Поняття

Копія, а не зміна типу

Перетворення завжди створює новий проєкт. Можна далі працювати в оригіналі й пізніше перетворити знову; кожне перетворення створює ще один новий проєкт. Копія ніяк не пов’язана з оригіналом.

Як відповідають одна одній дві мови

LML і SysML v2 описують багато тих самих речей по-різному. Перетворення використовує цю відповідність в обох напрямках:

LMLSysML v2
AssetВизначення частини з використанням частини скрізь, де воно використовується
Декомпозиція Asset (decomposed by)Використання частини у визначенні батьківського елемента
PortВикористання порту
Characteristic елемента AssetВикористання атрибута
ConduitВикористання з’єднання або використання інтерфейсу, коли обидва кінці є портами
Input/OutputВизначення предмета з параметрами-предметами in і out та потоками
Requirement (Number, Name, Description)Використання вимоги (коротке ім’я, назва, doc)
satisfied bysatisfy
Test CaseВикористання верифікації з метою verify
Test SuiteПакет випадків верифікації
Action з її потокомВикористання дії з послідовностями
Блоки SYNC і паралельні блокиРозгалуження й з’єднання
ORРішення й злиття
LOOPДія циклу
performed byperform
Характеристики станів і переходиВизначення стану з переходами, які проявляє частина
Equation та її змінніВизначення обмеження з його параметрами

Дані Holarch переносяться разом

Деякі дані не мають місця в жодній з мов. Це дані Holarch, і вони копіюються разом зі своїми зв’язками:

  • Ризики, рішення, завдання, витрати, розклади, проблеми, документи й дошки копіюються й залишаються пов’язаними з перетвореними елементами.
  • Статус вимог і методи верифікації залишаються з кожною вимогою; результати тестів — з кожним тестовим випадком. Власні стани робочих процесів класів також зберігаються.
  • Зміни схеми переносяться в обох напрямках, включно з робочими процесами класів з їхніми станами, виведеними станами, переходами та затверджувачами.
  • Коментарі обговорення йдуть за своїм елементом.
  • Імовірності гілок рішень залишаються з їхніми гілками для Симулятора.
  • Копія LML, створена з копії SysML v2, повертає атрибути й мітки LML, які зберегло перше перетворення.

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

  • Розміщення діаграм. Подання й діаграми в копії малюються заново.
  • Історія, базові лінії та запити на зміну. Копія починається без них.
  • Елементи, для яких одна з мов не має місця, як-от Measures і Resources у LML або переліки, обчислення й випадки аналізу в SysML v2.

Звіт називає кожен такий елемент і вказує причину. Див. Довідник звіту.

Як користуватися

Коли й навіщо

Перетворюйте, коли мова проєкту більше не відповідає роботі:

  • LML у SysML v2: ваша команда або замовник тепер працює в SysML v2, або модель треба передавати інструментам SysML v2. Перетворіть, потім експортуйте .sysml чи JSON (див. Обмін моделями SysML v2).
  • SysML v2 у LML: вам потрібна сторінка чи діаграма LML, якої немає в проєктах SysML v2, або ви хочете мати модель у формі життєвого циклу Holarch для рецензування.

Перетворюйте, коли модель стабільна, і прочитайте звіт, перш ніж покладатися на копію.

Створення перетвореної копії

  1. На сторінці Керування проєктами натисніть ⋯ у рядку проєкту.
  2. Виберіть Створити копію SysML v2… (для проєкту LML) або Створити копію LML… (для проєкту SysML v2).

    Holarch перевіряє перетворення; у великому проєкті смуга прогресу внизу вікна показує "Перевірка перетворення…". Потім відкривається діалог зі звітом.

  3. Прочитайте звіт:
    • Перетворено перелічує кожен вид елементів, їхню кількість і те, чим вони стають, наприклад "Вимоги 24 використання вимог".
    • Не перетворено перелічує кожен вид елементів, що не перетворюється, їхню кількість і причину.
  4. Натисніть Завантажити звіт (CSV), щоб зберегти звіт з одним рядком на елемент, якщо він потрібен поза Holarch.
  5. Введіть Назва нового проєкту. За замовчуванням це назва оригіналу, після якої йде "(SysML v2)" або "(LML)".
  6. Натисніть Створити копію.

    Сповіщення: "Створено "<name>"". Копія відкривається на своїй Головній сторінці.

  7. Відкрийте в копії документ Звіт про перетворення. Він перелічує кожен елемент, що не перетворився, за номером і назвою.

Перевірка копії

  1. У копії SysML v2 відкрийте Модель → Редактор.

    Модель — це один пакет верхнього рівня, названий за проєктом. Він містить пакети Architecture, System, Items, Requirements, Verification, Behavior, Constraints і Views (лише ті, що мають вміст).

  2. Шукайте позначки проблем на полі ліворуч від тексту. Якщо перетворений текст має проблеми, діалог повідомив про це ще до створення копії: "Перетворений текст має N проблем. Копія показує їх у своєму Редакторі."
  3. Відкрийте подання в Подання (Architecture Overview, System Connections), щоб побачити заново намальовану структуру.
  4. У копії LML відкрийте Базу даних і діаграми, щоб перевірити Assets, Requirements і потоки дій.

Приклад: демопроєкт Hybrid Car як копія LML

Спершу створіть демопроєкт: на сторінці Керування проєктами натисніть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2).

  1. На сторінці Керування проєктами натисніть ⋯ у рядку Hybrid Car (SysML v2 demo) і виберіть Створити копію LML…. Копія матиме назву "Hybrid Car (SysML v2 demo) (LML)".
  2. Прочитайте звіт.

    У розділі Перетворено: використання частин стають Assets, використання портів — Ports, атрибути — Characteristics, використання з’єднань та інтерфейсів — Conduits, використання й визначення вимог — Requirements, використання верифікації — Test Cases, дії — Actions, а стани й переходи — їхніми відповідниками в LML.

    У розділі Не перетворено, серед іншого:

    • Спеціалізації: LML не має спеціалізації; частини отримують копії ознак своїх загальних визначень. SportCar :> Car — одна з них.
    • Перевизначення: ознака, що перевизначає, замінює успадковану в кожній скопійованій частині. Батарею седана скопійовано з 48 kg.
    • Переліки (DriveMode, FuelKind): значення атрибутів зберігаються як текст.
    • Обчислення (PowerToWeight, ElectricRange) і Випадки аналізу (PowerToWeightAnalysis).
    • Зв’язувальні з’єднувачі (bind output = transmission.output;): LML не має зв’язування між ознаками.
    • Значення атрибутів: зберігаються як текст у Value кожної Characteristic; одиниці й вирази не обчислюються.
    • Подання: діаграми в копії LML малюються заново.
  3. Натисніть Створити копію.

    Відкривається копія LML. fleet.sedan і його частини є Assets; вимога Sedan Mass (VR-1.1) — це Requirement, яку задовольняє Asset седана. Ризики, рішення й завдання демопроєкту теж копіюються, пов’язані з перетвореними елементами.

Щоб спробувати інший напрямок, створіть демопроєкт CubeSat EO-1 (проєкт LML) і виберіть для нього Створити копію SysML v2….

Поради та добрі практики

  • Упорядкуйте проєкт LML перед перетворенням: з’єднайте кожен Conduit рівно з двома Assets або Ports, прикріпіть кожну Characteristic до Asset або Equation і вилучіть порожні Test Suites. Інакше їх буде зазначено як неперетворені.
  • У LML записуйте мітки гілок OR як булеві вирази над значеннями моделі (як-от speed > 3), якщо хочете, щоб вони стали умовами. Інші мітки стають doc-коментарями до послідовностей.
  • У SysML v2 задайте акторам тип визначення частини, а параметрам-предметам — тип визначення предмета. Нетипізовані не перетворюються.
  • Зберігайте оригінал. Після більших змін перетворюйте з нього знову, а не редагуйте обидва проєкти паралельно.

Типові помилки

  • Очікування, що оригінал зміниться. Він не змінюється. Копія — окремий проєкт.
  • Очікування, що діаграми збережуть розміщення. Розміщення не перетворюються; упорядкуйте нові подання чи діаграми знову.
  • Бракує частин у копії LML. Визначення частини, яке не використовує жодна частина, не має Asset у LML, бо LML має лише екземпляри. Використайте визначення в частині, потім перетворіть знову.
  • Елемент "does not resolve" (не розв’язується) у звіті. Ім’я в тексті SysML v2 ні на що не вказує. Виправте ім’я в Редакторі, потім перетворіть знову.

Довідник звіту

LML у SysML v2

До перетворених елементів належать Assets (визначення частин з їхніми використаннями), Characteristics (атрибути), Ports, Conduits (з’єднання або інтерфейси), Input/Outputs (визначення предметів), Requirements, Actions і варіанти використання, потоки предметів між діями, States, Transitions, Equations (визначення обмежень), Performs, Test suites, Test Cases, Verifies, Satisfies, а також елементи Holarch (копіюються зі своїми зв’язками): артефакти, твердження, завдання, ризики, елементи розкладу, витрати, проблеми, рішення, небезпеки та види відмов. Робочі процеси класів (зміни схеми проєкту) переносяться з власними станами, переходами й затверджувачами, тож вимоги й тестові випадки зберігають власні значення Status. Копія зберігає перемикачі проєкту Формальна програма та Безпека та надійність.

Не перетвореноПричина
Assets у циклі декомпозиціїAsset, що містить сам себе, не має місця в дереві частин. Його визначення частини перетворюється; як частина воно не використовується.
Conduits, що мають не рівно два кінціЗ’єднання SysML поєднує два кінці. З’єднайте conduit з двома assets або портами, потім перетворіть знову.
Предмети, які передає conduitЗ’єднання в цьому перетворенні не несуть предметів. Предмети перетворюються як визначення предметів і потоки між діями.
Conduits, декомпоновані на інші conduitsЗ’єднання SysML тут не вкладаються; кожен conduit стає окремим з’єднанням.
Кількості повторень і скрипти циклівЦикл SysML тут повторюється до виконання умови; кількість зберігається як дані Holarch і відновлюється командою Створити копію LML.
Мітки й імовірності гілок рішенняКоли кожна мітка рішення є булевим виразом над значеннями моделі, мітки стають його умовами; інакше вони стають doc-коментарями до послідовностей. Імовірності зберігаються як дані Holarch для Симулятора, і обидва відновлюються командою Створити копію LML.
Елементи OR, SYNC і LOOPКонструкції перетворюються на вузли decide/merge, fork/join і loop; елементи, що їх називали, не зберігаються.
Дії entry, do і exit станівДії перетворюються як дії; тіла станів SysML це перетворення не заповнює.
Переходи не між двома станами одного автоматаПерехід SysML поєднує два стани того самого визначення стану.
Умови й тригери переходівУ LML вони записані вільним текстом; вони зберігаються як дані Holarch, а не як вирази SysML, і відновлюються командою Створити копію LML.
Стани, не задані assetСтан потребує asset, поведінку якого він описує.
Вирази EquationВирази використовують імена, які не є ознаками SysML; кожен зберігається як коментар у своєму визначенні обмеження.
Test suites без тестових випадківНабір стає пакетом своїх випадків верифікації; порожньому набору нічого містити.
Тестові випадки, що верифікують щось інше, ніж вимогуВипадок верифікації SysML верифікує лише вимоги.
Цикли тестуванняПрогони тестів, записані в наборі, не є частиною моделі; зберігається останній результат кожного випадку.
Вимоги, що їх задовольняють елементи інших видівНаприклад, у SysML вимога не задовольняє іншу вимогу; використовуйте derivation у тексті.
Інші зв’язкиЦе перетворення не має для них зв’язку SysML; звіт називає кожен.
MeasuresМіри ефективності не мають елемента SysML у цьому перетворенні.
ResourcesКількості ресурсів (consumes, produces) належать до симулятора LML і тут не мають елемента SysML.
Characteristics, не прикріплені до asset чи equationАтрибут потребує власника: задайте його через asset або зробіть змінною equation.
Елементи інших класівЦей клас не має елемента SysML чи місця в Holarch у проєкті SysML v2.
Характеристики та конфігураціїПоки що ні: характеристики й конфігурації лінійки продуктів не стають точками варіації, варіантами й конфігураціями SysML v2. Звіт перелічує їх як елементи Feature і Configuration; змоделюйте варіанти в копії заново (див. Варіанти та конфігурації SysML v2).
Базові лініїБазові лінії проєкту LML не застосовуються до нової моделі; копія починається без базових ліній.
ІсторіяІсторія змін у копії починається заново.
Запити на змінуЗапити на зміну LML пропонують зміни елементів LML, яких копія не має.
Розміщення діаграмДіаграми малюються заново як подання SysML v2; позиції не переносяться.
Перетворені елементи у структурі документівДокументи копіюються; вимоги та інші елементи моделі з їхньої структури тепер є елементами SysML і з’являються в моделі, а не в структурі.

SysML v2 у LML

Кожне використання частини стає Asset, у який скопійовано частини, порти й атрибути його визначення (і визначень, які воно спеціалізує). Перевизначення замінюють те, що вони перевизначають. З’єднання й інтерфейси стають Conduits між цими Assets. Вимоги, випадки верифікації, satisfy, verify, perform, параметри-предмети, стани й переходи відображаються назад, як у таблиці вище. Послідовності стають потоками дій; умови рішення (або doc-коментарі його послідовностей) стають мітками гілок OR з їхніми ймовірностями. Зміни схеми проєкту переносяться, включно з робочими процесами класів з власними станами, переходами й затверджувачами, тож вимоги й тестові випадки зберігають власні значення Status.

Не перетвореноПричина
З’єднання з кінцями, що не розв’язуютьсяВиправте імена кінців у тексті, потім перетворіть знову.
З’єднання всередині визначень, які не використовує жодна частинаКожне з’єднання стає conduit між частинами кожної частини, яка його має; це визначення ніщо не використовує.
Зв’язувальні з’єднувачіLML не має зв’язування (рівності) між ознаками.
Відношення verify, що не розв’язуютьсяВиправте назву вимоги в меті верифікації, потім перетворіть знову.
Параметри-предмети без визначення предметаТипізуйте параметр через item def, щоб його перетворити.
Актори без визначення частини в моделіТипізуйте актора через part def, щоб його перетворити.
Використання perform, що не розв’язуються в дію і частинуВиконуйте дію з визначення частини або використання частини, потім перетворіть знову.
Відношення satisfy, що не розв’язуютьсяВиправте імена в інструкції satisfy, потім перетворіть знову.
Послідовності, що не є структурованим потокомПотоки дій LML — це послідовності з паралельними блоками, блоками рішень і циклів; інші графи послідовностей лінеаризуються.
Визначення станів, які не проявляє жодна частинаСтани перетворюються без asset, поведінку якого вони описують.
Переходи, що не розв’язуються у два станиВиправте назви станів, потім перетворіть знову.
Тригери переходів (accept)Переходи LML зберігають тригер лише як вільний текст; прийнятий сигнал не пов’язується.
Визначення портів, інтерфейсів і з’єднаньВони перетворюються на Ports і Conduits там, де їх використовують частини; LML не має типів портів, інтерфейсів чи з’єднань.
Визначення атрибутів (типи значень)Характеристики LML не мають типів.
Переліки та значення переліківLML не має переліків; значення атрибутів зберігаються як текст.
Обчислення, випадки аналізу, занепокоєнняLML не має обчислень, випадків аналізу чи занепокоєнь зацікавлених сторін.
Подання й точки зоруДіаграми в копії LML малюються заново.
Дії assignment, if, send і acceptДії LML не мають інструкцій.
ЗалежностіLML не має загальної залежності.
РозподілиВикористовуйте perform у тексті для дій, які виконують частини.
МетаданіLML не має метаданих.
Появи (occurrences)LML не має появ (occurrences).
Включені варіанти використанняВідношення include між варіантами використання не перетворюються.
ПсевдонімиСутності LML мають по одній назві.
Використання посилань (параметри обчислень і випадків)LML не має параметрів, крім змінних equation.
СпеціалізаціїLML не має спеціалізації; частини отримують копії ознак своїх загальних визначень.
ПеревизначенняОзнака, що перевизначає, замінює успадковану в кожній скопійованій частині.
Підмножини (subsettings)LML не має підмножин (subsetting).
ІмпортиLML не має просторів імен; кожна сутність видима в проєкті.
Визначення на відміну від використаньLML має лише екземпляри: визначення частини стає Assets частин, що його використовують, а його текст потрапляє до їхніх описів.
Кратності, крім кратностей частинМісце в LML мають лише кратності частин (Multiplicity у decomposed by).
Значення атрибутівЗначення зберігаються як текст у Value кожної характеристики; одиниці й вирази не обчислюються.
Базові лініїБазові лінії проєкту SysML v2 не застосовуються до копії LML; вона починається без базових ліній.
ІсторіяІсторія змін у копії починається заново.
Запити на змінуЗапити на зміну SysML пропонують зміни тексту, які не застосовуються до сутностей LML.

CSV звіту

Завантажити звіт (CSV) записує по одному рядку на кожен вид перетворених елементів і по одному рядку на кожен елемент, що не перетворився. Його стовпці: Результат (Перетворено або Не перетворено), Що, Кількість, Стає або причина, Номер і Назва.

Повідомлення

ПовідомленняЗначення та виправлення
Перевірка перетворення… (смуга прогресу)Звіт готується.
Це вже проєкт SysML v2. Виберіть натомість Створити копію LML….Вибрано неправильний напрямок.
Це вже проєкт LML. Виберіть натомість Створити копію SysML v2….Вибрано неправильний напрямок.
Перетворений текст має N проблем. Копія показує їх у своєму Редакторі.Копію можна створити; виправте проблеми в її Редакторі.
Перетворений текст не вдається розібрати (…). Проєкт не скопійовано; повідомте про це, додавши файл проєкту.Перетворення не вдалося. Зверніться до підтримки, додавши файл проєкту.
Засіб перевірки SysML не запустився. Перезавантажте сторінку й спробуйте знову.Перезавантажте й спробуйте знову.
Не вдалося прочитати проєкт. Перезавантажте сторінку й спробуйте знову.Перезавантажте й спробуйте знову.
Копію не створено: … Перезавантажте сторінку й спробуйте знову.Перезавантажте й спробуйте знову.
Створено "<name>"Копію створено й відкрито.

Обмеження

  • Розміщення діаграм, історія, базові лінії й запити на зміну не перетворюються.
  • Поки що ні: перетворення лінійки продуктів LML (характеристик і конфігурацій) на варіанти SysML v2.
  • Документ звіту перелічує до 500 елементів кожного виду.

SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.