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 меняется, экспортируйте её снова и импортируйте новый файл в тот же проект (В этот проект). Каждый преобразованный элемент получает свой ID из ID элемента в файле XMI (xmi:id), поэтому импорт обновляет элементы на месте: элемент, переименованный или перемещённый в другой пакет в инструменте SysML v1, остаётся тем же элементом со своими макетами диаграмм, комментариями, ссылками и историей. Отчёт сообщает, сколько элементов получают ID из модели SysML v1. Элементы без имени (соединители, последовательности) сопоставляются по их месту в модели.
Проект, импортированный из модели SysML v1 до того, как Holarch стал выводить ID из файла XMI, сохраняет свои ID: более новый экспорт обновляет его элементы по имени, а новые элементы модели SysML v1 получают ID из неё.
Сохранение отчёта и текста
- Нажмите Скачать отчёт, чтобы получить файл 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. Отчёт сообщает: 1042 элемента, 1007 преобразовано, 32 приближено, 3 пропущено. Текст SysML v2 проходит проверку без проблем. - Установите для Показать значение Пропущено. Три строки — это расширение варианта использования, которого нет в SysML v2, и два отношения трассировки к элементам без имени, на которые текст SysML v2 не может ссылаться.
- Нажмите Создать проект. Новый проект SysML v2 открывается в Редакторе со структурой, функциями, требованиями и трассировками спутника.
Советы и типичные ошибки
- Импортируйте по одному файлу XMI за раз, без других файлов. Импортируйте по одному файлу SysML v1 XMI за раз, без других файлов.
- Давайте имена элементам, к которым ведут трассировки. Отношения к безымянным элементам пропускаются, потому что текст SysML v2 ссылается на элементы по имени.
- Импортируйте повторно, а не создавайте заново. Импортируйте более новый экспорт в тот же проект, а не в новый: элементы сохраняют свои ID только в проекте, где они есть.
- Сначала проверьте приближения. Это места, где смысл может отличаться от модели v1, например порты, типизированные блоками, или концы соединителей внутри частей.
- Элементы с одинаковым именем в одном месте переименовываются с суффиксом, например
_2. Отчёт перечисляет каждое переименование. - Требования, которые ведутся в инструменте управления требованиями (DOORS, Polarion, Jama, codebeamer), передаются как ReqIF, а не XMI. Импортируйте файл
.reqifна той же странице: он становится требованиями SysML v2 с таким же отчётом (Импортировать и экспортировать требования ReqIF).
Что преобразуется
| SysML v1 | SysML v2 |
|---|---|
| Модель, пакет | package |
| Блок, актор | part def |
| Тип значения, тип данных, перечисление | attribute def, enum def (типы значений с известной единицей СИ специализируют величину ISQ) |
| Сигнал | item def |
| Интерфейсный блок | port def |
| Свойства-части, свойства-ссылки и свойства-значения | part, ref part, attribute, с кратностями и значениями по умолчанию |
| Прокси-порт, свойство потока | port, in/out item или attribute |
| Полный порт | part с @SysMLv1Library::PortData |
| Соединитель, связывающий соединитель, поток предметов | connect, bind, flow |
| Обобщение | :> |
| Деятельность, действие вызова поведения, контакты (pins) | action def, action, параметры |
| Потоки управления и объектов, сторожевые условия | последовательности со сторожевыми условиями if и else, потоки между параметрами |
| Начальный и конечный узлы, решение, слияние, разветвление, соединение | start, done, decide, merge, fork, join |
| Машина состояний, состояния, области | state def, state, параллельные состояния |
| Переходы, триггеры по сигналу и по времени | transition с accept, accept after, сторожевыми условиями и эффектами |
| Взаимодействие | occurrence def с линиями жизни и сообщениями |
| Вариант использования, субъект, включение | use case def, subject, include |
| Требование (ID и текст) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify в цели верификации, соединение вывода (derivation) |
| Refine, trace | dependency с метаданными SysMLv1Library |
| Allocate, зависимость | allocate, dependency |
| Блок ограничений, ограничение | constraint def, assert constraint |
| Стереотипы и помеченные значения | metadata def на каждый стереотип, применённый с его тегами |
| Комментарий, документация | doc, comment |
Ограничения
- Один файл размером не более 64 МБ.
- Не более 250 000 элементов с вложенностью не глубже 512 уровней. Модель с более глубокой вложенностью или с циклом владения не импортируется.
- В преобразованной модели элементы, вложенные глубже 128 уровней, пропускаются с причиной вложенность.
- Преобразованный текст занимает не более 8 МБ.
- Диаграммы и их макеты не преобразуются. Создайте представления в проекте 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 МБ. Экспортируйте меньшую часть модели. | Экспортируйте по одному пакету за раз. |
Связанные страницы
- Обмен моделями SysML v2
- Импортировать и экспортировать требования ReqIF: требования из DOORS, Polarion и других инструментов управления требованиями.
- Текстовая нотация SysML v2
- Преобразование между LML и SysML v2
SysML® и OMG® — зарегистрированные товарные знаки Object Management Group, Inc. в США и других странах.