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

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

В этой статье мы разберём 5 рабочих методов — от простых настроек в конфигураторе до программного кода на встроенном языке. Вы узнаете, как фильтровать перечисления в формах, документах и отчётах, а также как динамически изменять доступные значения в зависимости от условий. Материал актуален для платформы 1С:Предприятие 8.3 и популярных конфигураций: Управление торговлей (УТ 11), Бухгалтерия предприятия (БП 3.0), Зарплата и управление персоналом (ЗУП 3.1).

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

1. Ограничение через свойства поля в форме

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

Чтобы настроить ограничение:

1. Откройте форму в конфигураторе (например, форму документа или справочника).
2. Выделите поле с перечислением, которое нужно ограничить.
3. В палитре свойств найдите параметр Выбор и установите значение Выбор.ВыборГруппы или Выбор.ИерархическийВыбор (если перечисление иерархическое).
4. В свойстве ОграничениеВыбора укажите условие фильтрации. Например, для перечисления ВидыНоменклатуры можно задать:

   ВидыНоменклатуры.Товар ИЛИ ВидыНоменклатуры.Услуга

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

• ✅ Плюсы: быстро настраивается, не требует знания языка 1С.
• ❌ Минусы: не подходит для динамических условий, ограниченная гибкость.

2. Программное ограничение в модуле формы

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

Рассмотрим пример для формы документа Заказ покупателя, где нужно ограничить перечисление ВидыОплат в зависимости от типа клиента (физическое или юридическое лицо):

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

В этом коде мы:

1. Проверяем тип контрагента.
2. Очищаем стандартный список выбора.
3. Добавляем только те значения перечисления, которые актуальны для текущего контрагента.

⚠️ Внимание: Если в форме используется управляемая форма, код нужно размещать в модуле формы на клиенте (&НаКлиенте), а не на сервере. Иначе список выбора не обновится сразу при изменении других полей.

• 🔧 Где применять: формы документов, справочников, отчёты с параметрами.
• 📌 Важно: после изменения списка выбора вызовите метод ОбновитьВыбор() для поля.

3. Использование динамических списков

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

Алгоритм настройки:

1. Создайте динамический список в форме (например, через конструктор формы).
2. В качестве источника данных укажите запрос, который возвращает нужные значения перечисления. Пример запроса для перечисления СтатусыЗаказов:

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

3. Свяжите поле ввода с динамическим списком через свойство ИсточникДанных.

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

4. Ограничение через права доступа

Иногда ограничить список перечисления нужно не по логике бизнес-процесса, а по ролям пользователей. Например, менеджеры видят все статусы заказов, а логисты — только те, которые относятся к их отделу. В этом случае поможет настройка прав доступа.

Как настроить:

1. Откройте Конфигуратор → Администрирование → Пользователи и права.
2. Выберите роль, для которой нужно ограничить доступ (например, Логист).
3. В разделе Права на данные найдите перечисление, которое нужно ограничить (например, СтатусыЗаказов).
4. Установите права Чтение только для нужных значений перечисления.

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

⚠️ Внимание: При изменении прав доступа на перечисления обязательно проверьте, не нарушатся ли существующие бизнес-процессы. Например, если документ содержит значение перечисления, к которому у пользователя нет прав, он не сможет его открыть.

• 🔒 Когда использовать: для разграничения доступа между отделами или ролями.
• 🚫 Ограничение: не подходит, если нужно динамически менять список в зависимости от данных документа.

5. Расширенные методы: обработчики событий и внешние обработки

Для сложных сценариев, когда стандартные методы не подходят, можно использовать:

• 🔄 Обработчики событий (например, ПриИзменении для связанных полей).
• 📁 Внешние обработки, которые подключаются к форме и расширяют её функционал.
• 🔗 Интеграция с другими системами (если значения перечисления зависят от данных из ERP или CRM).

Пример использования обработчика ПриИзменении для поля ТипДокумента, который влияет на доступные значения перечисления Статусы:

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

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

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

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

• 🔴 Список не обновляется при изменении других полей
  Причина: код ограничения выполняется только при открытии формы.
  Решение: добавьте вызов процедуры обновления в событие ПриИзменении для связанных полей.
• 🔴 Ошибка "Значение не найдено в перечислении"
  Причина: в базе есть документы со "старыми" значениями перечисления, которые теперь скрыты.
  Решение: перед внедрением ограничений проверьте данные на согласованность или напишите обработку для миграции значений.
• 🔴 Медленная работа формы при динамической фильтрации
  Причина: сложные запросы или циклы в обработчиках событий.
  Решение: оптимизируйте код, используйте кеширование или перенесите логику на сервер.

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

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

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

Параметры.ВидОперации.ОграничениеВыбора = Новый Структура("Виды, Тип",
Новый Массив(Перечисление.ВидыОпераций.Продажа, Перечисление.ВидыОпераций.Возврат),
ВидСравнения.ВСписке);

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Объект.РеквизитСПеречислением.ОграничениеВыбора = ...;
КонецПроцедуры

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