К статье
Практический материал

Другое · 7 мин

Обработка заполнения в 1C: когда срабатывает и как управлять

Разбираем, в каких ситуациях в 1C срабатывает обработка заполнения документа или объекта, как отменить или заменить стандартное заполнение и на что обратить внимание при отладке.

Обработка заполнения в 1C — это событие платформы, которое позволяет перехватить момент, когда пользователь инициирует заполнение реквизитов документа или другого объекта перед сохранением. В обработке можно задать значения полей, выполнить расчёты, подставить данные из справочников или полностью отменить стандартное поведение.

Обычно обработка объявляется с параметрами Отказ и СтандартнаяОбработка. Если установить Отказ = Истина, платформа прерывает текущее действие; вызов СтандартнаяОбработка() передаёт управление встроенному алгоритму заполнения. Точный момент вызова зависит от конфигурации, формы и способа запуска.

Не путать обработку заполнения с событием записи или проведения: заполнение готовит данные, запись фиксирует их в базе, а проведение создаёт движения по регистрам. Одно и то же поле может заполняться несколько раз при разных действиях пользователя.

Что понимают под обработкой заполнения в 1C

Это процедура формы или модуля объекта, которая срабатывает в ответ на команду заполнения, а не при каждом изменении поля. Она предназначена для автоматизации ввода: заполнение табличных частей, подстановка контрагента, расчёт сумм, установка дат и других реквизитов на основе уже введённых данных.

Код в обработке выполняется в контексте текущего объекта, поэтому доступны его реквизиты, табличные части и методы. Важно понимать, что изменения, внесённые в обработке, сохранятся только если объект будет записан, а само заполнение не заменяет проверку заполненности обязательных реквизитов.

Где ищется обработкаВ модуле формы объекта или в модуле самого объекта

Проверьте оба места, так как реализация может быть в любом из них.

Признак срабатыванияПоля заполняются автоматически после действия пользователя

Посмотрите, меняются ли реквизиты сразу после открытия или команды

Признак отменыОкно закрывается без записи или появляется сообщение об отказе

Убедитесь, что Отказ установлен не случайно

В каких действиях пользователя она вызывается

Обработка чаще всего связана с интерактивной работой в форме: открытие документа, нажатие команды заполнения, выбор значения в реквизите, попытка записи или закрытия формы. Точный набор действий определяется конфигурацией и настройками формы, поэтому одинаковая обработка может срабатывать по-разному в разных базах.

При программном создании объекта и записи без интерфейса обработка может не вызываться или вызываться иначе, чем при ручном заполнении. Если заполнение нужно гарантированно выполнять и при программном создании, вызывайте соответствующую процедуру явно или дублируйте логику в общем модуле.

Отличие от событий записи и проведения

Заполнение готовит данные к записи, но не является самой записью. Событие записи срабатывает уже при попытке сохранить объект, а проведение — при проведении документа и создании движений. Если в обработке заполнения изменить реквизит, который влияет на проведение, изменения попадут в проводки только после успешной записи и проведения.

Из-за этого ошибки в заполнении могут проявиться не сразу, а только при попытке записать или провести документ. Отладка должна учитывать всю цепочку: заполнение → запись → проведение, а не только первое звено.

Как управлять стандартным заполнением и отказом

Чтобы отменить заполнение, установите Отказ = Истина и, при необходимости, уведомите пользователя. Чтобы сохранить стандартное поведение и добавить своё, вызовите СтандартнаяОбработка() после своих действий. Порядок вызова важен: стандартная обработка может перезаписать значения, заданные до неё.

Не вызывайте стандартную обработку несколько раз подряд без необходимости, это может привести к повторному заполнению табличных частей или некорректным расчётам. Проверяйте результат после каждого этапа: значения реквизитов, заполненность обязательных полей, отсутствие сообщений об ошибках.

Порядок действий
  1. 1
    Найдите модуль формы или объекта, где описана обработка заполнения
  2. 2
    Убедитесь, что обработка подписана на нужное событие пользовательского действия
  3. 3
    Напишите логику заполнения с проверкой обязательных реквизитов
  4. 4
    Решите, нужен ли вызов СтандартнаяОбработка и установка Отказ
  5. 5
    Проверьте результат при ручном и программном заполнении

Где писать код: форма, объект, общий модуль

Код можно размещать в модуле формы объекта, если заполнение зависит от особенностей интерфейса, или в модуле объекта, если логика должна работать независимо от формы. Общий модуль подходит для повторно используемых алгоритмов, которые вызываются из разных обработок.

Выбор места влияет на видимость кода и возможность переиспользования. Логика только в форме может не сработать при импорте данных или программной записи, а логика только в объекте может быть избыточна для простых форм. Ориентируйтесь на то, где именно инициируется заполнение.

Типичные ошибки
01
Вызов СтандартнаяОбработка после перезаписи всех значений, что приводит к потере своих данных
02
Установка Отказ без информирования пользователя, из-за чего кажется, что программа зависла
03
Размещение логики только в модуле формы, что не работает при программной записи

Ограничения и риски при самостоятельной работе

Изменение реквизитов в обработке заполнения может повлиять на связанные документы, отчёты и расчёты, особенно если затрагиваются суммы, даты или контрагенты. Ошибки в условии отмены могут заблокировать запись документов для пользователей. Перед правкой рабочей базы проверяйте изменения на копии или в изолированной среде.

Не вносите изменения в конфигурацию без понимания последствий для обновлений и поддержки. Если обработка заполнения уже используется в типовом решении, переопределение может конфликтовать с будущими обновлениями. Безопасная самостоятельная работа ограничивается тестированием, документированием изменений и согласованием с ответственными за базу.

Контрольные точки

Как проверить результат

Значения реквизитов после заполнения
Норма

Ожидаемые значения заданы, обязательные поля заполнены

Тревожный признак

Поля пустые или содержат старые значения

Поведение при отмене
Норма

Действие прерывается корректно, пользователь видит причину

Тревожный признак

Запись блокируется без объяснения или происходит частично

Программное заполнение
Норма

Обработка вызывается явно и даёт тот же результат, что и в форме

Тревожный признак

Логика работает только в интерактивном режиме

Как проверить, что заполнение отработало

Откройте документ или объект, выполните действие, которое должно вызвать заполнение, и сравните значения реквизитов до и после. Проверьте табличные части, обязательные поля и вычисляемые показатели. Если заполнение не произошло, убедитесь, что обработка подписана на событие и не отменяется условием Отказ.

При программном заполнении вызывайте обработку явно и проверяйте возвращаемое состояние объекта. Если результат нестабилен, воспроизведите ситуацию на тестовой базе с одинаковыми входными данными и одинаковыми правами пользователя.

Итог

Что важно запомнить

Обработка заполнения вызывается при инициированном пользователем заполнении объекта, позволяет задать реквизиты, отменить действие или вызвать стандартное заполнение, но не заменяет запись и проведение.

Срабатывает ли обработка заполнения при каждом изменении поля?

Нет, обычно она связана с инициированным действием заполнения, а не с каждым вводом значения. Для реакции на изменение конкретного поля используют другие события формы или объекта.

Можно ли отменить запись из обработки заполнения?

Да, установка параметра Отказ в Истина прерывает текущее действие. Пользователю рекомендуется выводить понятное сообщение, чтобы не создавалось впечатления зависания программы.

Нужно ли всегда вызывать СтандартнаяОбработка?

Не всегда. Если ваша логика полностью заменяет стандартное заполнение, вызов не обязателен. Если нужно дополнить стандартное поведение, вызывайте его после своих действий и учитывайте возможную перезапись значений.

Работает ли обработка при программном создании документа?

Не гарантированно. При программной записи без интерфейса обработка может не срабатывать или вызываться иначе. Для надёжности вызывайте логику заполнения явно или дублируйте её в общем модуле.

Чем обработка заполнения отличается от проведения документа?

Заполнение подготавливает реквизиты и табличные части к сохранению, а проведение создаёт движения по регистрам после успешной записи. Изменения в заполнении влияют на проведение только если документ будет записан и проведён.