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