Ограничение списка выбора перечисления в 1С: от фильтров до программного кода

Работа с перечислениями в 1С:Предприятие — одна из самых частых задач, с которыми сталкиваются разработчики и администраторы. Но что делать, когда стандартный список значений перечисления содержит десятки или даже сотни элементов, а пользователю нужны только несколько? Неконтролируемый выбор не только замедляет работу, но и повышает риск ошибок. Например, в справочнике "Контрагенты" при выборе типа документа из перечисления ВидыДокументов может потребоваться показать только актуальные для текущего партнера варианты.

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

1. Стандартные фильтры перечислений в конфигураторе

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

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

• 🔹 ВидыДокументов.СчетФактура В (ВидыДокументов.СчетФактура, ВидыДокументов.Акт) — оставит только эти два значения
• 🔹 НЕ СтатусДокумента.Удален — исключит удаленные статусы
• 🔹 ТипКонтрагента = Перечисления.ТипыКонтрагентов.Поставщик — покажет только релевантные типы

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

2. Динамическая фильтрация через параметры формы

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

Рассмотрим пример: у нас есть документ "ЗаказПокупателя" с реквизитом ТипОплаты (перечисление). Нужно показывать только те типы оплаты, которые доступны для выбранного покупателя. Решение:

1. В модуле формы документа создаем процедуру ПриИзменении для реквизита "Покупатель":

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

ЭлементыФормы.ТипОплаты.СписокВыбора.Очистить();
Для Каждого ТекТип Из Перечисление.ТипыОплаты Цикл
Если ТипыОплаты.Свойство(ТекТип.Идентификатор) Тогда
ЭлементыФормы.ТипОплаты.СписокВыбора.Добавить(ТекТип);
КонецЕсли;
КонецЦикла;
КонецЕсли;
КонецПроцедуры

Ключевые моменты этого подхода:

• 🔧 Используем СписокВыбора.Очистить() и Добавить() для динамического формирования списка
• 🔧 Логику доступности храним в структуре для удобства управления
• 🔧 Обновление списка происходит при изменении зависимого реквизита ("Покупатель")

3. Программное ограничение через обработчики событий

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

Типичная задача: в документе "РеализацияТоваров" нужно ограничить список значений перечисления ТипЦены в зависимости от:

• 📌 Текущего контрагента
• 📌 Даты документа
• 📌 Наличия специальных соглашений

Решение реализуем через обработчик события ПриАктивизацииСтроки в табличной части:

Процедура ТабличнаяЧастьТоварыПриАктивизацииСтроки(Элемент, СтандартнаяОбработка)
ТекущаяСтрока = Элементы.ТабличнаяЧастьТовары.ТекущиеДанные;

ДоступныеТипыЦен = Новый СписокЗначений();
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ РАЗРЕШЕННЫЕ ТИПЫ ЦЕН
|ИЗ РегистрСведений.СоглашенияОЦенах
|ГДЕ Контрагент = &Контрагент
|  И ДатаНачала <= &ДатаДокумента
|  И ДатаОкончания >= &ДатаДокумента";

Запрос.УстановитьПараметр("Контрагент", Объект.Контрагент);
Запрос.УстановитьПараметр("ДатаДокумента", Объект.Дата);
Результат = Запрос.Выполнить();

Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
ДоступныеТипыЦен.Добавить(Выборка.ТипЦены);
КонецЦикла;

Если ДоступныеТипыЦен.Количество() = 0 Тогда
ДоступныеТипыЦен.Добавить(Перечисление.ТипыЦен.Розничная);
КонецЕсли;

ТекущаяСтрока.ТипЦены.СписокВыбора = ДоступныеТипыЦен;
КонецПроцедуры

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

4. Использование отбора в запросах для динамических списков

Когда перечисление используется в отчетах или обработках, где данные выбираются через Запрос, ограничить список можно непосредственно в тексте запроса. Это особенно удобно для больших баз данных, где фильтрация на уровне СУБД работает значительно быстрее, чем программная обработка.

Пример: нам нужно в отчете "Анализ продаж" показать только те виды нomenclature, которые относятся к категории "Электроника". Перечисление ВидыНоменклатуры содержит десятки значений, но в отчет должны попасть только релевантные:

ВЫБРАТЬ
Номенклатура.Наименование,
Номенклатура.ВидНоменклатуры КАК Вид
ИЗ
Справочник.Номенклатура КАК Номенклатура
ГДЕ
Номенклатура.ВидНоменклатуры В (&СписокВидов)

УПОРЯДОЧИТЬ ПО
Наименование

Где параметр &СписокВидов формируется заранее:

СписокВидов = Новый Массив();
СписокВидов.Добавить(Перечисление.ВидыНоменклатуры.Электроника);
СписокВидов.Добавить(Перечисление.ВидыНоменклатуры.БытоваяТехника);

Запрос.УстановитьПараметр("СписокВидов", СписокВидов);

Преимущества этого метода:

5. Кастомные формы выбора с уникальной логикой

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

Рассмотрим задачу: в документе "ЗаявкаНаОплату" нужно выбрать ТипОперации из перечисления, но доступные варианты зависят от:

• 🏢 Подразделения сотрудника
• 💰 Валюты документа
• 📅 Текущей даты (сезонные ограничения)

Алгоритм реализации:

1. Создаем новую форму с реквизитом ВыбранныйТипОперации (тип — наше перечисление)
2. Добавляем элементы управления для фильтров (выбор подразделения, валюты и т.д.)
3. В обработчике ПриОткрытии загружаем все возможные значения перечисления
4. Реализуем процедуру ОбновитьСписок(), которая будет фильтровать значения по текущим фильтрам
5. Добавляем кнопку "Выбрать" с возвратом результата через ЗначениеВозврата

Пример кода для кнопки "Выбрать":

Процедура КоманднаяПанельВыбрать(Кнопка)
Если НЕ ЗначениеЗаполнено(ВыбранныйТипОперации) Тогда
Предупреждение("Не выбран тип операции!", 60);
Возврат;
КонецЕсли;

ЗначениеВозврата = Новый Структура();
ЗначениеВозврата.Вставить("ТипОперации", ВыбранныйТипОперации);
Закрыть(Истина);
КонецПроцедуры

Чтобы вызвать эту форму из основного документа:

Процедура ТипОперацииНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;

ПараметрыФормы = Новый Структура();
ПараметрыФормы.Вставить("ТекущееПодразделение", Объект.Подразделение);
ПараметрыФормы.Вставить("ВалютаДокумента", Объект.Валюта);

Ответ = ОткрытьФормуМодально("Справочник.Формы.ВыборТипаОперации", ПараметрыФормы);
Если Ответ <> Неопределено Тогда
Объект.ТипОперации = Ответ.ТипОперации;
КонецЕсли;
КонецПроцедуры

Типичные ошибки и как их избежать

При ограничении списков выбора перечислений разработчики часто сталкиваются с одними и теми же проблемами. Вот наиболее распространенные ошибки и способы их решения:

⚠️ Внимание: Если вы используете динамическую фильтрацию в формах с большим количеством строк (1000+), обязательно отключайте автоматическое обновление списков выбора при прокрутке. Иначе интерфейс будет "тормозить" из-за постоянных перерисовок.

• 🚫 Пустой список выбора: Забыли обработать случай, когда фильтр возвращает 0 значений. Всегда добавляйте значение по умолчанию или показывайте сообщение пользователю.
• 🚫 Утечки памяти: При частом обновлении списков в циклах не очищаются временные коллекции. Используйте Очистить() для СписокЗначений и УничтожитьОбъекты() для запросов.
• 🚫 Несовпадение типов: При программном добавлении значений в список выбора передаете не само значение перечисления, а его представление (строку). Всегда используйте Перечисление.ИмяПеречисления.Значение.
• 🚫 Игнорирование прав доступа: Фильтруете список без проверки прав пользователя. Всегда комбинируйте логические ограничения с ПраваДоступа.Проверка().

Еще одна распространенная проблема — некорректная работа при групповом редактировании. Если вы ограничиваете список выбора в табличной части, убедитесь, что логика работает корректно при:

• 📋 Массовом изменении значений (ИзменитьВыделенныеСтроки())
• 📋 Копировании строк (Копировать())
• 📋 Заполнении по умолчанию (ЗаполнитьЗначенияСвойств())

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

FAQ: Частые вопросы по ограничению перечислений

ТекущееЗначение = Объект.ТипДокумента;
ОбновитьСписокВыбора(); // Ваша процедура фильтрации
Если СписокВыбора.Найти(ТекущееЗначение) <> Неопределено Тогда
Объект.ТипДокумента = ТекущееЗначение;
Иначе
Объект.ТипДокумента = СписокВыбора[0]; // Значение по умолчанию
КонецЕсли;

Процедура ПриКомпоновкеРезультата(ДанныеРасшифровки, СтандартнаяОбработка)
Если ДанныеРасшифровки.Параметры.Найти("ТипДокумента") <> Неопределено Тогда
ДоступныеТипы = Новый СписокЗначений();
// Формируем список на основе других параметров
Если ДанныеРасшифровки.Параметры.Контрагент.Тип = Перечисление.ТипыКонтрагентов.Поставщик Тогда
ДоступныеТипы.Добавить(Перечисление.ВидыДокументов.СчетФактураПоставщика);
КонецЕсли;
ДанныеРасшифровки.Параметры.УстановитьЗначение("ТипДокумента.СписокВыбора", ДоступныеТипы);
КонецЕсли;
КонецПроцедуры