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

Другое · 7 мин

Обработка выбора в 1С: когда срабатывает и как проверить

Разбираем, в каких ситуациях в 1С срабатывает обработка выбора реквизита формы, как проверить срабатывание и какие ограничения учитывать при настройке.

Обработка выбора в 1С относится к событиям форм и связана с моментом, когда пользователь выбирает значение из списка, связанного с реквизитом или реквизитным полем. Она не является универсальным триггером на любое изменение данных: срабатывание зависит от типа поля, способа ввода и наличия у поля списка выбора. Понимание этого различия помогает не ждать кода там, где платформа его не выполняет.

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

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

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

Поле с открывающимся спискомОбработка выбора может сработать

Проверьте, есть ли у реквизита список значений и открывает ли его пользователь.

Ручное ввод без спискаСрабатывание маловероятно

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

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

Если нужно выполнить логику после кода, вызывайте процедуру явно.

Когда именно срабатывает обработка выбора

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

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

Что можно делать внутри обработчика

Внутри обработчика удобно заполнять зависимые реквизиты: после выбора контрагента подставлять договор, после выбора номенклатуры — единицу измерения или ставку НДС, после выбора склада — доступные серии или характеристики. Можно также открывать дополнительные формы, формировать сообщения пользователю или отменять стандартное заполнение, если выбранное значение не подходит по бизнес-правилам.

Лучше не размещать в обработчике выбора сложные расчёты, выгрузки или запись большого количества документов. Событие связано с интерактивным действием пользователя, и тяжёлые операции могут замедлить интерфейс или привести к частичному заполнению формы при прерывании. Тяжёлую логику выносите в отдельные команды или обработку после сохранения.

Проверка результата и условия завершения

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

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

Порядок действий
  1. 1
    Откройте форму в режиме разработки и найдите элемент с реквизитом
  2. 2
    Убедитесь, что у реквизита есть список значений или кнопка выбора
  3. 3
    Добавьте или проверьте процедуру ПриВыборе для этого элемента
  4. 4
    Временно выведите значение в сообщение или отладчик
  5. 5
    Проверьте заполнение зависимых полей и сохраните документ

Ограничения и частые ошибки

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

Ещё одна ошибка — полагаться на обработчик выбора как на единственную защиту от некорректных данных. Он срабатывает только при интерактивном выборе, но не блокирует импорт, обмен данными или прямое изменение через другие формы. Контроль обязательных реквизитов и бизнес-правил лучше реализовать на уровне проверки перед записью.

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

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

Альтернативы и связанные события

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

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

Итог

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

Обработка выбора вызывается при интерактивном выборе из списка, не заменяет проверку перед записью и требует тестирования на копии базы.

Частые вопросы

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

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

Может ли обработка выбора заблокировать сохранение документа?

Сама по себе она не блокирует запись, но может отменить стандартное заполнение или оставить обязательные поля пустыми. В этом случае при сохранении платформа может выдать ошибку, поэтому после выбора важно проверять заполнение критических реквизитов.

Нужно ли тестировать обработчик в разных клиентах?

Да. Поведение элементов выбора может отличаться в тонком клиенте, веб-клиенте и мобильном приложении. Проверяйте сценарий в тех клиентах, которые реально используют сотрудники.

Что делать, если обработка выбора не вызывается?

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