Настройка обработчиков документа с выбором пользовательского или произвольного кода в параметрах бизнес-процесса
Для настройки заполнения шапки и табличной части документа можно использовать параметры бизнес-процесса. Пользователь может самостоятельно выбирать тип обработчика, который будет использоваться при возникновении определённых событий.
Это нововведение позволяет подключать произвольный код и использовать собственные обработчики без необходимости работы в конфигураторе 1С или обращения к интеграционной обработке. Также стало возможно унифицировать имена обработчиков, применяемых при выборе опции «Свой обработчик».
Изменение параметров обработчиков доступно только для пользовательских бизнес-процессов (подробнее о создании см. здесь) и не поддерживается в типовых сценариях.
При выборе события можно задать один из следующих типов обработчиков:
Тип обработчика «Произвольный код»
Данный тип предоставляет возможность задать собственную логику на языке 1С, которая будет запускаться при срабатывании соответствующего события.
Чтобы создать новый код, нажмите «Добавить».
Укажите имя для произвольного кода и введите его текст в специальное поле. При написании кода доступны переменные, отображаемые в отдельной панели. После завершения нажмите «Сохранить и закрыть».
После сохранения код станет доступен для выбора в обработчике.
Тип обработчика «Обработчик по умолчанию»
Выбирая этот тип, вы назначаете системе использовать предустановленный обработчик с автоматически сгенерированным именем, которое нельзя изменить вручную.
Для заполнения шапки документа
Структура имени обработчика:
| Имя обработчика | Значение |
|---|---|
| УТ_11_4_ЗаказПоставщику_ПослеОткрытияФормыДокумента | |
| УТ_11_4 | Префикс от версии конфигурации |
| ЗаказПоставщику | Тип документа |
| ПослеОткрытияФормыДокумента | Название события |
Для заполнения строк табличной части
Структура имени:
| Имя обработчика | Значение |
|---|---|
| УТ_11_4_ЗаказПоставщику_ПослеЗаполненияСтрокиТЧ_Товары | |
| УТ_11_4 | Префикс от версии конфигурации |
| ЗаказПоставщику | Тип документа |
| ПослеЗаполненияСтрокиТЧ | Название события |
| Товары | Табличная часть |
Реализация таких обработчиков должна быть аналогична обработчикам в режиме «Свой обработчик»: события формы — в модуле формы, остальные — в модуле объекта.
Тип обработчика «Свой обработчик»
При выборе этого типа открывается редактируемое поле, в котором можно указать имя вашей процедуры, которая будет вызвана из нужного модуля интеграционной обработки.
Расположение обработчиков:
-
Обработчик «После открытия формы документа» — размещается в модуле формы интеграционной обработки.
Чтобы открыть этот модуль, нужно перейти к форме в конфигураторе:
Пример расположения:
-
Остальные обработчики — должны находиться в модуле объекта интеграционной обработки.
Переход к нужному модулю осуществляется следующим образом:
Пример расположения:
«Без обработчика»
Данный вариант выбирается, если не требуется выполнять никакие действия при наступлении события. В этом случае поле с именем обработчика остаётся пустым и недоступным для редактирования.