null

Для повышения гибкости конфигурации в области механизмов получения данных, которая часто подвергается изменениям, реализован механизм «Модули получения данных». На низком уровне он построен на основе «Дополнительных обработок» из библиотеки стандартных подсистем 1С. Модули предоставляют стандартный API, что упрощает их интеграцию и использование в конфигурации программного продукта.

Ниже описана последовательность настройки механизма:

  1. Создайте обработку для получения данных (например, используя сторонние web-сервисы).
  2. Добавьте созданную внешнюю обработку в список «Дополнительных обработок». Перейдите в раздел «Администрирование/ Печатные формы, отчёты и обработки».  
    Откройте ссылку «Дополнительные отчёты и обработки» для дальнейшей настройки.

    Ссылка «Дополнительные отчеты и обработки» по умолчанию не активна. Необходимо поставить галочку в поле «Дополнительные отчеты и обработки», чтобы ссылка стала активна.

    Отобразиться окно «Дополнительная обработка».

     
    Примечание — при добавлении следует особое внимание обратить на режим работы: если предполагается работать с внешними ресурсами, то режим должен быть «Не безопасный».

Добавьте обработку в качестве «Модуля получения данных». Перейдите в раздел через меню «Главное/ Настройки/ Модули получения данных», создайте модуль.

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

  • «Обработчик получения данных» — вызывается при обработке очереди получения данных. Отвечает за выполнение операций, связанных с извлечением данных в рамках заданной очереди.
  • «Обработчик получения параметров при постановке в очередь» — формирует коллекцию параметров, на основе которых строится очередь получения данных. Коллекция должна содержать как минимум один параметр, чтобы очередь могла включать хотя бы один элемент. Параметры могут представлять любые сущности, не зависящие от пользователя, например, список организаций, для которых требуется получить данные, или список видов спорта, по которым формируется перечень действующих тренеров.
  • «Обработчик получения списка полей таблицы» — отвечает за формирование списка типизированных полей, составляющих результирующую таблицу данных. В контексте запроса эти поля соответствуют полям запроса. Они используются для сопоставления полей источника и полей приёмника в документе «Установка правил выгрузки».
  • «Обработчик получения списка параметров пользователя» — формирует список параметров, которые пользователь должен указать для корректного получения данных. Обеспечивает настройку параметров, необходимых для выполнения запроса.

Настройте правило выгрузки с использованием нового «Модуля получения данных». Для этого в поле  «Вид запроса» выберите «Произвольный код». На вкладке «Данные модуля» выберите значение в поле «Модуль получения данных».

После выбора значения в поле «Модуль получения данных» автоматически будет заполнен список доступных значений в поле «Идентификатор группы обработчиков». Это строки табличной части модуля для упрощенной настройки кода вызова обработчиков.

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

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

Код может быть произвольным. Контекст вызова каждого обработчика можно посмотреть в «Подсказке», нажав на символ «?» в форме.

Настройте состав выгрузки для правила. Подробнее о настройке в разделе «Настройка состава выгрузки данных».

Ниже описан алгоритм получения данных с использованием механизма «Модули получения данных».

Предположим, что настроен «Набор источников», включающий шесть «Источников». В данном контексте «Источник» представляет собой абстрактную сущность, используемую для разделения данных на порции в очереди. Также настроены «Правила получения данных» для работы с образовательными учреждениями через механизм «Модули получения данных».

  1. При формировании очереди вызывается обработчик «Перед постановкой в очередь» из состава выгрузки (в данном обработчике пусть получается список Идентификаторов образовательных учреждений, к примеру, список состоит из 1200 образовательных учреждений). Список из 1200 образовательных учреждений делится на 6 «Источников» и записывается очередь в разрезе Источников.
  2. При получении данных из очереди для каждого источника вызывается «Обработчик получения данных» из «Установки правила выгрузки данных» в контексте 200 образовательных учреждений из очереди, данные формализуются в виде таблицы значений и отдаются механизму сопоставления полей и записи в «Хранилище данных (DWH)».
Связи контента