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

Перечисления в 1С — это заранее заданные списки значений, которые пользователь выбирает из выпадающего списка. По умолчанию платформа показывает все значения перечисления, но на практике часто требуется показать только часть: например, в документе «Приходный ордер» доступны статусы «Новый» и «Принят», а «Отменён» — только в специальном документе. Такая фильтрация не делается настройкой самого перечисления — она реализуется на уровне формы и кода.

Ограничить список выбора можно несколькими способами: через параметры выбора реквизита, через обработчик события «НачалоВыбора», через установку свойства «СписокВыбора» поля ввода или программной проверкой при записи. Каждый вариант имеет свои ограничения, и выбор зависит от того, где должна работать фильтрация — только в одной форме или во всей системе.

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

Где именно ограничивается список: уровни решения

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

Отдельный случай — подчинённые сценарии, когда список зависит от другого реквизита. Например, при типе операции «Продажа» доступны одни статусы, при «Возврате» — другие. Здесь потребуется динамическое формирование списка в коде формы с реакцией на изменение связанного поля.

Способ 1: свойство «СписокВыбора» поля формы

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

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	Элементы.Статус.СписокВыбора.Очистить();
	Элементы.Статус.СписокВыбора.Добавить(Перечисления.СтатусыДокумента.Новый);
	Элементы.Статус.СписокВыбора.Добавить(Перечисления.СтатусыДокумента.Принят);
КонецПроцедуры

Обратите внимание: если в реквизите уже записано значение, отсутствующее в списке выбора, оно будет отображаться, но при повторном открытии списка пользователь не сможет его выбрать заново. Это удобно для «устаревших» значений, которые нужно выводить из оборота постепенно.

Способ 2: обработчик «НачалоВыбора» с отбором

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

Для перечислений отбор работает по ссылке с видом сравнения «В списке». Список допустимых значений передаётся через параметры формы выбора.

&НаКлиенте
Процедура СтатусНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
	СтандартнаяОбработка = Ложь;
	Допустимые = Новый Массив;
	Допустимые.Добавить(ПредопределенноеЗначение("Перечисление.СтатусыДокумента.Новый"));
	Допустимые.Добавить(ПредопределенноеЗначение("Перечисление.СтатусыДокумента.Принят"));
	ПараметрыФормы = Новый Структура("Отбор", Новый Структура("Ссылка", Допустимые));
	ОткрытьФорму("Перечисление.СтатусыДокумента.ФормаВыбора", ПараметрыФормы, Элемент);
КонецПроцедуры

Этот способ даёт больше контроля: можно открыть собственную форму выбора, добавить пояснения, картинки или дополнительные колонки. Недостаток — код сложнее, и при быстром вводе с клавиатуры отбор может не сработать, если не обработать также событие «АвтоПодбор» или не задать СписокВыбора параллельно.

Способ 3: динамический список, зависящий от другого реквизита

Частая задача — менять доступные значения перечисления в зависимости от другого поля. Например, вид операции определяет допустимые статусы. Реализуется это через обработчик «ПриИзменении» управляющего реквизита, в котором перестраивается СписокВыбора зависимого поля.

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

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

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

Защита на уровне данных: проверка при записи

Интерфейсные ограничения обходятся программно: обработкой, обменом данными, вводом на основании. Если бизнес-правило критично, добавьте контроль в модуль объекта — в процедуре «ОбработкаПроверкиЗаполнения». Там проверяется, входит ли выбранное значение в допустимый перечень, и при нарушении выводится сообщение с отказом от записи.

Процедура ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты)
	Допустимые = Новый Массив;
	Допустимые.Добавить(Перечисления.СтатусыДокумента.Новый);
	Допустимые.Добавить(Перечисления.СтатусыДокумента.Принят);
	Если ЗначениеЗаполнено(Статус) И Допустимые.Найти(Статус) = Неопределено Тогда
		ОбщегоНазначения.СообщитьПользователю("Недопустимый статус для этого документа",, "Объект.Статус",, Отказ);
	КонецЕсли;
КонецПроцедуры

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

Альтернатива: справочник вместо перечисления

Перечисления жёстко зашиты в конфигурацию: добавить или скрыть значение без обновления конфигурации нельзя. Если набор допустимых значений меняется бизнес-пользователями или различается по организациям, рассмотрите замену перечисления на справочник. Для справочника ограничение списка делается штатно — через «Параметры выбора» или «Связи параметров выбора» реквизита, без единой строчки кода.

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

Проверка результата и типичные ошибки

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

Отдельно отметим: ограничение доступа к значениям перечисления через роли и RLS невозможно — механизм ограничения доступа на уровне записей работает только с объектными данными (справочниками, документами). Для перечислений единственные инструменты — интерфейсные фильтры и программные проверки.

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