Импорт и экспорт
Форматы импорта и экспорта
Переносите спецификации, электронные таблицы, файлы обмена требованиями и модели в проект 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) | Импорт | Спецификация становится нумерованным документом. Заголовки становятся Statements, вложенными по уровням; абзацы с «shall», «must», «will» или «should» и пункты нумерованных списков становятся Requirements. Таблицы становятся одним элементом на строку или остаются таблицами в описании. Полужирный, курсив, списки и рисунки сохраняются, вставленные исправления читаются, а исходный файл прикрепляется. | Рисунки в EMF, WMF и других форматах, кроме PNG, JPEG, GIF, WebP и SVG, пропускаются. Удалённый в режиме исправлений текст не импортируется. |
| Обычный текст (.txt или вставленный) | Импорт | Нумерованные строки и предложения с «shall» становятся нумерованным документом из Statements и Requirements. Нумерация структуры определяется автоматически или выбирается: десятичная, римская, буквенная, со смешанными уровнями, в стиле 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) | Импорт | На диаграмме классов: классы, интерфейсы и перечисления становятся Assets, поля — Characteristics, а методы — Actions с параметрами и результатами в виде Input/Outputs. | Один файл или фрагмент исходного кода за раз. |
| Текст SysML v2 (.sysml или .zip с файлами .sysml) | Импорт и экспорт | Импорт в проект SysML v2 или в новый проект с предпросмотром по каждому пакету: новый, изменён, без изменений или конфликт. Папки в zip становятся пакетами. Экспортируйте всю модель или один пакет; несколько пакетов скачиваются как zip. | Текст не содержит id элементов, поэтому повторный импорт сопоставляет элементы по имени. Файлы KerML (.kerml) не импортируются. До 2000 файлов, 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 и обратно | Преобразованная копия, в обе стороны | Новый проект на другом языке: Assets, порты, Conduits, Input/Outputs, требования, связи satisfy, тестовые случаи, Actions с их потоком, состояния и уравнения. Переносятся риски, решения, задачи, документы, доски, статус требований и результаты тестов. Отчёт перечисляет, что преобразовано, а что нет, и скачивается в CSV. | Раскладка диаграмм, история, базовые линии и запросы на изменение не преобразуются. Элементы, для которых в одном из языков нет места, например Measures и Resources в 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 с активными областями. | Рисунки больше 4000 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.