Імпорт і експорт
Формати імпорту й експорту
Переносьте специфікації, електронні таблиці, файли обміну вимогами та моделі в проєкт Holarch і виводьте модель як документи, таблиці, зображення, файли обміну й повні файли проєктів. На цій сторінці перелічено всі формати, напрямок кожного, що він переносить і його відомі обмеження.
Як працюють імпорт і експорт
- Експорт доступний кожному учаснику проєкту, зокрема читачам. Імпорт потребує ролі «Власник» або «Редактор», бо він змінює проєкт.
- Імпорт зі сторінки «Імпорт і експорт» показує попередній перегляд, надає імпортованим елементам нові ID і становить один крок відміни. Щоб оновити наявні елементи замість додавання нових, зіставте їх за ID, назвою або номером.
- Імпортований вміст очищується: форматований текст втрачає скрипти й небезпечні посилання, SVG-зображення втрачають скрипти й зовнішні посилання, а XML з оголошеннями DOCTYPE або ENTITY відхиляється.
- Експорт CSV знешкоджує текст, який електронна таблиця виконала б як формулу. Назви файлів очищуються для будь-якої операційної системи.
- Кожен проєкт — це проєкт LML або проєкт SysML v2. Імпорт Word, електронних таблиць, тексту й ReqIF призначений для проєктів LML. Проєкти SysML v2 імпортують текст і JSON SysML v2, а також моделі SysML 1.x як XMI або .mdzip із перетворенням на SysML v2. Проєкти LML теж імпортують XMI. Файли проєктів, а також експорт Word, Excel і CSV зі спільних сторінок працюють в обох.
Перейти до: Вимоги та специфікації · Моделі · Електронні таблиці й таблиці · Документи та звіти · Зображення · Файли проєкту · API і MCP
Вимоги та специфікації
| Формат | Напрямок | Що охоплює | Відомі обмеження |
|---|---|---|---|
| Word (.docx) | Імпорт | Специфікація стає нумерованим документом. Заголовки стають елементами Statement, вкладеними за рівнем; абзаци зі словами «shall», «must», «will» або «should» і пункти нумерованих списків стають елементами Requirement. Таблиці стають одним елементом на рядок або залишаються таблицями в описі. Жирний шрифт, курсив, списки й зображення зберігаються, вставлені відстежувані зміни зчитуються, а вихідний файл прикріплюється. | Зображення у форматах EMF, WMF та інших, окрім PNG, JPEG, GIF, WebP і SVG, пропускаються. Видалений відстежуваний текст не імпортується. |
| Звичайний текст (.txt або вставлений) | Імпорт | Нумеровані рядки й речення зі «shall» стають нумерованим документом з елементів Statement і Requirement. Нумерація структури визначається автоматично або вибирається: десяткова, римська, літерна, змішані рівні, стиль DoD або власний шаблон. | Структура визначається лише нумерацією та формулюваннями. |
| ReqIF (.reqif, .reqifz) | Імпорт і експорт | Імпорт: кожен SPEC-OBJECT стає елементом з ієрархією специфікації, своїм типом як класом і атрибутами типів string, XHTML, Boolean, date, enumeration, integer та real. SPEC-RELATION стають зв’язками; satisfy, verify і deriveReqt стають satisfies, verifies і traced from; trace і refine стають traced to. Експорт із бази даних або документа: один тип на клас із номером, назвою, описом і всіма атрибутами, зв’язки як SPEC-RELATION, а декомпозиція як ієрархія. | Типи відношень без відповідника стають traced to; зв’язки, яких не дозволяє схема, пропускаються з попередженням. |
Моделі
| Формат | Напрямок | Що охоплює | Відомі обмеження |
|---|---|---|---|
| UML і SysML 1.x XMI (.xmi, .uml, .xml, .mdzip) | Імпорт і експорт | Імпорт: XMI 2.x з UML 2.5 і профілем SysML від 1.3 до 1.7, а також архіви проєктів .mdzip. Вимоги з їхніми id і текстом, блоки, частини, порти, властивості-значення, типи значень з одиницями, узагальнення, з’єднувачі й потоки елементів, діяльності з їхнім потоком керування, автомати станів з паралельними станами та переходами choice, junction, fork і join, діаграми послідовності, тестові випадки, пакети, стереотипи й теговані значення. Satisfy, verify, deriveReqt, refine, trace, copy та allocate стають зв’язками Holarch. Діаграми блоків, внутрішніх блоків, автоматів станів і дій будуються з імпортованої моделі. Експорт: SysML 1.6 XMI (XMI 2.5.1) для Cameo/MagicDraw, Enterprise Architect і Rhapsody або Papyrus (Eclipse UML, .uml) для Papyrus, з вимогами, блоками, частинами, портами, типами значень з одиницями, блоками обмежень, з’єднувачами з потоками елементів, діяльностями, варіантами використання, тестовими випадками, автоматами станів і зв’язками трасування. Імпортовані елементи зберігають свої XMI id, а експорт записує їх назад, тож імпорт пізнішої версії тієї самої моделі оновлює елементи замість додавання копій. Якщо ввімкнено атрибути й мітки Holarch, файл імпортується назад у Holarch без втрат. | Розкладки діаграм і операції не імпортуються; у перегляді перелічено, що пропущено. Потік діяльності будується лише тоді, коли він добре структурований. Артефакти, завдання, ризики, проблеми, рішення, елементи часу й вартості не експортуються. |
| Вихідний код Java (.java) | Імпорт | На діаграмі класів: класи, інтерфейси й переліки стають елементами Asset, поля — Characteristic, а методи — Action з параметрами й результатами як Input/Output. | Один файл або вставлений код за раз. |
| Текст SysML v2 (.sysml або .zip з файлами .sysml) | Імпорт і експорт | Імпорт у проєкт SysML v2 або в новий проєкт з попереднім переглядом для кожного пакета: новий, змінений, незмінний або конфлікт. Папки в zip стають пакетами. Експортуйте всю модель або один пакет; кілька пакетів завантажуються як zip. | Текст не містить id елементів, тому повторний імпорт зіставляє елементи за назвою. Файли KerML (.kerml) не імпортуються. До 2,000 файлів, 8 MB тексту та zip до 16 MB за один імпорт; текст має бути в UTF-8. |
| SysML v2 JSON (.json) | Імпорт і експорт | Плаский список елементів з @id і @type, який використовує Systems Modeling API. Id елементів зберігаються, тож повторний імпорт зіставляє за id. | До 24 MB і 100,000 елементів. Види елементів, які Holarch не інтерпретує, зберігаються як імпортовані, позначаються «Не інтерпретується» й записуються назад без змін. |
| Репозиторій моделей SysML v2 | Отримання й надсилання | Під’єднайте проєкт SysML v2 до однієї гілки репозиторію, що надає Systems Modeling API. Отримайте останній коміт і перегляньте кожну відмінність перед застосуванням; надішліть свої зміни одним комітом. | Лише адреси https на публічних хостах. Надсилання відхиляється, поки в гілці є неотримані коміти. 64 MB за одне отримання, 120 секунд на операцію та 300 операцій на обліковий запис за годину. Потрібна роль «Редактор». |
| Systems Modeling API в Holarch | Читання й коміти з інших інструментів | Інші інструменти SysML v2 читають елементи проєкту SysML v2 як SysML v2 JSON через REST за допомогою персонального токена доступу й комітять зміни в гілки запитів на зміну. | main доступна лише для читання; коміти потрапляють у запити на зміну, які затверджувач застосовує в Holarch. Лише вершини гілок; без тегів, об’єднань і збережених запитів. |
| SysML v1 у SysML v2 (.xmi, .uml, .xml, .mdzip) | Імпорт | Модель SysML 1.x з Cameo чи MagicDraw, Enterprise Architect, Rhapsody або Papyrus перетворюється на текст SysML v2, перевіряється й імпортується в проєкт SysML v2 або в новий проєкт одним кроком відміни. Звіт про перетворення перелічує кожен елемент як перетворений, наближений або пропущений із причиною й завантажується як CSV. | Діаграми та їхні розкладки не перетворюються. Зв’язки з безіменними елементами пропускаються. |
| LML у SysML v2 і назад | Перетворена копія, в обидва боки | Новий проєкт іншою мовою: елементи Asset, порти, Conduit, Input/Output, вимоги, зв’язки satisfy, тестові випадки, елементи Action з їхнім потоком, стани й рівняння. Ризики, рішення, завдання, документи, дошки, статус вимог і результати тестів переносяться разом. Звіт перелічує, що перетворено, а що ні, і завантажується як CSV. | Розкладки діаграм, історія, базові лінії та запити на зміну не перетворюються. Елементи, для яких в одній мові немає місця, як-от Measure і Resource у LML або обчислення й випадки аналізу в SysML v2, перелічуються у звіті. |
Дані Holarch поруч із моделлю SysML v2, як-от статус вимог, ризики, бюджети й розкладки подань, не входять до файлів .sysml чи SysML v2 JSON. Експорт проєкту їх зберігає.
Електронні таблиці й таблиці
| Формат | Напрямок | Що охоплює | Відомі обмеження |
|---|---|---|---|
| Excel (.xlsx, .xlsm) і CSV | Імпорт | Нові або оновлені елементи будь-якого класу з відповідністю стовпців, запропонованою за заголовками. Атрибути, мітки, зв’язки, ієрархія зі стовпця батьківського елемента або з номерів, а також нові атрибути, створені з даних. Зіставте наявні елементи за ID, назвою або номером, щоб оновити їх. | Excel 97-2003 (.xls) і CSV з крапкою з комою як роздільником не зчитуються. Назви й номери обрізаються до 255 символів. |
| Excel і CSV з бази даних | Експорт | Будь-який набір елементів як таблиця з вибраними атрибутами й зв’язками, з ієрархією та зведеннями, як визначення, як матриця зв’язків, як історія змін або як коментарі. | Комірки Excel вміщують до 32,000 символів; довший текст обрізається. |
| Excel і CSV з інших сторінок | Експорт | RVTM, VCRM, RVM, RTM, RSM і TVM; результати перевірки якості вимог; реєстр TBD/TBR; реєстр інтерфейсів; матриці N² та I²; бюджети й TPM; реєстр ризиків; аналізи компромісів; таблиці функціонального аналізу; порівняння базових ліній; дані графіків; часові шкали, журнали подій і прогони симулятора. | Кожна сторінка експортує власні стовпці. |
| Матриця простежуваності (.xlsx, .csv) | Імпорт і експорт | Експортуйте будь-який зв’язок як матрицю. Відредагуйте книгу в електронній таблиці й імпортуйте її назад: попередній перегляд перелічує зв’язки для додавання, зв’язки для вилучення й пропущені комірки. | Імпорт додає й вилучає зв’язки лише між наявними елементами. Комірки, яких не дозволяє схема, пропускаються й перелічуються. |
Документи та звіти
| Формат | Напрямок | Що охоплює | Відомі обмеження |
|---|---|---|---|
| Word (.docx) | Експорт | Документи й структури зі стилями заголовків Word, грифами, титульними сторінками й номерами сторінок; порівняння з відстежуваними змінами між базовими лініями; розбивки сутностей; звіти діаграм; ICD; тестові випадки; RVTM і матриці простежуваності; підсумки аналізів компромісів; звіти функціонального аналізу; архітектурний пакет DoDAF. | Сторінки формату US Letter. |
| PowerPoint (.pptx) | Експорт | Презентації, один слайд на сторінку, з текстовими полями, фігурами й нотатками доповідача. Презентації також експортуються в HTML і Word. | Немає. |
| Markdown (.md) | Експорт | Документ як заголовки й текст Markdown. | Немає. |
| HTML | Експорт | Вебсторінки діаграм, звітів діаграм, графіків, презентацій і матриць простежуваності. | Немає. |
| Друк і PDF | Експорт | Документи, таблиці й діаграми через діалог друку браузера, який зберігає PDF. Дошки експортують PDF безпосередньо. | Сторінки PDF з дошок є зображеннями. |
Зображення
| Формат | Напрямок | Що охоплює | Відомі обмеження |
|---|---|---|---|
| PNG і SVG | Експорт | Діаграми, графіки, слайди, панелі симулятора й картки галереї. PNG у вибраному масштабі, з тлом або без нього; SVG як масштабоване векторне зображення. | Немає. |
| Дошки: PNG, JPG, SVG, PDF | Експорт | Аркуш, виділення, поточний вигляд, рамка або всі аркуші. SVG зберігає фігури й текст редагованими у векторних інструментах. | Сторінки PDF є зображеннями. |
| Зображення та прикріплені файли | Імпорт | Зображення у форматованому тексті, зображення сутностей, файлові атрибути, дошки й слайди. Графіка PNG, JPEG або SVG для продуктів DoDAF, наприклад OV-1 з активними зонами. | Зображення, довша сторона яких перевищує 4,000 px, зменшуються. Розмір файлів обмежено 10 MB на тарифі Free, 25 MB на Individual і 100 MB на Team, а розмір проєктів — 100 MB на тарифі Free. |
Файли проєкту
| Формат | Напрямок | Що охоплює | Відомі обмеження |
|---|---|---|---|
| Резервна копія Holarch (.holarch) і файл проєкту (.json) | Імпорт і експорт | Увесь проєкт для резервного копіювання або перенесення на інший сервер Holarch: елементи, зв’язки, діаграми, базові лінії, коментарі, історія й параметри головної сторінки разом із вкладеннями й зображеннями. Резервна копія .holarch містить контрольну суму для кожної частини й перевіряється перед імпортом. Імпортується як новий проєкт, власником якого ви є. Формати резервної копії і JSON задокументовано. | Завжди новий проєкт; щоб об’єднати з відкритим проєктом, скористайтеся імпортом з об’єднанням нижче. |
| Об’єднання з проєктом (.holarch, .json) | Імпорт | Резервні копії та пакети Holarch з їхніми прикріпленими файлами, а також експорти проєктів, бази даних і документів Holarch об’єднуються з відкритим проєктом. Класи, атрибути, мітки й зв’язки зіставляються за назвою, а відсутні елементи схеми можна спершу додати. Коментарі, історія й розкладки діаграм переносяться, якщо їх вибрано. | Скрипти симуляції з файлу позначаються як імпортовані, і симулятор запитує підтвердження перед їх запуском. |
| Пакет проєкту (.holarch) | Експорт | Вибрані елементи з їхніми зв’язками, діаграмами, коментарями й схемою, а також усі прикріплені файли, перевірені на пошкодження під час імпорту. | Містить вибрані елементи; базові лінії та історія не входять. |
| Схема (.json) | Імпорт і експорт | Класи, відношення, атрибути й мітки проєкту. Імпорт додає те, чого бракує проєкту, або замінює схему. | Немає. |
| Базові лінії та дані документів (.json) | Експорт; дані документів також імпортуються | Базова лінія з її датою, документом, затвердженнями й знімком. Елементи, зв’язки й стан документа, які можна об’єднати з іншим проєктом. | Немає. |
| Продукти DoDAF (JSON) і підмножина DM2 PES (XML) | Експорт | Опис архітектури, кожен продукт з його даними та словник. XML записує словник у термінах DoDAF Meta Model. | XML використовує власний простір імен Holarch і не перевіряється за схемою DM2 PES. |
| Розклад MS Project (.xml) | Експорт | Рядки діаграми Ганта з прогону симуляції як розклад MS Project XML. | Лише з прогонів симулятора. |
API і MCP
Скрипти читають і змінюють проєкти через REST API з персональним токеном доступу й описом OpenAPI. Інструменти ШІ, як-от Claude, під’єднуються через Model Context Protocol (MCP); їхні зміни надходять як пропозиції, які ви переглядаєте до застосування. Див. API і MCP.