Holarch

SysML v2

Обмін моделями SysML v2

Імпортуйте файли .sysml, zip-архіви та SysML v2 JSON у проєкт SysML v2 з попереднім переглядом і експортуйте модель або пакет як текст .sysml чи SysML v2 JSON.

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

На цій сторінці
  1. Огляд
  2. Поняття
    1. Формати файлів
    2. Ідентифікатори та зіставлення
    3. Ідентифікатори елементів у тексті
    4. Папки стають пакетами
    5. Що порівнює попередній перегляд
  3. Як користуватися
    1. Коли й навіщо
    2. Імпортувати файли в цей проєкт
    3. Імпортувати файли в новий проєкт
    4. Оновити пакет з нової версії
    5. Перейменовувати й переміщувати елементи в тексті, зберігаючи їхні ідентифікатори
    6. Великі імпорти в хостинговому сервісі
    7. Експортувати модель або пакет
    8. Імпортувати й експортувати вимоги ReqIF
    9. Отримувати з репозиторію й надсилати в нього
    10. Приклад: демопроєкт Hybrid Car
    11. Поради та добрі практики
    12. Типові помилки
    13. Як це пов’язано з іншими функціями
  4. Сторінка “Імпорт і експорт”
    1. Імпорт
    2. Експорт
  5. Репозиторій
  6. Як читаються файли
    1. Елементи, які Holarch не інтерпретує
  7. Повідомлення
  8. Обмеження
  9. Пов’язані сторінки

Огляд

Проєкти SysML v2 обмінюються моделями з іншими інструментами SysML v2 у вигляді файлів. Сторінка Імпорт і експорт (Модель → Імпорт і експорт) робить і те, і те:

  • Імпорт читає файли .sysml, архів .zip із файлами .sysml або файл SysML v2 JSON. Він показує попередній перегляд того, що зміниться, а потім застосовує це до цього проєкту (одне натискання “Відмінити” повертає все назад) або створює новий проєкт SysML v2.
  • Експорт записує всю модель або один пакет як текст SysML v2 (.sysml) або як SysML v2 JSON (.json).
  • Файли ReqIF (.reqif, .reqifz) з інструментів роботи з вимогами імпортуються як вимоги SysML v2, а вимоги експортуються як ReqIF: див. Імпортувати й експортувати вимоги ReqIF.

Проєкт можна також створити безпосередньо з файлів: на сторінці Керування проєктами натисніть Файли проєктів ▾ → Імпортувати файли SysML v2….

Порада: щоб підтримувати модель узгодженою з репозиторієм моделей SysML v2, який пропонує Systems Modeling API, використовуйте розділ Репозиторій на тій самій сторінці: див. Отримувати з репозиторію й надсилати в нього.

Поняття

Формати файлів

ФорматЩо міститьІмпортЕкспорт
Текст SysML v2 (.sysml)Текстова нотація, один файл на пакет верхнього рівня.ТакТак
Zip-архів (.zip)Кілька файлів .sysml. Папки стають пакетами.ТакТак, коли експортується кілька файлів
SysML v2 JSON (.json)Плаский список елементів, кожен з @id і @type, як у Systems Modeling API.ТакТак
ReqIF (.reqif, .reqifz)Вимоги з їхніми атрибутами, ієрархією та зв’язками з DOORS, Polarion, Jama, codebeamer та інших інструментів роботи з вимогами.Так, перетворюються на вимогиТак, вимоги

Файли KerML (.kerml) поки що не імпортуються.

Ідентифікатори та зіставлення

Кожен елемент у проєкті SysML v2 має ідентифікатор. Два формати зберігають його по-різному:

  • JSON зберігає ідентифікатори. Елемент, повторно імпортований з JSON, зіставляється з елементом із тим самим ідентифікатором.
  • Посилання на стандартну бібліотеку розпізнаються. JSON із Systems Modeling API, SysML v2 Pilot Implementation або іншого репозиторію називає елементи стандартної бібліотеки (одиниці, як-от ISQ::mass, ScalarValues::Real, Parts::Part) стандартними ідентифікаторами. Імпорт читає їх як ті самі елементи бібліотеки, тож одиниці й типи залишаються розпізнаними.
  • Текст зберігає ідентифікатори, коли ви цього просите. Позначте Включити ідентифікатори елементів, коли експортуєте текст .sysml. Тоді кожне іменоване визначення, використання й пакет містить свій ідентифікатор як перший рядок свого тіла, @HolarchMetadata::ElementId { id = "…"; }. Коли цей текст імпортується знову, кожен елемент з ідентифікатором зіставляється з елементом із тим самим ідентифікатором, навіть якщо його перейменовано, переміщено до іншого власника або іншого пакета верхнього рівня чи переупорядковано. Його позиції на діаграмах, коментарі, сліди простежуваності й зв’язки зберігаються.
  • Текст без ідентифікаторів зіставляється за назвою. Holarch зіставляє пакети верхнього рівня за назвою, а елементи в них — за назвами й позиціями. Ідентифікатори зберігаються там, де елементи збігаються. Перейменований елемент усе ще зіставляється, коли залишається на своєму місці; елемент, який одночасно перейменовано й переміщено, стає новим елементом.

Експорт зазначає це під елементами керування експортом: "Ідентифікатори елементів зберігаються в JSON. У тексті .sysml позначте “Включити ідентифікатори елементів”, щоб зберегти їх: тоді елементи зберігають свої позиції на діаграмах, коментарі й сліди простежуваності, коли відредагований текст імпортується знову, навіть після перейменування чи переміщення. Без ідентифікаторів елементи зіставляються за назвою."

Ідентифікатори елементів у тексті

@HolarchMetadata::ElementId { id = "…"; } — звичайні метадані SysML v2: ElementId — це визначення метаданих у власному бібліотечному пакеті Holarch HolarchMetadata (у Стандартній бібліотеці в розділі Holarch), поруч із TBD і TBR. Інші інструменти SysML v2 читають цей рядок як анотацію метаданих; щоб розпізнати його назву, їм потрібен HolarchMetadata.sysml з цієї бібліотеки.

  • Ідентифікатор належить елементу, тіло якого містить цей рядок. Неіменовані елементи (з’єднання, послідовності, коментарі) не мають ідентифікатора й зіставляються за вмістом, як і раніше.
  • Holarch не зберігає цей рядок як елемент. Редактор показує модель без цих рядків, а елемент, тіло якого містило лише цей рядок, показано як part engine : Engine;.
  • Ідентифікатори мають бути унікальними. Коли той самий ідентифікатор трапляється двічі (наприклад, після копіювання блоку в тексті), перший елемент зберігає його, а копія стає новим елементом.
  • Ідентифікатор, який не є UUID (наприклад, "R-17"), перетворюється на фіксований UUID, тож той самий рядок завжди дає той самий елемент, як і в імпорті JSON.
  • Ідентифікатор, якого немає в проєкті, зберігається для нового елемента. Видалення елемента в Holarch і повторний імпорт тексту повертає його під старим ідентифікатором.
  • У Редакторі вставлений рядок діє в межах пакета, який ви редагуєте: ідентифікатор, що належить елементу іншого пакета, там ігнорується, а елемент зіставляється за назвою. Щоб переміщувати елементи між пакетами, зберігаючи їхні ідентифікатори, експортуйте з ідентифікаторами й імпортуйте відредаговані файли.

Визначення частини Car демопроєкту Hybrid Car містить такий рядок у вихідному файлі, тож його ідентифікатор однаковий у кожній копії демопроєкту.

Папки стають пакетами

У zip-архіві кожна папка стає пакетом, який містить її файли й підпапки. Файл powertrain/engine.sysml в архіві читається так, ніби його написано всередині package powertrain { … }. Файли на верхньому рівні архіву читаються як є. Папки й файли читаються в порядку назв.

Що порівнює попередній перегляд

Попередній перегляд має один рядок на пакет верхнього рівня (або, для нового проєкту, на елемент верхнього рівня). Кожен рядок має результат:

РезультатЗначенняІмпортується за замовчуванням
НовийПроєкт не має пакета з такою назвою (або ідентифікатором). Його буде додано.Так
ЗміненоПроєкт має цей пакет; імпорт додає, змінює або вилучає елементи в ньому. Подробиці показують скільки, наприклад "3 додано, 1 змінено (ідентифікатори збережено там, де елементи збігаються)".Так
Без змінПакет такий самий, як у цьому проєкті.Ні (нічого робити)
КонфліктПакет не можна об’єднати. Подробиці пояснюють чому й що робити.Ні

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

Коли й навіщо

Використовуйте “Імпорт і експорт”, коли модель переходить між Holarch та іншим інструментом SysML v2 або між проєктами Holarch:

  • Почати проєкт Holarch з моделі, написаної деінде.
  • Додати пакет, який підтримує інша команда, як-от бібліотеку компонентів, і оновлювати його, коли вони надсилають нову версію.
  • Передати пакет постачальнику або інструменту, який читає текст SysML v2 або JSON.
  • Зберігати файли .sysml у власній системі керування версіями поруч із проєктом Holarch.

Імпортувати файли в цей проєкт

  1. Відкрийте Модель → Імпорт і експорт.
  2. У розділі Імпортувати виберіть У цей проєкт.
  3. Перетягніть файли на зону скидання або натисніть її й виберіть їх.

    Ви бачите "Читання файлів…", потім попередній перегляд: кількість пакетів верхнього рівня й файлів, будь-які проблеми й таблицю з Імпортувати, Пакет, Елементи і Результат.

  4. Прочитайте список проблем, якщо він є. Він називає кожен файл і рядок, які не вдалося розібрати, і кожен пропущений файл.
  5. Зніміть позначку з кожного пакета, який не потрібно імпортувати. Щоб замінити пакет, що конфліктує за назвою, позначте його.

    На тарифі з обмеженням кількості елементів попередній перегляд рахує елементи, які матиме проєкт після імпорту (зв’язки не враховуються). Якщо це більше за обмеження, він про це повідомляє, наприклад "Цей імпорт довів би проєкт до 1,804 елементів; тариф Free дозволяє 1,000.", і Імпортувати N пакетів лишається недоступним, доки ви не знімете позначку з достатньої кількості пакетів. Нічого не застосовується й не надсилається на сервер. Імпорт у новий проєкт так само перевіряється за обмеженням вашого тарифу на один проєкт.

  6. Натисніть Імпортувати N пакетів.

    Сповіщення: "Імпортовано N пакетів." На сторінці написано "Імпортовано N пакетів (M елементів). Відмінити скасовує імпорт одним кроком." Натисніть Відкрити текст, щоб їх побачити.

Імпортувати файли в новий проєкт

  1. Відкрийте Модель → Імпорт і експорт і виберіть У новий проєкт SysML v2.
  2. Перетягніть або виберіть файли.

    Попередній перегляд перелічує елементи верхнього рівня, усі позначені.

  3. Зніміть позначку з непотрібних і змініть Назва проєкту. За замовчуванням це назва єдиного файлу або першого пакета.
  4. Натисніть Створити проєкт.

    Новий проєкт відкривається в Редакторі.

На сторінці Керування проєктами пункт Файли проєктів ▾ → Імпортувати файли SysML v2… робить те саме за один крок. Якщо частину файлів не вдається прочитати, він спершу питає: "Знайдено N проблем: частини файлів пропущено. Створити проєкт з рештою? Щоб спершу переглянути проблеми, відкрийте проєкт SysML v2 і скористайтеся сторінкою Імпорт і експорт." Натисніть Створити проєкт, щоб продовжити.

Оновити пакет з нової версії

  1. Експортуйте або отримайте нову версію як файли .sysml чи JSON.
  2. Імпортуйте її У цей проєкт.

    Пакет показує Змінено з кількістю доданих, змінених і вилучених елементів.

  3. Натисніть Імпортувати 1 пакет.

    Елементи, що збігаються, зберігають свої ідентифікатори, тож зв’язки з ними (зв’язки вимог, ризики, розміщення подань, коментарі) залишаються. Елементи, яких більше немає у файлі, переміщуються до Кошика.

Перейменовувати й переміщувати елементи в тексті, зберігаючи їхні ідентифікатори

  1. Експортуйте пакети як текст SysML v2 з позначеним Включити ідентифікатори елементів.
  2. Відредагуйте файли: перейменуйте елементи, перемістіть їх до інших власників або до файлу іншого пакета, змініть їхній порядок. Залишайте кожен рядок @HolarchMetadata::ElementId у тілі його елемента.
  3. Імпортуйте відредаговані файли У цей проєкт.

    Пакети показують Змінено. Перейменовані й переміщені елементи враховуються як змінені, а не як додані й вилучені.

  4. Натисніть Імпортувати N пакетів.

    Елементи зберігають свої ідентифікатори: їхні позиції на діаграмах, коментарі, траси та зв’язки залишаються. Елементи, переміщені до іншого пакета, залишають пакет, у якому були.

Великі імпорти в хостинговому сервісі

У хмарному сервісі імпорт від 5,000 елементів застосовує сервер, а не ваш браузер. Коли кожен позначений пакет має стан Новий або замінює Конфлікт, сервер сам читає файли (кроки нижче). Коли позначений пакет має стан Змінено, ваш браузер, як завжди, обчислює об’єднання й один раз передає зміни; потім сервер записує їх одним кроком, з тією самою карткою поступу, Скасувати імпорт і Відмінити імпорт.

  1. Виберіть файли й перевірте попередній перегляд, як для будь-якого імпорту.
  2. Натисніть Імпортувати N пакетів (або Створити проєкт).

    Файли передаються один раз. Сервер читає їх з тими самими перевірками й тими самими ідентифікаторами елементів, що й попередній перегляд, і записує результат одним кроком.

  3. Стежте за карткою поступу внизу вікна: вона показує етап (передавання, читання, перевірка, застосування, оновлення індексу проєкту) і час, що залишився.

    Можна залишити сторінку або закрити вкладку. Імпорт триває на сервері, і коли ви знову відкриєте проєкт, його результат буде там. Кожна відкрита копія проєкту перезавантажується, коли імпорт застосовано; ненадіслані зміни надсилаються знову після перезавантаження.

  • Інші учасники бачать "Name імпортує file…" у тій самій картці та на сторінці Імпорт і експорт.
  • Один імпорт за раз: другий великий імпорт у той самий проєкт чекає, доки завершиться перший.
  • Скасувати імпорт (той, хто його почав, або власник) зупиняє імпорт до того, як його застосовано. Нічого не змінюється.
  • Відмінити імпорт: ⌘Z / Ctrl+Z у браузері не повертає назад серверний імпорт. Натисніть Відмінити імпорт на сторінці Імпорт і експорт, щоб повернути проєкт до стану перед останнім імпортом. Стан перед відміною зберігається в Історія, тож зміни, зроблені після імпорту, можна відновити звідти.
  • Активність проєкту та Історія показують імпорт як один запис від того, хто його почав.

Експортувати модель або пакет

  1. Відкрийте Модель → Імпорт і експорт.
  2. У розділі Експорт виберіть, що експортувати: Уся модель або пакет за його кваліфікованою назвою.
  3. Виберіть формат: Текст SysML v2 (.sysml; .zip для кількох пакетів) або SysML v2 JSON (.json).
  4. Для тексту, який ви редагуватимете й імпортуватимете знову, позначте Включити ідентифікатори елементів.
  5. Натисніть Експорт.

    Завантажується один файл або zip, якщо експорт містить кілька файлів. Сповіщення: "Експортовано <file>." або "Експортовано N файлів як zip."

Щоб швидко експортувати один пакет, скористайтеся Оглядачем: меню рядка пакета має Експортувати як .sysml і Експортувати як JSON.

Імпортувати й експортувати вимоги ReqIF

ReqIF — формат обміну інструментів керування вимогами. Файл ReqIF імпортується як один пакет вимог SysML v2, а вимоги експортуються назад як ReqIF, тож інструмент вимог і проєкт SysML v2 можуть обмінюватися тими самими вимогами в обох напрямках.

Імпорт файлу ReqIF:

  1. Відкрийте Модель → Імпорт і експорт (або натисніть Імпортувати… на сторінці Вимоги, або виберіть Імпортувати ReqIF… у ⌘K / Ctrl+K).
  2. Перетягніть файл .reqif або .reqifz на поле або клацніть поле, щоб його вибрати. Один файл ReqIF на імпорт.
  3. Панель ReqIF показує кількість вимог, розділів і відношень, скільки з них перетворено, наближено чи пропущено, і чи проходить текст SysML v2 перевірку без проблем.
  4. У полі Короткі імена з виберіть Зовнішній ID (номер, який люди бачать у вихідному інструменті, наприклад SRS-12) або Ідентифікатор ReqIF (внутрішній ідентифікатор інструмента). Вимоги без Зовнішнього ID беруть ідентифікатор.
  5. У розділі Типи зв’язків виберіть, чим стає кожен тип відношення: Вивести, Уточнити, Залежність або Пропустити. Попередній перегляд обчислюється знову, а вибір зберігається для наступного імпорту того самого файлу.
  6. Натисніть Імпортувати 1 пакет. Одне натискання “Відмінити” повертає назад увесь імпорт. Сповіщення: "Імпортовано N вимог з <title>."

Що створює імпорт:

ReqIFSysML v2
Вимога (spec object)requirement із Зовнішнім ID або ідентифікатором як коротким ім’ям, назвою і текстом як doc
Тип вимогиrequirement def з одним атрибутом на кожен атрибут ReqIF
Тип даних перелікуenum def
Атрибут статусу (Draft, Proposed, Approved тощо)Статус вимоги в Holarch
Заголовок розділуpackage з номером розділу як коротким ім’ям
Вкладена вимогаВкладена requirement
Відношення derived fromЗ’єднання Derivation
Відношення refinesЗалежність з анотацією Refinement
satisfies, verified by та інші відношенняЗалежність (звіт пояснює чому)
Специфікаціяpackage усередині пакета файлу

Таблиці стають рядками тексту з | між клітинками, списки — рядками, що починаються з тире, а від форматування й посилань лишається тільки текст; такі вимоги мають стан Наближено. Зображення та вбудовані об’єкти не імпортуються; вимогу, що їх містила, перелічено з причиною, тож ви можете прикріпити до неї файл. Завантажити звіт зберігає кожну вимогу й відношення з результатом у CSV; Завантажити текст SysML v2 зберігає текст.

Імпорт новішої копії файлу: імпортуйте її в той самий проєкт. Holarch знаходить пакет попереднього імпорту й порівнює вимогу за вимогою:

  • Вимоги зберігають свої ідентифікатори елементів, тож діаграми, зв’язки satisfy і verify, рецензування та Історія залишаються прив’язаними. Перейменовані й переміщені вимоги оновлюються на місці.
  • Вимоги, яких немає в новому файлі, зберігаються. Позначте Вилучити N вимог, яких немає в цьому файлі, щоб перемістити їх до Кошика.
  • Частини, випадки верифікації та зв’язки, додані в Holarch, зберігаються.
  • Вимога, змінена тільки в Holarch, зберігає вашу зміну. Вимога, змінена і тут, і у файлі, бере текст файлу; попередній текст залишається в Історії. Попередній перегляд перелічує такі вимоги в розділі Змінено тут і у файлі.

Експорт як ReqIF:

  1. У розділі Експорт виберіть пакет або Уся модель, а також ReqIF (.reqif) або Архів ReqIF (.reqifz).
  2. Натисніть Експорт. Сповіщення: "Експортовано N вимог як <file>."

Експорт… → Вимоги (ReqIF) на сторінці База даних або Вимоги так само експортує показані (або вибрані) вимоги.

Файл містить коротке ім’я кожної вимоги (як ReqIF.ForeignID), назву, doc (як XHTML), статус і значення атрибутів, ієрархію пакетів як специфікацію, а також зв’язки derive, refine і dependency. Вимоги, імпортовані з ReqIF, зберігають свої початкові ідентифікатори, типи й типи відношень, тож вихідний інструмент оновлює свої вимоги замість додавати копії; якщо експортувати файл і знову імпортувати, кожен пакет показує Без змін. Обчислені значення атрибутів записуються як текст. Зв’язки satisfy і verify залишаються в Holarch: у ReqIF немає частин і випадків верифікації.

Отримувати з репозиторію й надсилати в нього

Під’єднайте проєкт до однієї гілки репозиторію моделей SysML v2, щоб читати його останній коміт і надсилати свої зміни назад.

  1. Відкрийте Модель → Імпорт і експорт і знайдіть розділ Репозиторій.
  2. Введіть Адреса репозиторію (https-адресу його Systems Modeling API) і, якщо репозиторій цього потребує, Токен доступу.
  3. Натисніть Завантажити проєкти, потім виберіть Проєкт і Гілка. Щоб почати новий проєкт у репозиторії з цієї моделі, натисніть натомість Новий проєкт репозиторію.
  4. Натисніть Отримати…. Holarch читає останній коміт гілки й перелічує кожну відмінність: Новий, Змінено, Вилучено або Конфлікт. Коли отримувати нічого, ви бачите "Актуально: у репозиторії немає змін."
  5. Зніміть позначку з непотрібних відмінностей, потім натисніть Застосувати pull. Одне натискання “Відмінити” повертає назад увесь pull.
  6. Після зміни моделі натисніть Надіслати. Ваші зміни з останнього синхронізованого коміту надходять до гілки як один новий коміт. Ви бачите, наприклад, "Надіслано 3 змінених як коміт 1a2b3c4d."

Конфлікт — це елемент, змінений і тут, і в репозиторії після останньої синхронізації. Конфлікт без позначки зберігає версію цього проєкту.

Примітка: Надсилання відхиляється, коли гілка має коміти, яких цей проєкт не отримав: "Гілка репозиторію має коміти, яких цей проєкт не отримав. Спершу отримайте їх, потім надішліть знову."

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

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

  1. Відкрийте Модель → Імпорт і експорт. У розділі Експорт виберіть Уся модель і текст SysML v2, потім натисніть Експорт.

    Завантажується zip з одним файлом на пакет верхнього рівня, як-от Vehicles.sysml, VehicleRequirements.sysml, VehicleBehavior.sysml і VehicleViews.sysml.

  2. Відкрийте VehicleRequirements.sysml у текстовому редакторі. Змініть attribute maxCurbMass : MassValue = 1650 [kg]; на 1600 [kg] і збережіть.
  3. Поверніться на Імпорт і експорт, виберіть У цей проєкт і перетягніть VehicleRequirements.sysml.

    Попередній перегляд показує VehicleRequirements як Змінено з кількістю змінених елементів. Інших пакетів у файлі немає, тому їх не перелічено.

  4. Натисніть Імпортувати 1 пакет.

    Значення в моделі змінюється. Вимога Sedan Mass (VR-1.1) називає maxCurbMass, тож її зв’язки позначаються для рецензування (див. Вимоги та верифікація в проєктах SysML v2). Натисніть ⌘Z / Ctrl+Z, щоб відмінити імпорт.

  5. Щоб почати другий проєкт з тих самих файлів, виберіть У новий проєкт SysML v2, перетягніть zip і натисніть Створити проєкт.

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

  • Використовуйте JSON, щоб переносити модель між інструментами SysML v2, коли важливі ідентифікатори, наприклад коли інший інструмент зберігає зв’язки за ідентифікатором. Використовуйте текст, коли люди читають або рецензують файли; позначайте Включити ідентифікатори елементів, коли текст повертається в Holarch після редагування.
  • Не включайте ідентифікатори в текст, який ви передаєте людям лише для читання: вони додають по рядку на кожен елемент.
  • Тримайте один пакет верхнього рівня в кожному файлі. Експорт записує файли саме так, і подальший імпорт тоді зіставляє пакет за пакетом.
  • Імпортуйте пакет від іншої команди в окремий пакет верхнього рівня. Оновлення тоді зачіпають лише цей пакет.
  • Перевірте список проблем перед імпортом. Члени, які не вдається розібрати, пропускаються.

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

  • Пакет показує Конфлікт: "Пакет з назвою X з іншими ідентифікаторами вже існує." Проєкт має пакет з такою назвою, який не було імпортовано з цього JSON. Позначте рядок, щоб замінити його (старий пакет переміститься до Кошика), або імпортуйте в новий проєкт.
  • "Імпорт містить два пакети верхнього рівня з назвою X; імпортується лише перший." Два файли оголошують той самий пакет верхнього рівня. Об’єднайте їх в один файл або перейменуйте один з них.
  • Перейменований елемент імпортовано як новий. Текст не мав ідентифікаторів елементів, а елемент було водночас перейменовано й переміщено (або змінено і його вид, і назву). Експортуйте з Включити ідентифікатори елементів, внесіть зміну й імпортуйте знову.
  • Після імпорту бракує елементів. Член, який не вдається розібрати, пропускається: "Цей член не вдається розібрати, його пропущено." Виправте рядок, названий у списку проблем, потім імпортуйте знову.
  • Імпорт JSON відхилено. Імпортуйте один файл SysML v2 JSON за раз, без файлів .sysml.

Як це пов’язано з іншими функціями

  • Редактор: імпортовані пакети відкриваються там; експортовані файли — це текст, який ви там бачите.
  • Відміна й Кошик: одне натискання “Відмінити” повертає назад увесь імпорт у цей проєкт; елементи, які він вилучає або замінює, потрапляють до Кошика.
  • Керування змінами: значення й документація, змінені через імпорт, позначають зв’язки вимог для рецензування, як і будь-яка інша зміна.
  • Файли проєктів Holarch: Експортувати цей проєкт… на сторінці Керування проєктами зберігає весь проєкт Holarch з ризиками, документами та іншими даними Holarch. .sysml і JSON містять лише модель.
  • Перетворення: щоб перенести модель між LML і SysML v2, створіть перетворену копію (див. Перетворення між LML і SysML v2).

Сторінка “Імпорт і експорт”

Імпорт

Елемент керуванняВикористання
У цей проєктОб’єднати файли з відкритим проєктом. Недоступно тим, хто може лише переглядати проєкт; для них імпорт створює новий проєкт.
У новий проєкт SysML v2Створити новий проєкт з файлів.
Зона перетягування"Перетягніть файли сюди або клацніть, щоб їх вибрати". Приймає файли .sysml, .zip з файлами .sysml або один файл SysML v2 JSON.
Таблиця попереднього переглядуІмпортувати (прапорець), Пакет (назва й вид), Елементи (кількість), Результат (Новий, Змінено, Без змін або Конфлікт, з подробицями).
Назва проєкту(Лише новий проєкт) Назва нового проєкту, до 200 символів.
Імпортувати N пакетів / Створити проєктЗастосувати імпорт.
СкасуватиЗакрити попередній перегляд без імпорту.

Елементи поза будь-яким пакетом у тексті .sysml показано разом в одному рядку, Поза пакетами.

Коли модель змінюється, поки відкрито попередній перегляд (інша вкладка, співпрацівник або Відмінити), попередній перегляд обчислюється знову.

Експорт

Елемент керуванняВикористання
Експорт (обсяг)Уся модель або будь-який пакет за кваліфікованою назвою.
як (формат)Текст SysML v2 (.sysml; .zip для кількох пакетів) або SysML v2 JSON (.json).
Включити ідентифікатори елементів(Лише текст; за замовчуванням вимкнено) Записати ідентифікатор кожного іменованого елемента в текст як @HolarchMetadata::ElementId { id = "…"; }, щоб відредагована копія, імпортована знову, зберігала ідентифікатори при перейменуваннях і переміщеннях.
ЕкспортЗавантажити файл.

Текстовий експорт записує один файл на пакет верхнього рівня, названий за ним (Vehicles.sysml). Елементи поза пакетами потрапляють до Outside packages.sysml. Експорт JSON записує один файл, названий за проєктом або пакетом.

Репозиторій

Розділ Репозиторій пов’язує проєкт з однією гілкою репозиторію, що надає Systems Modeling API.

  • Адреса репозиторію: https-адреса API репозиторію. Holarch під’єднується лише до https-адрес на публічних хостах; адміністратори сайту можуть обмежити хости й порти.
  • Токен доступу: зберігається зашифрованим для вашого облікового запису й цього проєкту і надсилається лише на цю адресу. Його більше ніколи не показують; залиште поле порожнім, щоб зберегти збережений токен.
  • Завантажити проєкти, Проєкт і Гілка: виберіть, з чим синхронізувати. Новий проєкт репозиторію створює в репозиторії проєкт для цієї моделі.
  • Отримати…, Застосувати pull: прочитати останній коміт, переглянути відмінності й застосувати їх; одне натискання “Відмінити” повертає все назад. Holarch порівнює з комітом, синхронізованим останнім, тож може відрізнити ваші зміни від змін репозиторію.
  • Надіслати: надіслати зміни з останнього синхронізованого коміту одним комітом. "Нічого надсилати: модель збігається з останнім синхронізованим комітом." означає, що нового немає.
  • Налаштування… змінює з’єднання. Від’єднати вилучає збережений токен і стан синхронізації; модель залишається.
  • Операції з репозиторієм потребують ролі редактора. Читачі не можуть отримувати й надсилати.
  • Надсилання відхиляється для проєктів із грифами регульованих даних.

Як читаються файли

  • Файли перевіряються до того, як щось буде прочитано: їхні розміри, кількість, вкладеність і довжина тексту.
  • У zip приховані файли й теки __MACOSX ігноруються. Посилання, файли, що не є .sysml, і друга копія того самого шляху пропускаються, а список проблем пояснює чому.
  • Текст має бути в UTF-8. Мітка порядку байтів дозволена.
  • Кожен імпортований елемент перевіряється до запису. Відхилений елемент забирає з собою свої члени; список проблем їх рахує.
  • У JSON елементи видів, які Holarch не інтерпретує, зберігаються такими, як їх імпортовано: див. Елементи, які Holarch не інтерпретує.

Елементи, які Holarch не інтерпретує

SysML v2 JSON може містити види елементів, яких Holarch не моделює, як-от поведінки, кроки чи взаємодії KerML. Holarch зберігає їх, а не пропускає:

  • Кожен такий елемент залишається в моделі зі своїм ідентифікатором, назвою, власником і початковим JSON, включно з його зв’язками (типізації, спеціалізації та інші) і тим, чим вони володіють. Його члени зберігають його як свого власника.
  • Оглядач показує його початковий вид із міткою Не інтерпретується; наведіть на мітку, щоб побачити пояснення. Інспектор показує його вид, його ідентифікатор у файлі й те, на що вказують його зв’язки.
  • Його не можна перейменувати чи редагувати в Holarch. Змініть його в інструменті, з якого він прийшов, і імпортуйте знову. Його можна перемістити або видалити.
  • Він не має тексту SysML. Редактор не включає його й усе, чим він володіє, у текст, а примітка над текстом повідомляє, скільки елементів не показано. Редагування тексту ніколи їх не вилучає. Експорт .sysml теж їх не включає.
  • Експорт JSON записує його назад без змін. Коригується лише те, що змінилося в моделі: видалений чи доданий член, перейменований член або новий власник.
  • Попередній перегляд імпорту перелічує кожен збережений вид один раз, як примітку, наприклад 2 елементи Behavior збережено як імпортовані. Примітки не є проблемами.

Не зберігаються: безіменний кореневий простір імен, у який деякі інструменти загортають увесь експорт (його члени стають елементами верхнього рівня), і непідтримувані елементи всередині значення, які перелічено як проблеми. Елемент, JSON якого більший за 256 KB, зберігає лише свій вид та ідентифікатор.

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

ПовідомленняЗначення та виправлення
Виберіть файли .sysml, .zip з файлами .sysml або файл SysML v2 JSON.Файли не вибрано.
Файлів .sysml не знайдено. Виберіть файли .sysml, .zip з файлами .sysml або файл SysML v2 JSON.Архів або вибір не містить файлів .sysml.
Імпортуйте один файл SysML v2 JSON за раз, без файлів .sysml.Вибрано кілька файлів JSON або JSON разом з текстом.
<file> не є файлом ReqIF (…). Експортуйте його з вихідного інструмента як ReqIF 1.0 або новіший і імпортуйте знову.Файл не є XML ReqIF або містить DOCTYPE, який Holarch не читає.
<file> не містить вимог (немає елементів SPEC-OBJECT). Експортуйте специфікації з їхніми об’єктами й імпортуйте файл знову.Файл ReqIF має типи, але не має вимог.
<title> має N вимог, більше, ніж приймає один імпорт (близько M). Експортуйте специфікації як окремі файли ReqIF.Текст SysML v2 перевищив би обмеження 8 MB. Імпортуйте специфікації по одному файлу.
<file> не є текстом UTF-8. Збережіть його в UTF-8 і імпортуйте знову.Перетворіть кодування файлу.
<file> не є дійсним архівом ZIP. Створіть архів знову.Архів пошкоджено.
<file> містить зашифровані файли. Створіть архів без пароля.Архіви, захищені паролем, не читаються.
<path> стиснуто більше ніж 200:1, що типово для zip-бомби. Створіть архів знову.Архів відхилено з міркувань безпеки.
Архів використовує непідтримуваний метод стиснення. Створіть його зі стандартним стисненням ZIP.Використовуйте стандартне стиснення (deflate).
Файли KerML поки не імпортуються.Файли .kerml пропускаються.
З архіву імпортуються лише файли .sysml.Інші файли в zip пропускаються.
Посилання не імпортуються.Символьні посилання в zip пропускаються.
Архів містить цей файл двічі; імпортується перша копія.Два записи мають однаковий шлях.
<file> не є дійсним JSON. Експортуйте модель знову.Файл JSON пошкоджено.
<file> не є SysML v2 JSON (список елементів з @id і @type). Виберіть експорт SysML v2 JSON.JSON має інший формат.
Рядок N у <file> довший за 64 KB. Розбийте рядок, потім імпортуйте файл знову.Дуже довгі рядки відхиляються.
Цей член не вдається розібрати, його пропущено.Виправте рядок, названий у списку проблем.
Елемент з цим ідентифікатором міститься всередині <element> у цьому проєкті. Спершу перемістіть його на верхній рівень або імпортуйте в новий проєкт.(Конфлікт) Пакет верхнього рівня з JSON уже існує глибше в моделі.
N його ідентифікаторів елементів використовуються деінде в цьому проєкті. Імпортуйте натомість у новий проєкт.(Конфлікт) JSON повторно використовує ідентифікатори інших елементів.
Текст пакета не вдається розібрати після друку. Імпортуйте його в новий проєкт.(Конфлікт) Пакет не вдалося об’єднати.
N елементів <kind> збережено як імпортовані (не інтерпретуються): …(Примітка) Елементи видів, які Holarch не інтерпретує, зберігаються без змін. Див. Елементи, які Holarch не інтерпретує.
Елемент виду <kind> усередині значення не підтримується й пропускається.Значення (вираз) містить елемент, який Holarch не може прочитати. Решта значення зберігається як текст.
Елемент виду <kind> завеликий, щоб зберегти його повністю; зберігаються лише його вид та ідентифікатор.Його JSON більший за 256 KB.
Імпорт не застосовано: … Нічого не змінено.Імпорт не вдався; проєкт не змінено.
Модель порожня. Додайте пакет, потім експортуйте знову.Немає чого експортувати.
Пакета для експорту більше не існує. Виберіть інший.Пакет видалено, поки сторінка була відкрита.

Обмеження

ОбмеженняЗначення
Файлів на імпорт2,000
Текст .sysml на імпорт (розпакований)8 MB
Архів zip16 MB, 10,000 записів
Вкладеність тек у zip32 теки
Елементів на імпорт (текст або JSON)100,000
Файл JSON24 MB, вкладеність 64 рівні
JSON одного елемента, який Holarch не інтерпретує256 KB, вкладеність 12 рівнів
Довжина рядка64 KB
Файл ReqIF (.reqif або .reqif усередині .reqifz)64 MB; текст SysML v2, який з нього утворюється, має вкладатися в обмеження тексту 8 MB (приблизно від 8,000 до 20,000 вимог)
  • Відповіді репозиторію обмежено 64 MB на весь pull, і кожна операція з репозиторієм зупиняється через 120 секунд.
  • Кожен обліковий запис може виконати не більше 300 операцій з репозиторієм на годину.
  • Файли KerML (.kerml) поки не імпортуються.
  • У хмарному застосунку сервер читає імпорти до 1.5 MB тексту .sysml. Більші імпорти читаються у вашому браузері з тим самим результатом.
  • Дані Holarch поруч із моделлю (статус вимог, ризики, бюджети, налаштування симулятора, розміщення подань) не входять до файлів .sysml чи JSON. Щоб їх зберегти, використовуйте Експортувати цей проєкт… на сторінці Керування проєктами.

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