← На главную
При организации обмена через универсальный формат EnterpriseData с использованием технологии «Конвертация данных 3.0» (КД 3.0) разработчики часто сталкиваются с необходимостью оперативно применить новые или измененные алгоритмы конвертации без снятия конфигурации с поддержки или изменения кода в конфигураторе. Разберем, как подключить внешний менеджер обмена непосредственно в пользовательском режиме типовых решений 1С.
Выясним причину, почему нужные поля не видны сразу: в типовых конфигурациях на базе Библиотеки стандартных подсистем (БСП), начиная с версии 2.2.3, функционал подключения внешних правил присутствует «из коробки», однако третья закладка с параметрами менеджера обмена по умолчанию скрыта разработчиками в интерфейсе формы настройки правил синхронизации.
Пошаговое включение и настройка внешних правил в пользовательском режиме
Разберем по шагам, как добраться до скрытых реквизитов и настроить использование внешнего менеджера обмена:
- Откроем раздел Администрирование (или НСИ и администрирование) и перейдем в пункт Синхронизация данных.
- В списке настроенных подключений выберем нужный узел плана обмена и перейдем к редактированию правил отправки и получения данных.
- В открывшемся окне обычно доступны только две стандартные вкладки:
Правила отправки данных и Правила получения данных. Нажмем в правом верхнем углу кнопку Еще и выберем пункт Изменить форму.
- В дереве элементов формы найдем группу или страницу, отвечающую за подключение менеджера обмена (обычно она называется
Менеджер обмена, Правила конвертации или представляет собой третью скрытую вкладку панели).
- Установим флажок видимости для данного элемента и нажмем Применить (или ОК).
- После появления третьей закладки в форме выберем режим использования правил: загрузка файла в базу данных или указание пути к файлу на сервере/диске.
Форматы правил и способы их хранения
Проанализируем доступные форматы внешних правил КД 3.0 и нюансы их размещения:
- Модуль менеджера обмена: Правила могут представлять собой текстовый файл исходного кода (
.bsl или .txt), выгруженный из конфигурации «Конвертация данных, ред. 3.0», либо zip-архив с этим модулем. Также правила могут поставляться в виде специализированной внешней обработки (.epf), в модуле объекта которой реализован требуемый API универсального формата.
- Загрузка в информационную базу против внешнего пути: Типовой функционал позволяет либо указать путь к файлу на файловой системе, либо загрузить правила непосредственно в табличную часть или регистр сведений информационной базы. Настоятельно рекомендуется выполнять загрузку файла внутрь базы, так как это гарантирует непрерывность выполнения синхронизации вне зависимости от доступности сетевых ресурсов.
Важные ограничения и типичные проблемы при эксплуатации
Рассмотрим подробнее ошибки, которые могут возникнуть при использовании динамически подключаемых правил:
- Права системной учетной записи сервера: Если выбран вариант с указанием пути к файлу на диске, регламентные и фоновые задания выполняются от имени пользователя операционной системы, под которым работает служба
ragent (сервер 1С:Предприятия). Если у системного пользователя нет прав на чтение указанного каталога или сетевой папки, обмен завершится с ошибкой доступа.
- Безопасный режим и профили безопасности: Вызов процедур динамически подключенного модуля или внешней обработки платформой 1С может интерпретироваться как выполнение небезопасного кода. При включенных профилях безопасности кластера серверов или установленном безопасном режиме вызовы могут блокироваться.
- Сложности отладки: При динамической компиляции модуля менеджера обмена из внешнего файла точки останова в конфигураторе могут не срабатывать. Для поиска ошибок и отладки алгоритмов в таком случае модуль правил переносят во внешнюю обработку и подключают через отладчик либо используют расширения конфигурации.
- Несоответствие версий EnterpriseData: Структура пакета XDTO, заложенная в правилах КД 3.0, должна строго соответствовать версии формата, выбранной в настройках синхронизации узла плана обмена (например, 1.5, 1.6 или 1.10). Несовпадение версий приведет к ошибкам валидации XDTO-пакетов при выгрузке или загрузке.
Альтернативные способы доработки менеджера обмена
Посмотрим на более надежные альтернативы подключению внешних файлов, если требуется постоянная доработка логики обмена:
- Расширения конфигурации: Наиболее удобный и современный подход. Создается расширение, в которое добавляется типовой общий модуль
МенеджерОбменаЧерезУниверсальныйФормат (или модуль соответствующей версии формата, например, МенеджерОбменаЧерезУниверсальныйФормат1_3). С помощью аннотаций &Вместо, &После или полной замены кода модуля переопределяются правила конвертации. Этот способ полностью снимает ограничения безопасного режима, не требует снятия базы с поддержки и обеспечивает удобную отладку.
- Встраивание в основную конфигурацию: Снятие общего модуля менеджера обмена с поддержки и полная замена его текста кодом, сформированным в конфигурации «Конвертация данных 3.0». Способ обеспечивает максимальное быстродействие, но требует последующего контроля при обновлении типовой конфигурации.