Экспорт и импорт шаблонов проектов
В релизе 3.15.1.50 JSON используется как приоритетный формат шаблонов проектов. Поддерживаются экспорт и импорт JSON-шаблонов, включая «Снежинку», а также загрузка шаблонов из DCC. Загрузка шаблонов в формате xml также поддерживается.
Экспорт шаблона проекта
Экспорт шаблона проекта из Экстрактора 1С можно осуществить двумя способами:
Способ 1 — из окна проекта;
Способ 2 — из списка проектов.
Экспорт. Способ 1
Для экспорта шаблона проекта из окна проекта выберите нужный проект и откройте его. Затем нажмите кнопку «Еще», выберите «Шаблоны» — «Создать шаблон…».
Выберите папку, укажите имя файла. Нажмите «Сохранить». Начиная с версии Экстрактора 3.15.1.50 шаблон по умолчанию сохраняется в формате JSON, в предыдущих версиях формат XML. Рекомендуем использовать формат файла по умолчанию, при этом поддерживается обратная совместимость.
Экстрактор 1С подтвердит успешное сохранение файла шаблона проекта.
Экспорт. Способ 2
Для экспорта шаблона проекта из списка проектов нажмите кнопку «Еще» в правом верхнем углу интерфейса, выберите «Шаблоны» — «Создать шаблон…».
В открывшемся окне выберите проект, который необходимо выгрузить.
Выберите папку, укажите имя файла. Нажмите «Сохранить». Начиная с версии Экстрактора 3.15.1.50 шаблон по умолчанию сохраняется в формате JSON, в предыдущих версиях формат XML. Рекомендуем использовать формат файла по умолчанию, при этом поддерживается обратная совместимость.
Экстрактор 1С подтвердит успешное сохранение файла шаблона проекта.
Импорт шаблона проекта
Импорт шаблона проекта в Экстрактора 1С можно осуществить двумя способами:
Способ 1 — в список проектов;
Способ 2 — в новый пустой проект.
Импорт. Способ 1
Для импорта шаблона проекта в список проектов нажмите кнопку «Шаблоны», а затем — «Загрузить шаблон…»
и выберите нужный файл шаблона проекта на Вашем компьютере. Начиная с версии Экстрактора 3.15.1.50 шаблон по умолчанию используется в формате JSON, в предыдущих версиях формат XML. Поддерживается обратная совместимость, таким образом шаблон, выгруженный на версии до 3.15.1.50 в формате XML может быть загружен на более новую версию.
Затем, в открывшемся окне, выберите подключение, а также укажите пересоздать таблицы или нет.
Экстрактор 1С подтвердит успешную загрузку файла шаблона.
В случае, если Вы на предыдущем этапе нажали «Да», то в сообщении об успешной загрузке файла шаблона это тоже будет указано.
Импорт. Способ 2
Для импорта шаблона проекта в новый пустой проект сначала необходимо создать новый проект. Нажмите кнопку «Создать новый элемент списка (Ins)».
Нажмите кнопку «Еще» в правом верхнем углу окна создания проекта, затем выберите «Шаблоны» — «Загрузить шаблон…».
Выберите нужный файл шаблона проекта на Вашем компьютере. Начиная с версии Экстрактора 3.15.1.50 шаблон по умолчанию используется в формате JSON, в предыдущих версиях формат XML. Поддерживается обратная совместимость, таким образом шаблон, выгруженный на версии до 3.15.1.50 в формате XML может быть загружен на более новую версию.
Затем, в открывшемся окне, выберите подключение, после чего выберите создавать или нет таблицу.
И в случае, если Вы выберите вариант «Да», Экстрактор создаст таблицу и проинформирует об этом с помощью диалогового окна.
Экспорт шаблона «Снежинки»
Экспорт и импорт шаблона «Снежинки» доступен в версиях выше 3.6.1.34.
Для экспорта шаблона «Снежинки» из Экстрактора 1С выберите нужную «Снежинку» и откройте ее.
Затем нажмите кнопку «Еще», выберите «Шаблоны» — «Создать шаблон…».
Выберите папку, в которой будет сохранен шаблон “Снежинки“ и нажмите “Сохранить“.
Экстрактор 1С подтвердит успешное сохранение файла шаблона проекта.
Импорт шаблона «Снежинки»
Для импорта шаблона «Снежинки» в Экстрактор 1С сначала создайте «Схему данных» согласно инструкции, затем создайте новую «Снежинку» согласно инструкции.
После чего, откройте только что созданную «Снежинку», нажмите кнопку «Еще», выберите «Шаблоны» — «Загрузить шаблон…».
Выберите шаблон «Снежинки», который необходимо загрузить и нажмите «Открыть».
Шаблон «Снежинки» успешно загружен.
Какие настройки переносятся
Шаблон сохраняет настройки соответствия полей, включая значение по умолчанию, флаг его использования и ограничение типа источника. Вместе с ними переносятся Nullable, значение при ошибке и флаг его использования, параметры экранирования, комментарии и признаки сегментов. Эти настройки важны при переносе проекта: одинаковые имена полей сами по себе не обеспечивают одинаковый результат выгрузки.
После загрузки XML- или JSON-шаблона откройте соответствие полей и сравните его с исходным проектом. Особое внимание уделите значениям дат, чисел и строк, ограничениям составных типов и признакам сегментов инициализации. Затем проверьте обработчики и выполните пробную выгрузку.
При переносе старого шаблона в другую конфигурацию проверьте наличие объектов, реквизитов и значений перечислений в целевой базе. Загрузка шаблона не создаёт отсутствующие объекты конфигурации 1С. Если нет необходимости менять структуру приёмника, выбирайте загрузку без пересоздания таблиц.
Загрузка из DCC
Обратная совместимость интеграции с DCC по API v1 проверялась на Экстракторе 3.12.1.122 после доработки DCC до API v2. Само обновление DCC не означает автоматического перехода существующего коннектора на v2: используйте версию API, поддерживаемую установленным Экстрактором.
После команды load_template проверьте результат в целевой базе: наличие проекта, подключение, соответствие полей и таблицы приёмника. Проверьте расписание и пользователя, от имени которого оно выполняется; при необходимости задайте их в целевой базе. Исправление переноса расписания и пользователя пока не подтверждено.
Если DCC вернул ошибку, а проект уже появился, сначала проверьте его состояние и историю обмена. Повторная команда создания может привести к дублированию проекта. Если один запрос создаёт проекты при каждом цикле обмена, остановите повторную отправку команды и передайте в поддержку идентификатор задания, ответ DCC и шаблон проекта.