Как программно сделать поле обязательным для заполнения в 1С

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

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

Ниже разобраны оба подхода с готовыми примерами кода на встроенном языке 1С, условия выбора между ними, способы сделать обязательность условной (зависящей от других данных) и типичные ошибки, которые приводят к тому, что проверка либо не срабатывает, либо блокирует легальные операции.

Способ 1. Свойство «Проверка заполнения» у реквизита

Самый простой и надёжный вариант — установить свойство проверки заполнения непосредственно у реквизита в конфигураторе. Откройте объект (справочник, документ, план счетов и т.д.), выделите нужный реквизит и в палитре свойств найдите пункт «Проверка заполнения». Доступны значения: «Не проверять», «Выдавать ошибку», «Выдавать предупреждение».

Значение «Выдавать ошибку» означает, что платформа сама не даст записать объект с пустым значением этого реквизита — ни интерактивно, ни программно через Записать(). Значение «Выдавать предупреждение» лишь информирует пользователя, но запись выполнится. Для строгой обязательности выбирайте ошибку.

Важно понимать границу применения: свойство задаётся статически и не может зависеть от других данных объекта. Если поле обязательно только в определённых условиях (например, «Договор обязателен, только если контрагент — юридическое лицо»), этого свойства недостаточно — нужна программная проверка.

Способ 2. Процедура ОбработкаПроверкиЗаполнения в модуле объекта

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

Типовой пример для документа, где поле «Договор» обязательно только при определённом виде операции:

Процедура ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты)

// Условная обязательность: договор нужен только для операции "Продажа"
Если ВидОперации = Перечисления.ВидыОпераций.Продажа
И Не ЗначениеЗаполнено(Договор) Тогда

ТекстСообщения = НСтр("ru = 'Поле ""Договор"" не заполнено'");
ОбщегоНазначения.СообщитьПользователю(ТекстСообщения, ЭтотОбъект,
"Договор", "Объект", Отказ);

КонецЕсли;

КонецПроцедуры

Параметр Отказ, установленный в Истина, прерывает запись. Указание пути к данным ("Договор", "Объект") делает сообщение «кликабельным»: при двойном щелчке по ошибке курсор встанет на нужное поле формы. Если конфигурация не содержит БСП, вместо ОбщегоНазначения.СообщитьПользователю используйте объект СообщениеПользователю напрямую.

Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Поле не заполнено";
Сообщение.Поле = "Договор";
Сообщение.ПутьКДанным = "Объект";
Сообщение.УстановитьДанные(ЭтотОбъект);
Сообщение.Сообщить();
Отказ = Истина;

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

Массив ПроверяемыеРеквизиты содержит имена реквизитов, которые платформа проверит автоматически. Если вы реализуете собственную логику, стандартную проверку для реквизита нужно исключить, иначе пользователь получит два сообщения об одном поле. Для этого удалите имя из массива:

ОбщегоНазначения.УдалитьНепроверяемыеРеквизитыИзМассива(
ПроверяемыеРеквизиты, МассивНепроверяемыхРеквизитов);

Либо вручную найдите индекс элемента в массиве и удалите его методом Удалить(). Это стандартный приём при замене платформенной проверки собственной.

Способ 3. Обязательность только на форме

Иногда требование касается только конкретной формы: например, в упрощённой форме ввода одно поле обязательно, а в полной форме документа — нет. Тогда обязательность настраивается на уровне элемента формы, без изменения модели данных.

Для управляемой формы в конфигураторе выделите элемент поля ввода и установите свойство «АвтоОтметкаНезаполненного» или «ОтметкаНезаполненного» — поле получит визуальную подсветку (красную рамку). Однако визуальная отметка сама по себе не блокирует запись: блокировку обеспечивает либо проверка заполнения реквизита, либо код в обработчике проверки на форме.

Программно на форме проверку делают в событии ОбработкаПроверкиЗаполненияНаСервере или перед записью:

&НаКлиенте
Процедура ПередЗаписью(Отказ, ПараметрыЗаписи)
Если Не ЗначениеЗаполнено(Объект.Комментарий) Тогда
ПоказатьПредупреждение(, "Заполните комментарий");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

Как выбрать подходящий способ

Критерий выбора простой: ответьте на вопрос «должно ли правило действовать всегда, даже при загрузке данных извне?». Если да — реализуйте проверку на уровне объекта (свойство реквизита или модуль объекта). Если правило касается только удобства ввода в конкретной форме — ограничьтесь формой, чтобы не ломать интеграции.

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

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

Типичные ошибки и ограничения

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

Вторая ошибка — проверка только на клиенте в ПередЗаписью. Такой код легко обходится (например, при записи из списка документов без открытия формы) и не срабатывает при программной записи. Клиентская проверка — это удобство для пользователя, а не защита данных.

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