Обработчики 1С

При получении сообщения извне (входящая точка) система запускает механизм установки типа сообщения.

  1. При получении сообщения (до выполнения кода обработчика) коннектор 1С поддерживает получение сообщения со свойствами DataType или SystemDataType:

    • Если параметр DataType заполнен, то тип сообщения устанавливается на основе заполненного.

    • Если параметр SystemDataType заполнен, то тип сообщения устанавливается в OriginalSystemDataType и SystemDataType заполняется из метаданных.

    • Если параметры DataType и SystemDataType пустые, то тип сообщения заполняется из вкладки В Platform обработчика соответствующим типом.

    • Если параметр DataType или SystemDataType заполнен, то система выполняет сравнение с типом переменной на вкладке В Platform, если тип переменной отличается от типа сообщения, и у переменной установлен флаг Обязательное, система возвращает ошибку и сообщение перемещается в архив.

  2. Инициализация переменных для выполнения кода обработчика:

    • Если коннектор поддерживает использование кода и код заполнен, то переменная создается со вкладки В Platform обработчика.

    • Если тип определен в пункте 1, и он отличается от типа переменной из вкладки В Platform, то переменная принимает значение null (если установлен параметр разрешить null) или создается пустой объект.

Для создания обработчика:

  1. В ЦН перейдите в раздел Интеграция → Обработчики.

  2. Нажмите на кнопку +. В рабочей области страницы отобразится интерфейс создания нового обработчика.

../../../_images/image107.png

Вкладка Основные

На вкладке Основные произведите следующие настройки:

  • Поле Название: введите название обработчика, обязательно для заполнения.

  • Поле Имя: введите имя обработчика, необязательно для заполнения.

  • Поле Комментарий: введите описание обработчика, необязательно для заполнения.

  • Выпадающее меню Тип: в данном случае выбран вариант Обработчик 1С.

  • Направление интеграции: выберите направления интеграции В Platform или Из Platform. В зависимости от выбранного направления изменится вкладка В Platform / Из Platform.

  • Поле Имя таблицы: введите имя таблицы обработчика, которая будет выступать как источник, если указано направление В Platform. Если указано направление ИЗ Platform, таблица выступает как приемник.

  • Выпадающее меню Внешний тип данных: выберите тип внешнего типа данных.

Обработчики В Platform вызываются на стороне 1С при добавлении/изменении записей. Из добавленных записей создается пакет и отправляется на входящую точку адаптера системы.

Также для обработчиков с направлением В Platform есть возможность установить параметр Порядок обработки.

Этот параметр отвечает за приоритетность выгрузки объектов из 1С:

../../../_images/image110.png

Возможные значения от 0 до 9, где 0 - самое приоритетное.

Обработчики Из Platform выполняются, когда в 1С из Платформы приходит пакет. Данные для выполнения обработчика берутся из тела сообщения.

Вкладка Переменные

Указываются переменные, к которым будет доступ на вкладке Код:

../../../_images/image111.png

Вкладка Код

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

Предупреждение

Пользовательские методы Подробности, Отладка, Информация, Предупреждение, Ошибка, ФатальнаяОшибка переименованы в СобытиеПодробности, СобытиеОтладка, СобытиеИнформация, СобытиеПредупреждение, СобытиеОшибка, СобытиеФатальнаяОшибка. В версии 3.0.54 старые методы могут быть использованы для поддержки совместимости. В следующей версии методы с устаревшими названиями будут удалены. При использовании этих методов в обработчиках необходимо внести изменения вручную.

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

../../../_images/image112.png

Также на вкладке присутствует режим отладки (при выборе направления Из Platform) :

../../../_images/image113.png

При необходимости режим отладки можно развернуть на весь экран.

Вкладка В Platform

Содержит данные, которые будут передаваться в Платформу при соответствующем направлении интеграции, выбранном на вкладке Основные:

../../../_images/image114.png

На этой вкладке определяется тип данных, который будет присвоен сообщению при выполнении данного обработчика.

Вкладка Из Platform

Содержит данные, которые будут передаваться из Платформы при соответствующем направлении интеграции, выбранном на вкладке Основные. На вкладках В Platform и Из Platform определяется - с каким типом данных будут обрабатываться сообщения данным обработчиком. Если из Платформы пришло сообщение с типом, указанным на данной вкладке, то этот обработчик будет выбран для этого сообщения, затем выполняется код обработчика (при наличии).

Вкладка Системы

На вкладке отображаются системы, к которым будет добавлен обработчик.

../../../_images/image115.png