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