1С КД3: как загрузить правила обмена

Конвертация данных 3 (КД3) — технология обмена 1С, при которой правила представляют собой набор XML-файлов: правила конвертации конфигурации-источника, конфигурации-приемника и общий модуль с обработчиками. В отличие от КД2, где правила хранились в одном файле, в КД3 структура разделена, и это часто вызывает вопросы при загрузке.

Загрузить правила может понадобиться в двух разных ситуациях: при разработке — в саму конфигурацию «Конвертация данных 3» для редактирования, и в прикладное решение — чтобы типовой обмен (например, между УТ и БП) начал работать по вашим правилам. Порядок действий в этих случаях различается, и путать их нельзя.

Ниже разобраны оба сценария: от подготовки файлов до проверки результата, с типичными ошибками и способами их диагностики.

Что нужно подготовить перед загрузкой правил

Для работы с КД3 потребуется комплект поставки конфигурации «Конвертация данных, редакция 3», который включает саму конфигурацию, обработки и документацию. Убедитесь, что у вас есть актуальные файлы правил, полученные из конфигурации КД3 или от разработчика.

Минимальный набор файлов для полноценной загрузки:

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

Перед любыми действиями сделайте резервную копию информационной базы. Если база файловая — достаточно скопировать каталог или выгрузить базу через конфигуратор. Если клиент-серверная — выполните выгрузку в dt или средствами СУБД.

Загрузка правил в конфигурацию «Конвертация данных 3»

Этот сценарий нужен разработчику, который получил правила от коллеги или скачал типовые правила и хочет их доработать. Загрузка выполняется в режиме 1С:Предприятие в базе с конфигурацией КД3.

1. 1
   Откройте базу с конфигурацией «Конвертация данных 3» в режиме 1С:Предприятие
2. 2
   Найдите обработку загрузки правил (обычно доступна из раздела настройки или через «Все функции»)
3. 3
   Укажите путь к каталогу с файлами правил конвертации
4. 4
   Выберите конфигурацию-источник и конфигурацию-приемник, к которым относятся правила
5. 5
   Запустите загрузку и дождитесь сообщения о результате
6. 6
   Проверьте, что конвертация появилась в списке, а ПКО и ПКС заполнены

После загрузки правила появляются в справочниках конвертаций, правил конвертации объектов (ПКО), свойств (ПКС) и предопределенных данных. Если в правилах есть алгоритмы, они сохраняются как тексты обработчиков в соответствующих элементах.

Обратите внимание: загрузка заменяет существующие правила для выбранной пары конфигураций. Если вы ранее вносили ручные правки в эту же конвертацию, они будут потеряны — выгрузите их заранее.

Выгрузка правил из КД3 для переноса в прикладное решение

Чтобы правила можно было использовать в типовом обмене, их нужно выгрузить из КД3 в файлы. Для этого в конфигурации предусмотрена обработка выгрузки правил: она формирует XML-файлы конвертации и, при необходимости, текст модуля менеджера обмена.

Результатом выгрузки обычно являются два или три файла: правила конвертации в формате EnterpriseData (XDTO) и модуль с обработчиками. Именно этот комплект затем загружается в прикладные конфигурации — УТ, ERP, БП, ЗУП и другие, где обмен построен на КД3.

Регистрация правил в прикладной конфигурации

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

Загрузка через настройку синхронизации данных

Откройте раздел администрирования, перейдите к настройкам синхронизации данных и откройте настройку нужного обмена. В форме настройки обычно есть команда загрузки правил из файла — укажите XML-файл правил, полученный при выгрузке из КД3. Система проверит совместимость версий формата и конфигураций.

Загрузка через справочник правил конвертации

В некоторых конфигурациях есть отдельный справочник правил конвертации данных (найти его можно через «Все функции» или раздел синхронизации). Создайте новый элемент, укажите вид правил (конвертация), конфигурацию-источник и приемник, затем загрузите файл правил и при необходимости файл модуля обработчиков.

Подключение модуля обработчиков

Если правила используют алгоритмы на встроенном языке, одного XML-файла недостаточно — нужен модуль менеджера обмена. В типовых решениях текст модуля размещается в общем модуле менеджера обмена через универсальный формат. Это требует изменения конфигурации и снятия модуля с поддержки.

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

Перед переносом правил в рабочую базу прогоните обмен на двух тестовых копиях: выгрузите данные из источника, загрузите в приемник и сверьте несколько контрольных объектов — справочники, документы с движениями, остатки. Большинство ошибок правил видно именно на реальных данных, а не на этапе загрузки.

Проверка результата после загрузки

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

Контрольные точки

Как проверить результат

Запуск обмена

Норма

Синхронизация выполняется, ошибок загрузки правил нет

Тревожный признак

Ошибка «правила не найдены» или несовместимость версий

Протокол обмена

Норма

Объекты выгружены и загружены, предупреждения единичны

Тревожный признак

Массовые ошибки ПКО, незаполненные обязательные свойства

Данные в приемнике

Норма

Документы и справочники перенесены корректно, ссылки не битые

Тревожный признак

Пустые реквизиты, дубли элементов, потерянные движения

Если используется сопоставление объектов, проверьте статистику сопоставления после первой загрузки: большое количество несопоставленных дублей обычно говорит о проблемах в правилах поиска (поля поиска в ПКО).

Типичные ошибки при загрузке правил

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

Частые вопросы

Чем загрузка правил в КД3 отличается от загрузки в КД2?

В КД2 правила — один XML-файл, который загружается целиком. В КД3 правила разделены по направлениям (источник и приемник), а обработчики выносятся в отдельный модуль, поэтому загружать нужно комплект файлов, а не один документ.

Можно ли загрузить правила без изменения конфигурации?

Да, если правила не используют алгоритмы или конфигурация поддерживает подключение внешних обработчиков. Если обработчики нужны, а внешнее подключение не предусмотрено, потребуется доработка общего модуля менеджера обмена.

Где найти типовые правила для своей пары конфигураций?

Типовые правила поставляются вместе с конфигурацией «Конвертация данных 3» и в составе обновлений прикладных решений. Их можно выгрузить из свежего релиза КД3 и использовать как основу для доработки.

Что делать, если при обмене ошибка «ПКО не найдено»?

Проверьте, что загружены правила для обоих направлений и что имя объекта в правилах совпадает с именем в конфигурации. Часто причина — загрузка правил от другого релиза, где объект был переименован или удален.

Как сохранить свои правки правил при обновлении конфигурации?

Храните выгруженные файлы правил и текст модуля обработчиков в отдельном каталоге или системе контроля версий. После обновления конфигурации проверяйте, не заменились ли правила типовыми, и при необходимости загружайте свои заново.

Можно ли править правила прямо в прикладной базе?

Нет, прикладная конфигурация хранит правила как данные, но не предоставляет инструментов их редактирования. Разработка и изменение правил ведется только в конфигурации «Конвертация данных 3», после чего правила выгружаются и загружаются в рабочие базы.