Другое · 8 мин
Когда выполняется подписка на событие в 1С
Когда срабатывает подписка на событие в 1С: до или после записи объекта, условия срабатывания, проверка обработчика и защита от рекурсии.
Подписка на событие в 1С:Предприятие — это правило, при котором платформа вызывает обработчик, когда в информационной базе происходит заданное действие объекта. Подписка настраивается в конфигурации на события объектов: документов, справочников, регистров и других метаданных. Само по себе существование подписки не вызывает код; код запускается только при наступлении события в живой базе.
Важно различать создание подписки и её выполнение. Подписка может быть активной или отключённой, иметь условие и приоритет, но обработчик сработает только если все эти параметры совпадают с ситуацией в базе. Если объект изменяется не через механизмы 1С, а напрямую на уровне хранилища, платформа обычно не видит такого изменения как события приложения.
События объектов привязаны к жизненному циклу записи. Наиболее распространённые моменты: перед записью объекта в базу, после успешной записи, при удалении и при снятии пометки на удаление. Точный набор событий зависит от типа объекта и режима приложения: обычное или управляемое, клиент-серверное или файловое.
Обработчик подписки на «Перед записью» вызывается до того, как данные попадают в базу, поэтому в нём можно проверять значения и отменять запись, выбросив исключение. Обработчик на «После записи» запускается уже после того, как платформа завершила сохранение объекта, но часто всё ещё внутри той же транзакции, что и запись.
Что считается событием и где подписка подключается
События делятся на события объектов и события форм, команд и бизнес-процессов. Для подписки на событие объекта указывается имя метаданного объекта, тип события и модуль обработчика. Подписка может быть создана в конфигураторе или программно через механизм подписки на события, но в обоих случаях она хранится в конфигурации и действует для всех пользователей, у которых есть доступ к объекту.
Не путайте подписку на событие объекта с подпиской на событие в бизнес-процессе или с уведомлением пользователя. Первая реагирует на запись данных, вторая — на этапы маршрута или действия участников процесса. Они имеют разные точки входа и разные условия выполнения.
Момент выполнения: перед записью, после записи и удаление
Если подписка настроена на событие «Перед записью», обработчик вызывается до фиксации изменений. Это подходит для проверки обязательных реквизитов, расчёта производных полей и запрета записи при некорректных данных. Ошибка в этом обработчике может отменить всю операцию записи, поэтому логика должна быть краткой и предсказуемой.
Событие «После записи» выполняется после сохранения объекта. Оно удобно для записи связанных данных, создания движений регистров, отправки уведомлений или обновления кэша. Однако обработчик не должен пытаться отменить уже записанные данные; для отката нужны механизмы транзакций, а не подписка после факта.
Удаление и пометка на удаление
При удалении объекта платформа может вызвать подписку до физического удаления или после него, в зависимости от типа события и настроек конфигурации. Если объект только помечается на удаление, а не удаляется окончательно, срабатывают события пометки, а не события безвозвратного удаления. Это различие важно при аудите и восстановлении данных.
Условия срабатывания и порядок обработчиков
Подписка может содержать условие на языке встроенных выражений 1С. Условие проверяется перед вызовом обработчика, и если оно ложно, код не выполняется. Это позволяет ограничить подписку отдельными видами документов, контрагентами или состояниями объекта, не создавая отдельных обработчиков на каждый случай.
Когда на одно событие подписано несколько обработчиков, порядок их вызова определяется приоритетом и правилами платформы. Не полагайтесь на неявную очередность: если обработчики зависят друг от друга, явно задавайте приоритеты или объединяйте логику в одном обработчике с комментариями.
- 1Убедитесь, что подписка активна и событие выбрано верно
- 2Проверьте условие подписки на тестовых данных
- 3Выполните запись объекта через обычный интерфейс 1С
- 4Проверьте журнал или регистр сведений с результатами обработчика
- 5Повторите на копии базы перед вводом в эксплуатацию
Где выполняется подписка: сервер, клиент, транзакция
Место выполнения зависит от способа вызова записи и типа приложения. При записи из клиентского приложения часть логики может выполняться на клиенте, а запись данных — на сервере. Подписки на события объектов обычно выполняются в контексте серверного вызова, но точная модель зависит от архитектуры информационной базы.
Обработчик подписки часто работает в той же транзакции, что и запись объекта. Если транзакция откатывается, изменения, сделанные внутри обработчика, тоже могут откатиться. Долгие операции внутри подписки — вызов внешних сервисов, большие отчёты, ожидание ввода — увеличивают время блокировки данных и могут замедлить других пользователей.
Проверка результата и отладка
Чтобы убедиться, что подписка сработала, добавьте в обработчик запись в регистр сведений или журнал регистрации с фиксацией времени, пользователя и ключа объекта. После тестовой записи проверьте, появилась ли запись, изменились ли связанные данные и не отменилась ли транзакция из-за ошибки в обработчике.
Используйте отладчик конфигуратора или режим выполнения с остановкой на ошибках. Если подписка не срабатывает, проверьте: активна ли подписка, совпадает ли тип события, верно ли условие, есть ли права у пользователя, записывается ли объект через стандартные методы 1С, а не через обходные пути.
Проверьте флаг активности в конфигурации
Совпадает ли с действием пользователя
Проверьте значения реквизитов объекта
Уточните при тестировании в нужном режиме
Ограничения, риски и альтернативы
Основной риск подписки — рекурсия. Если обработчик «После записи» записывает тот же объект, может возникнуть цепочка повторных вызовов до исчерпания ресурсов. Другой риск — блокировка транзакции из-за тяжёлого кода в «Перед записью». Не размещайте в подписках вызовы внешних систем без обработки таймаутов и ошибок.
Если задача требует только уведомления пользователя после записи, иногда проще использовать события форм или механизм оповещений, а не подписку на объект. Если нужно отслеживать изменения извне 1С, подписка не поможет; потребуется обмен данными, веб-сервисы или регулярная сверка по регистрам накопления.
Перед изменением подписки на рабочей базе сделайте резервную копию и протестируйте на копии базы. Изменение условий или приоритетов может повлиять на все пользователей одновременно, а не только на одного сотрудника.
Не пытайтесь отлаживать подписки, редактируя файлы базы напрямую или отключая транзакции вручную. Это может привести к неконсистентности данных и потере информации. Все изменения вносите через конфигуратор и стандартные инструменты 1С.
Что важно запомнить
Подписка срабатывает при возникновении события объекта в 1С, если она активна, условие выполнено и запись идёт через механизмы платформы.
Срабатывает ли подписка при импорте данных из внешнего файла?
Зависит от способа импорта. Если загрузка выполняется через стандартные объекты 1С с записью документов или справочников, события могут сработать. Если данные пишутся напрямую в таблицы базы или через обходные механизмы, платформа не считает это событием приложения.
Может ли обработчик «После записи» отменить уже записанные данные?
Не напрямую. Данные уже сохранены, и отмена возможна только через откат транзакции или создание корректирующей записи. Обработчик после записи лучше использовать для добавления связанных данных, а не для отмены.
Что делать, если подписка не срабатывает у некоторых пользователей?
Проверьте права доступа к объекту, активность подписки для используемой конфигурации и режим работы клиента. Разные пользователи могут работать в разных сегментах базы или с разными правами, что влияет на видимость событий.
Безопасно ли вызывать внешние службы из подписки на запись?
Осторожно. Внешний вызов увеличивает время транзакции и может привести к блокировкам. Если служба недоступна, запись пользователя может упасть. Лучше выносить такие операции в фоновые задания после успешной записи.
Как отличить событие объекта от события формы?
Событие объекта связано с записью данных в базе и работает независимо от открытой формы. Событие формы связано с действиями пользователя в интерфейсе: открытие, нажатие кнопки, изменение поля на экране.