Пакеты
Пакеты (/packages) — механизм переноса готовой конфигурации между системами Orbita: пакет объединяет сущности и всё, что вокруг них построено, в один файл-бандл, который можно выгрузить, передать и установить на другой инсталляции — или обновить на ней более новой версией.
Типовые сценарии:
- перенос настроенного решения с тестовой среды на боевую;
- тиражирование одного решения на несколько инсталляций (например, у интегратора);
- версионирование: выпустили пакет v1.1.0 с новым полем и процессом — клиентские системы обновляются импортом без потери своих данных;
- готовые пресеты (Service Desk, CRM, HR, Управление проектами) — это те же пакеты, встроенные в дистрибутив.
Раздел доступен администратору и пользователям с правом раздела admin.entities («Конструктор сущностей и пакеты»).
Состав пакета
В бандл входят выбранные сущности и связанные с ними объекты:
| Секция | Что переносится |
|---|---|
| Сущности | Структура полей, формы, модели состояний, автоматизации |
| Связи | Связи между сущностями пакета |
| Роли | Роли с CRUD-правами и правилами доступа к записям |
| Дашборды | Дашборды и графики по сущностям пакета |
| Процессы | BPMN-шаблоны процессов |
| Порталы | Порталы самообслуживания с их страницами |
| Шаблоны уведомлений | Настроенные шаблоны писем/уведомлений |
| Отчёты | Определения отчётов |
| Меню | Пункты меню на сущности пакета |
Данные (сами записи) в пакет не входят — переносится конфигурация. Для переноса записей используйте вкладку Миграция в настройках или REST API.
Работа с пакетами
Создание пакета
- Откройте Пакеты → Создать пакет
- Укажите название, слаг и версию (semver, например
1.0.0) - Назначьте в пакет сущности — все связанные объекты (роли, процессы, дашборды, порталы, отчёты) подтянутся в бандл автоматически при экспорте
Сущность может состоять только в одном пакете; назначение и снятие — на странице пакета.
Экспорт
Кнопка экспорта на странице пакета выгружает JSON-бандл (формат orbita_package_bundle, версия формата 2). Файл самодостаточен: его можно хранить в git и переносить между инсталляциями.
Импорт и предпросмотр
- Пакеты → Импорт
- Выберите файл бандла — система покажет предпросмотр: состав по секциям и вердикт по версии
- Подтвердите установку
Вердикты предпросмотра:
| Ситуация | Поведение |
|---|---|
| Пакет не установлен | Обычная установка |
| Файл новее установленной версии | Обновление: «Обновление с v{from} до v{to}. Пользовательские изменения сохраняются (merge)» |
| Та же версия | Повторный импорт восстановит недостающее (repair) |
| Файл старше установленной версии | Предупреждение об откате; требуется явное подтверждение «Понимаю, всё равно откатить» |
Стратегии конфликтов
Если объект из пакета уже существует в системе, применяется выбранная стратегия:
- merge (по умолчанию) — новые поля/объекты добавляются, пользовательские доработки сохраняются;
- skip — существующие объекты не трогаются, добавляется только отсутствующее;
- replace — объекты приводятся к состоянию из пакета.
После установки показывается отчёт по деплою: что создано, что обновлено, что осталось без изменений, и предупреждения (например, о пропущенных из-за конфликтов объектах).
Встроенные пакеты
Блок Встроенные пакеты показывает пресеты из дистрибутива (Service Desk, CRM, HR и др.) с их версиями. У неустановленного пакета — кнопка Установить, у установленного, для которого в дистрибутиве есть более новая версия, — Обновить. Это тот же механизм, что и мастер первоначальной настройки: пресеты, выбранные при онбординге, отображаются здесь как установленные пакеты.
Пример: выпуск обновления решения
Интегратор сопровождает у клиента решение «Заявки на закупку» (пакет procurement v1.0.0) и должен добавить поле «Бюджетная статья» и шаг согласования финконтролёром:
- На тестовой системе интегратор дорабатывает сущность и процесс
- На странице пакета повышает версию до
1.1.0и выгружает бандл - У клиента: Пакеты → Импорт, предпросмотр показывает «Обновление с v1.0.0 до v1.1.0»
- После подтверждения новое поле и шаг процесса появляются в системе клиента; локальные доработки клиента (свои автоматизации, свои роли) сохраняются благодаря merge-стратегии
Смотрите также
- Обзор пресетов — что входит в каждый встроенный пакет
- Настройки → Миграция — перенос структуры одной сущности и импорт данных
- Первоначальная настройка — установка пресетов при первом запуске