Импорт конфигурации используется для загрузки настроенных объектов из другого экземпляра системы "Первая Форма".
|
|---|
|
|---|
Окно импорта
Порядок действий:
1. Нажмите кнопку Выбрать файл миграции. Выберите файл (архив) с данными для импорта.
2. При необходимости включите опции дополнительные опции:
Название |
Описание |
|
|---|---|---|
Нужна денормализация переносимых категорий |
Выполнение денормализации категорий, которые участвуют в импорте
|
|
Загружать все резолюции |
По умолчанию при переносе категории вместе с ней не импортируются резолюции, которые используются в подписях на переходах. Настройка позволяет опционально импортировать резолюции подписей вместе с отмеченными категориями |
|
Импортировать как новые сущности |
Если настройка активна, все объекты будут создаваться на базе-приемнике с новым GUID и новым ID. В качестве ID создавшего версию пользователя будет указан ID служебной учетной записи Робот 1Ф (Systemrobot). Используется при переносе сущностей при развертывании новой системы с разными базами. Исключения: •Системные статусы: Новая, Выполняется, Завершена, Отклонена — не создается дубликат •Группы Administrators, Исключить из чатов, Включить в чаты — проверяется по ID в общих настройках приложения |
|
importWithoutKeepIdentity (Импортировать без сохранения идентификаторов) |
Если настройка активна, сущности сопоставляются по GUID. Существующие на площадке-приёмнике объекты обновляются с сохранением их ID. Новые объекты вставляются с ID, назначенным генератором площадки-приёмника (без IDENTITY_INSERT). После импорта выполняется замена идентификаторов в смарт-выражениях и ремап ссылок в JSON-полях порталов. Используется для переноса обновлённой конфигурации на площадку с расходящимися ID (типичный сценарий: dev → prod). Взаимоисключающий с опцией Импортировать как новые сущности — нельзя включить обе одновременно. Доступна только через CLI (ключ -iowki) и WinForms-утилиту; в веб-интерфейсе (SPA) не поддерживается |
В режимах «Импортировать как новые сущности» и «Импортировать без сохранения идентификаторов» утилита после импорта автоматически обновляет внутренние ID-ссылки в JSON-полях конфигурационных сущностей. Это важно для порталов и виджетов: в шаблонах порталов пересчитываются ссылки на блоки в TemplateJson, Dashboard, Mesh, а также связанные PortalId/BlockId в TypeParams блоков. Благодаря этому после переноса портал продолжает корректно открываться и отображать виджеты..
3. После выбора файла миграции становится доступна кнопка Проверить — нажатие на нее запускает проверку переносимых сущностей и выдает результат с информацией о переносимых сущностях. В таблице представлены следующие колонки:
•Название — название переносимой сущности. Большинство переносимых объектов не имеют отдельного названия с переводом.
•Таблица — наименование таблицы БД, в которую переносится сущность.
•GUID — GUID переносимого объекта.
•Статус — статус переноса.
Опция Показать только изменяемые скрывает записи в статусе "Без изменений".
Пример проверки файла миграции
Таблица со списком переносимых сущностей поддерживает фильтрацию и сортировку.
В процессе анализа переносимых сущностей им может быть присвоен один из четырех статусов:
•Добавить — объект отсутствует в источнике и будет добавлен.
•Обновить — объект присутствует в источнике, но будет обновлен.
•Конфликт — объект с данным идентификатором уже присутствует и приемнике, загрузка невозможна.
•Без изменений — объект в приемнике и источнике идентичный, и останется без изменений.
Нажмите кнопку Импортировать. Импорт осуществляется с сохранением Id.
В процессе импорта утилита просматривает список зависимых сущностей, которые не были включены в экспорт, но на которые ссылается какая-либо из импортируемых сущностей. При этом целевая база проверяется на наличие в ней перечисленных зависимых сущностей. Сопоставление выполняется не только по ID, но и по GIUD — если ID разные, а GUID одинаковый, сущности будут сопоставлены корректно. Если какие-то зависимые сущности не найдены, выдается сообщение об ошибке. Пока такие ошибки обнаруживаются, процесс импорта не начинается.
|
|---|
Полезные ссылки
