← На главную

При настройке обмена данными между конфигурациями Управление компанией (УК) и Бухгалтерия предприятия (БП) часто возникает необходимость расширить состав передаваемых объектов. Добавление нового типа документа — это комплексная задача, которая требует не только регистрации изменений в плане обмена, но и корректной настройки правил конвертации объектов (ПКО). Рассмотрим по шагам, как выполнить эту задачу правильно.

Этап 1: Подготовка конфигурации и регистрация изменений

Первым делом необходимо сообщить системе о том, что новый документ теперь является полноправным участником обмена. Для этого:

1. Откройте конфигуратор и в объекте ПланОбмена, используемом для связи УК и БП, добавьте ваш новый тип документа в состав.
2. Убедитесь, что для данного документа настроены ПодпискиНаСобытия, которые будут автоматически регистрировать изменения документа в плане обмена при его записи.
3. Проверьте, что в обработке РегистрацияИзмененийДляОбменаДанными объект отображается корректно и для него создаются записи при изменении данных.

Этап 2: Работа с правилами конвертации (КД 2.0)

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

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

1. Выгрузите текущие правила из регистра сведений ПравилаДляОбменаДанными в файл XML.
2. Загрузите этот файл в конфигурацию Конвертация данных.
3. Добавьте новое ПравилоКонвертацииОбъекта (ПКО) для вашего документа.
4. Настройте ПравилаВыгрузкиДанных (ПВД) для того, чтобы ваш документ попал в выгрузку.
5. Выгрузите обновленный XML-файл.

Этап 3: Актуализация правил в базе данных

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

Чтобы изменения вступили в силу, выполните следующие действия:

1. В форме обмена данными перейдите в раздел настройки правил.
2. Выберите режим Загрузить из файла и укажите ваш обновленный XML-файл.
3. После успешной загрузки вы можете переключиться обратно на загрузку из макета, если это требуется стандартом вашей разработки, однако именно принудительная загрузка «проталкивает» изменения в регистр сведений.

Этап 4: Разбор особенностей взаимодействия УК и БП

В процессе обмена между УК и БП (особенно если это разные версии платформ) важно понимать, кто является «ведущей» стороной. Рассмотрим особенности:

• Зеркальность правил: Обычно в системе существуют два набора правил: ExchangeRules (для исходящих данных) и CorrespondentExchangeRules (для входящих данных). В ряде случаев БП может выступать «пассивным» участником, принимая правила, которые приходят внутри файла сообщения от УК.
• Анализ сообщения обмена: Если вы подозреваете, что правила не применяются, вы можете открыть XML-сообщение обмена (если оно сохраняется в файл) и посмотреть структуру внутри. Часто правила конвертации инкапсулированы внутри самого сообщения, и система будет использовать их при загрузке.
• Различия в версиях: Если ваша БП работает на обычных формах, а УК — на управляемых, обмен может быть настроен так, что БП практически не хранит локальные правила, а полностью полагается на те, что прислала УК. В такой ситуации все правки вносите исключительно в правила на стороне УК.

Рекомендации по отладке

Если после всех манипуляций документ по-прежнему не выгружается, проанализируйте следующие моменты:

• Проверьте, не стоит ли в ПВД (правилах выгрузки данных) ограничение, которое исключает ваш документ из выгрузки (например, УсловиеВыгрузки).
• Убедитесь, что в регистре сведений ПравилаДляОбменаДанными действительно записана ваша новая версия правил для обоих направлений обмена (УК->БП и БП->УК, если обмен двусторонний).
• Используйте обработку РегистрацияИзмененийДляОбменаДанными, чтобы убедиться, что документ вообще «видит» план обмена и готов к отправке. Если в этой обработке нет записей для вашего документа, значит, подписка на события работает некорректно.

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