SysML v2
Перетворення між LML і SysML v2
Створіть копію проєкту LML у SysML v2 або копію проєкту SysML v2 в LML зі звітом про те, що перетворюється, а що ні.
Огляд
Тип проєкту, LML або SysML v2, фіксується під час його створення. Щоб працювати з моделлю LML у SysML v2 або з моделлю SysML v2 на сторінках LML, створіть перетворену копію:
- Створити копію SysML v2… у проєкті LML записує його модель як текст SysML v2 у новий проєкт SysML v2.
- Створити копію LML… у проєкті SysML v2 перетворює його модель на сутності та зв’язки LML у новому проєкті LML.
Початковий проєкт ніколи не змінюється. Перед створенням копії звіт перелічує, що перетворюється (з кількістю), а що ні (з причиною). Той самий звіт зберігається в новому проєкті.
Поняття
Копія, а не зміна типу
Перетворення завжди створює новий проєкт. Можна далі працювати в оригіналі й пізніше перетворити знову; кожне перетворення створює ще один новий проєкт. Копія ніяк не пов’язана з оригіналом.
Як відповідають одна одній дві мови
LML і SysML v2 описують багато тих самих речей по-різному. Перетворення використовує цю відповідність в обох напрямках:
| LML | SysML v2 |
|---|---|
| Asset | Визначення частини з використанням частини скрізь, де воно використовується |
| Декомпозиція Asset (decomposed by) | Використання частини у визначенні батьківського елемента |
| Port | Використання порту |
| Characteristic елемента Asset | Використання атрибута |
| Conduit | Використання з’єднання або використання інтерфейсу, коли обидва кінці є портами |
| Input/Output | Визначення предмета з параметрами-предметами in і out та потоками |
| Requirement (Number, Name, Description) | Використання вимоги (коротке ім’я, назва, doc) |
| satisfied by | satisfy |
| Test Case | Використання верифікації з метою verify |
| Test Suite | Пакет випадків верифікації |
| Action з її потоком | Використання дії з послідовностями |
| Блоки SYNC і паралельні блоки | Розгалуження й з’єднання |
| OR | Рішення й злиття |
| LOOP | Дія циклу |
| performed by | perform |
| Характеристики станів і переходи | Визначення стану з переходами, які проявляє частина |
| 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 для рецензування.
Перетворюйте, коли модель стабільна, і прочитайте звіт, перш ніж покладатися на копію.
Створення перетвореної копії
- На сторінці Керування проєктами натисніть ⋯ у рядку проєкту.
- Виберіть Створити копію SysML v2… (для проєкту LML) або Створити копію LML… (для проєкту SysML v2).
Holarch перевіряє перетворення; у великому проєкті смуга прогресу внизу вікна показує "Перевірка перетворення…". Потім відкривається діалог зі звітом.
- Прочитайте звіт:
- Перетворено перелічує кожен вид елементів, їхню кількість і те, чим вони стають, наприклад "Вимоги 24 використання вимог".
- Не перетворено перелічує кожен вид елементів, що не перетворюється, їхню кількість і причину.
- Натисніть Завантажити звіт (CSV), щоб зберегти звіт з одним рядком на елемент, якщо він потрібен поза Holarch.
- Введіть Назва нового проєкту. За замовчуванням це назва оригіналу, після якої йде "(SysML v2)" або "(LML)".
- Натисніть Створити копію.
Сповіщення: "Створено "<name>"". Копія відкривається на своїй Головній сторінці.
- Відкрийте в копії документ Звіт про перетворення. Він перелічує кожен елемент, що не перетворився, за номером і назвою.
Перевірка копії
- У копії SysML v2 відкрийте Модель → Редактор.
Модель — це один пакет верхнього рівня, названий за проєктом. Він містить пакети Architecture, System, Items, Requirements, Verification, Behavior, Constraints і Views (лише ті, що мають вміст).
- Шукайте позначки проблем на полі ліворуч від тексту. Якщо перетворений текст має проблеми, діалог повідомив про це ще до створення копії: "Перетворений текст має N проблем. Копія показує їх у своєму Редакторі."
- Відкрийте подання в Подання (Architecture Overview, System Connections), щоб побачити заново намальовану структуру.
- У копії LML відкрийте Базу даних і діаграми, щоб перевірити Assets, Requirements і потоки дій.
Приклад: демопроєкт Hybrid Car як копія LML
Спершу створіть демопроєкт: на сторінці Керування проєктами натисніть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2).
- На сторінці Керування проєктами натисніть ⋯ у рядку Hybrid Car (SysML v2 demo) і виберіть Створити копію LML…. Копія матиме назву "Hybrid Car (SysML v2 demo) (LML)".
- Прочитайте звіт.
У розділі Перетворено: використання частин стають 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 малюються заново.
- Спеціалізації: LML не має спеціалізації; частини отримують копії ознак своїх загальних визначень.
- Натисніть Створити копію.
Відкривається копія 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 v2
- Обмін моделями SysML v2
- Функції Holarch у проєктах SysML v2
- Текстова нотація SysML v2
SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.