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 меняется, экспортируйте её снова и импортируйте новый файл в тот же проект (В этот проект). Каждый преобразованный элемент получает свой 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 даёт реалистичную тестовую модель.

  1. Откройте демо-проект CubeSat EO-1 и экспортируйте его как UML/SysML XMI в формате OMG XMI 2.5.1 (см. Экспорт модели UML/SysML (XMI)).
  2. Откройте проект SysML v2, нажмите Модель → Импорт и экспорт, выберите В новый проект SysML v2 и перетащите файл .xmi. Отчёт сообщает: 1042 элемента, 1007 преобразовано, 32 приближено, 3 пропущено. Текст SysML v2 проходит проверку без проблем.
  3. Установите для Показать значение Пропущено. Три строки — это расширение варианта использования, которого нет в SysML v2, и два отношения трассировки к элементам без имени, на которые текст SysML v2 не может ссылаться.
  4. Нажмите Создать проект. Новый проект SysML v2 открывается в Редакторе со структурой, функциями, требованиями и трассировками спутника.

Советы и типичные ошибки

  • Импортируйте по одному файлу XMI за раз, без других файлов. Импортируйте по одному файлу SysML v1 XMI за раз, без других файлов.
  • Давайте имена элементам, к которым ведут трассировки. Отношения к безымянным элементам пропускаются, потому что текст SysML v2 ссылается на элементы по имени.
  • Импортируйте повторно, а не создавайте заново. Импортируйте более новый экспорт в тот же проект, а не в новый: элементы сохраняют свои ID только в проекте, где они есть.
  • Сначала проверьте приближения. Это места, где смысл может отличаться от модели v1, например порты, типизированные блоками, или концы соединителей внутри частей.
  • Элементы с одинаковым именем в одном месте переименовываются с суффиксом, например _2. Отчёт перечисляет каждое переименование.
  • Требования, которые ведутся в инструменте управления требованиями (DOORS, Polarion, Jama, codebeamer), передаются как ReqIF, а не XMI. Импортируйте файл .reqif на той же странице: он становится требованиями SysML v2 с таким же отчётом (Импортировать и экспортировать требования ReqIF).

Что преобразуется

SysML v1SysML 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 requirementsatisfy, verify в цели верификации, соединение вывода (derivation)
Refine, tracedependency с метаданными 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® и OMG® — зарегистрированные товарные знаки Object Management Group, Inc. в США и других странах.