Обработчики
⚠️ Sync-черновик — страница создана автоматически. Требует ревью технического писателя перед публикацией.
В Экстракторе есть предопределённые обработчики — уже запрограммированные функции, — а также возможность создать обработчик самостоятельно. Все обработчики различаются только событиями, при возникновении которых они срабатывают. События, когда какие обработчики срабатывают, можно посмотреть на схеме:
Обработчики строки проекта
Настраиваются в окне «Настройки строки проекта». Чтобы открыть это окно, нажмите кнопку настройки строки в окне создания/редактирования проекта:
Обработчики формирования очереди для первичной/полной выгрузки данных
Отвечают за формирование очереди выгрузки при нажатии кнопки Сформировать очередь в окне проекта. Устанавливается автоматически при создании проекта конструктором.
«Инициализация очереди выгрузки по периоду»
Используется для сегментирования по одному параметру типа «Дата» (например, «Период регистра» или «Дата документа»), когда требуется разбить выгрузку по периодам (по месяцам, неделям и т.д.).
Параметры обработчика настраиваются вручную или через функцию автозаполнения:
Вид объекта – вид объекта конфигурации, к которому относится параметр сегментирования;
Имя объекта – имя объекта, как оно задано в конфигурации;
Поле даты – имя реквизита объекта, как оно задано в конфигураторе;
Имя параметра – имя параметра источника данных (параметра запроса);
Периодичность – функция сегментирования для параметра типа «Дата».
«Инициализация очереди выгрузки по периоду по остаткам»
Формирует записи в очереди даже за те дни, где не было движений. Используется, если в дни выбранной периодичности нет движений (например, в выходные при ежедневной выгрузке). Параметры аналогичны предыдущему обработчику:
«Инициализация очереди выгрузки по подстроке реквизита»
Используется для сегментирования по строковому параметру (например, «Наименование» в справочнике Номенклатуры), когда сегментирование производится по части строки (например, по первым буквам).
Параметры обработчика:
Вид объекта, Имя объекта – аналогично предыдущим;
Поле реквизита – имя реквизита объекта, как оно задано в конфигураторе;
Имя параметра – имя параметра источника данных;
Начало подстроки – начальная позиция части строки, используемой для сегментирования;
Длина подстроки – количество символов от начала подстроки.
«Инициализация очереди выгрузки по реквизиту»
Используется для сегментирования по ссылочному параметру (например, сегмент – это все записи справочника номенклатуры, относящиеся к одному Производителю).
Параметры обработчика:
Вид объекта, Имя объекта – аналогично предыдущим;
Поле реквизита – имя реквизита объекта, как оно задано в конфигураторе;
Имя параметра – имя параметра источника данных.
«Инициализация очереди выгрузки по набору данных»
Данный обработчик устанавливается по умолчанию для типа данных «Объект» и работает только для него.
Универсальный обработчик: подходит для любых комбинаций параметров сегментирования, включая множественные (когда сегмент определяется совокупностью двух и более параметров с функциями). У данного обработчика нет необходимых для настройки параметров.
Обработчики формирования очереди при изменении объектов
Отвечают за добавление в очередь выгрузки тех сегментов, по которым произошли изменения в базе данных. Изменения фиксируются подписками на события – это обеспечивает инкрементальную выгрузку.
«Регистрация изменений по периоду»
Объединяет три ранее существовавших обработчика (начиная с версии 3.8.1.53). Параметры обработчика настраиваются вручную:
Поле даты – имя реквизита объекта, как оно задано в конфигураторе;
Имя параметра – имя параметра источника данных;
Режим – «Стандартный» (изменения за период) или «Остатки» (от даты изменения до текущего дня);
Периодичность – функция сегментирования для параметра типа «Дата».
«Регистрация изменений объекта по набору данных» / «…регистра по набору данных»
Данные обработчики устанавливаются по умолчанию для типа данных «Объект» и работают только для него.
Два универсальных обработчика для любых вариантов сегментирования, включая множественные. Один из них применим только для регистров, другой – для любых объектов, кроме регистров. Подставляются автоматически при проектировании выгрузки. Параметров для настройки не требуют.
Обработчики событий строки проекта
Перед выполнением строки: «Установка параметра проекта текущей датой» — устанавливает значение параметра типа «Дата» в текущую дату перед каждой выгрузкой. «Добавление очереди выгрузки строки проекта текущей датой» — для выгрузки остатков при отсутствии движений за день.
После выполнения строки: «Отправка на email результата выполнения проекта».
Инициализация очереди строки проекта: «имитирует» нажатие кнопки «Сформировать очередь» при каждом запуске выгрузки.
Обработчики событий проекта
Назначаются в форме проекта на вкладке «Обработчики». Доступны обработчики как перед выгрузкой, так и после неё:
Перед выгрузкой: «Установка параметра проекта текущей датой» – аналогично обработчику строки проекта.
После выгрузки: «Отправка на email результата выполнения проекта».
Обработчики данных источника
Используются на этапе настройки вычисляемых полей при проектировании строки проекта мастером.
Создание собственного обработчика
В любом месте, где используются обработчики, можно выбрать «Обработчик» или «Произвольный код» и написать код на языке 1С. Различие: при выборе «Обработчик» создаётся элемент справочника «Обработчики», который затем можно переиспользовать в других проектах. При выборе «Произвольный код» – код сохраняется только в текущем проекте.
Нужна дополнительная помощь?
Обратитесь в службу поддержки Visiology.