Перенос схемы

Перенос схемы позволяет экспортировать определения типов сущностей из одной организации и импортировать их в другую. Переносится структура — типы сущностей, группы полей, поля и типы вложенных сущностей, — а данные записей не переносятся.

Перенос схемы полезен, когда нужно:

  • настроить новую организацию, в которой с самого начала должны быть те же типы сущностей, что и в существующей;

  • перенести конфигурацию из тестовой среды в рабочую;

  • использовать стандартный набор типов сущностей в нескольких организациях.

Что переносится

Экспорт схемы включает:

  • определения типов сущностей — название, машинное имя, описание, супертип;

  • группы полей — название, машинное имя, порядок отображения;

  • поля — название, машинное имя, тип данных, флаг обязательности, флаг уникальности, описание, настройки, зависящие от типа (точность даты, цель ссылки, текст выражения, обобщённые настройки);

  • типы вложенных сущностей, их группы полей и поля.

Экспорт схемы не включает:

  • данные записей (сами документы, записи справочников или записи контрагентов);

  • права (права на поля и на типы сущностей);

  • шаблоны, прикреплённые к типам документов или отчётов;

  • определения бизнес-процессов.

Охват супертипов

Перенос схемы охватывает шесть из восьми супертипов:

  • «Документ»

  • «Контрагент»

  • «Справочник»

  • «Задача»

  • «Отчёт»

  • «Прайс-лист»

Типы «Предложение» и «Группа сотрудников» нельзя перенести через импорт и экспорт схемы. Эти два супертипа нужно создать вручную в целевой организации.

Экспорт определений сущностей

Чтобы выполнить экспорт, откройте раздел «Сущности» и нажмите «Экспорт определений». Выберите типы сущностей, которые нужно включить, и формат файла:

XLSX

Книга Excel с одним листом на каждый тип сущности. Названия типов сущностей длиннее 31 символа обрезаются в названиях листов (ограничение Excel).

JSON

Файл JSON с полной структурой определений.

В экспорт попадают только пользовательские типы сущностей. Встроенные системные типы исключены.

Импорт определений сущностей

Чтобы выполнить импорт, откройте раздел «Сущности» и нажмите «Импорт определений». Загрузите файл экспорта (XLSX или JSON, до 10 МБ), затем выберите режим импорта.

Режимы импорта

Режим Поведение

Только создание (по умолчанию)

Создаёт типы сущностей и поля, которых ещё нет в целевой организации. Пропускает любой тип сущности, машинное имя которого уже существует, — существующие типы не меняются.

Слияние

Создаёт типы сущностей и поля, которых ещё нет. В существующие типы сущностей добавляет новые поля и обновляет существующие поля (по совпадению машинного имени), но никогда не удаляет поля, которые есть в целевой организации, но отсутствуют в файле импорта.

Замена

Полностью заменяет существующие типы сущностей импортируемыми определениями. Поля и типы вложенных сущностей, которые есть в целевой организации, но отсутствуют в файле импорта, удаляются. Новые поля добавляются, существующие поля обновляются.
Режим замены удаляет поля и типы вложенных сущностей, которых нет в файле импорта. Если файл экспорта устарел или неполон, это может удалить поля, которые в целевой организации активно используются. Перед подтверждением импорта в режиме замены всегда проверяйте результаты пробного прогона.

Пробная проверка

Перед применением изменений импорт выполняет пробную проверку. Пробный прогон разбирает загруженный файл, проверяет машинное имя каждого типа сущности и каждого поля и возвращает подробное сравнение, которое показывает, что произойдёт с каждым типом сущности и каждым полем:

  • Создано — будет добавлен новый тип сущности или поле.

  • Обновлено — существующее поле будет изменено.

  • Удалено — поле или тип вложенной сущности будет убран (только в режиме замены).

  • Без изменений — определение совпадает с уже существующим.

  • Пропущено — тип сущности уже существует (режим «Только создание»).

Пробный прогон также сообщает об ошибках проверки: недопустимых машинных именах, неподдерживаемых супертипах, повреждённых файлах и файлах, превышающих ограничение размера.

Внимательно просмотрите результаты пробного прогона. Когда вы подтверждаете импорт, система применяет изменения по той же логике, что и при пробном прогоне.

Проверка машинных имён при импорте

Импортируемые машинные имена проверяются по тем же правилам, что и созданные вручную:

  • должны начинаться с буквы и содержать только буквы, цифры и знаки подчёркивания;

  • не должны совпадать с существующими машинными именами в целевой организации (кроме случая, когда режим импорта — «Слияние» или «Замена», а совпадение намеренное);

  • не должны использовать зарезервированное системное имя.

Перенос схемы и импорт данных

Перенос схемы и импорт данных — разные функции:

Параметр Перенос схемы Импорт данных

Что переносит

Определения типов сущностей (структуру)

Данные записей (строки)

Охват

Шесть из восьми супертипов

Только контрагенты, цифровые экраны и печатные конструкции

Пробный прогон

Да — подробное сравнение по полям

Нет

Формат

XLSX или JSON

Шаблон XLSX

Импорт на уровне записей описан в разделе импорт данных.