--- name: onec-event-subscriptions-and-jobs description: "Проектирует подписки на события (EventSubscriptions), определяемые типы, функциональные опции и регламентные/фоновые задания в 1С:Предприятии. Используй при выборе точки размещения сквозной логики (модуль объекта, подписка, хук БСП, расширение), настройке расписаний и декларативном отключении функциональности." --- # Подписки на события, функциональные опции и регламентные задания 1С Используй навык, когда правило должно срабатывать для группы видов объектов (справочников, документов, наборов записей регистров), функциональность должна включаться/выключаться настройкой без ветвлений в каждом модуле либо обработка выносится в регламентное или фоновое задание. ## Матрица выбора точки размещения серверной логики Не дублируй один и тот же код в модулях десятка документов, но и не вешай глобальную подписку ради одного объекта: | Механизм | Когда выбирать | Ограничение и риск | |---|---|---| | **Модуль конкретного объекта** (`ПередЗаписью`, `ОбработкаПроведения`, `ОбработкаПроверкиЗаполнения`) | Логика специфична только для этого одного документа или справочника | Дублирование кода, если то же правило нужно ещё 10 документам | | **Подписка на события (`EventSubscription`) по определяемому типу** | Единое сквозное правило для открытого перечня объектов (версионирование, заполнение автора/подразделения, регистрация в очереди обмена, контроль даты запрета) | Выполняется на горячем пути **каждой** записи; порядок между несколькими подписками на одно событие платформой не гарантирован! | | **Переопределяемый общий модуль БСП (`...Переопределяемый`)** | Подключение прикладного объекта к уже существующей подсистеме БСП (печать, права, свойства, обновление ИБ, запрет изменения) | Сигнатура и момент вызова жёстко заданы версией БСП | | **Перехватчик в расширении (`&Перед`, `&После`, `&Вместо`)** | Точечная доработка типового объекта на поддержке, когда нет штатного хука БСП и подписки недостаточно | Зависимость от сигнатуры базового метода поставщика | **Предпочитай подписку на `ОпределяемыйТип`**, а не ручной список из 30 документов в свойстве `Источник`: тогда подключение нового документа сводится к добавлению одного чекбокса в состав определяемого типа. ## Сигнатуры и ловушки подписок на события Серверный общий модуль обработчика подписки должен иметь флаг `Сервер` (без `Клиент` и без `ВызовСервера`!). Точно соблюдай сигнатуру по виду источника и события: - **Справочник / План видов характеристик (`ПередЗаписью`, `ПриЗаписи`)**: `(Источник, Отказ)`; - **Документ (`ПередЗаписью`, `ПриЗаписи`)**: `(Источник, Отказ, РежимЗаписи, РежимПроведения)` — всегда проверяй `РежимЗаписи` (`Запись`, `Проведение`, `ОтменаПроведения`) и `Источник.ПометкаУдаления`, чтобы не блокировать пометку на удаление или отмену проведения проверками проведения! - **Документ (`ОбработкаПроведения`)**: `(Источник, Отказ, РежимПроведения)`; - **Набор записей регистра (`ПередЗаписью`, `ПриЗаписи`)**: `(Источник, Отказ, Замещение)` — **критическая ловушка**: при отмене проведения или очистке регистратора подписка вызывается для **пустого набора записей** (`Источник.Количество() = 0`), где отбор по `Регистратор` установлен, а строк нет! Всегда учитывай пустой набор и проверяй `Источник.ОбменДанными.Загрузка`. Внутри обработчика подписки запрещены тяжёлые некоррелированные запросы без индекса, сетевые вызовы и повторный `Источник.Записать()` в `ПриЗаписи` (приведёт к бесконечной рекурсии записи!). ## Функциональные опции и параметры функциональных опций - Для управления видимостью подсистем, объектов, реквизитов, команд и колонок форм используй **декларативные `ФункциональныеОпции`** (привязанные к константе или ресурсу регистра сведений), вместо ручного `Элементы.<Имя>.Видимость = ...` в десятках форм. - Если опция действует в разрезе организации, склада или вида операции, задай **`ПараметрыФункциональныхОпций`** и в управляемой форме вызывай `УстановитьПараметрыФункциональныхОпцийФормы(Новый Структура("Организация", Объект.Организация))` при открытии и смене организации. - Помни: функциональная опция скрывает элементы интерфейса, но **не отменяет права доступа** и не защищает серверный API сама по себе — в серверном коде проверяй `ПолучитьФункциональнуюОпцию(...)`. ## Дисциплина регламентных и фоновых заданий 1. **Тонкая точка входа в серверном общем модуле**: код регламентного задания размещай в экспортной процедуре общего модуля, чтобы его можно было вызывать как по расписанию (для предопределённого `РегламентноеЗадание`), так и вручную или из автотеста. 2. **Идемпотентность, порционность и защита от наложения**: - Расписание может запуститься повторно до завершения предыдущего тяжёлого прогона: защищай вход управляемой блокировкой пространства задания или проверкой активного задания по ключу; - Обрабатывай очередь пачками с фиксацией прогресса каждой пачки в короткой транзакции, чтобы сбой на 950-м элементе не откатывал 900 успешно обработанных и позволял продолжить со следующего шага; - Не предполагай наличие интерактивного пользователя, открытой формы или заполненных клиентских параметров: регламентное задание стартует в фоновом серверном сеансе, а все итоги и ошибки обязано писать в `ЗаписьЖурналаРегистрации` с понятным событием и контекстом объекта.