Как в запросе 1С проверить значение на перечисление

Проверка поля на конкретное значение перечисления — одна из самых частых задач при написании запросов в 1С. Перечисления хранятся в базе как ссылки, поэтому сравнивать их со строкой или числом нельзя: запрос либо вернёт пустой результат, либо завершится с ошибкой. Правильный способ — использовать литерал ЗНАЧЕНИЕ() или передать значение через параметр запроса.

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

Сравнение с конкретным значением через ЗНАЧЕНИЕ()

Если нужное значение перечисления известно заранее и не меняется, его указывают прямо в тексте запроса с помощью оператора ЗНАЧЕНИЕ(). Это самый читаемый и надёжный способ: платформа проверяет корректность имени перечисления ещё на этапе компиляции запроса, и опечатка будет замечена сразу.

// Отбор контрагентов с видом "Юридическое лицо"
ВЫБРАТЬ
Контрагенты.Ссылка КАК Контрагент
ИЗ
Справочник.Контрагенты КАК Контрагенты
ГДЕ
Контрагенты.ЮридическоеФизическоеЛицо = ЗНАЧЕНИЕ(Перечисление.ЮридическоеФизическоеЛицо.ЮридическоеЛицо)

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

Конструкция ЗНАЧЕНИЕ() работает и с предопределёнными элементами справочников, и с пустыми ссылками (ЗНАЧЕНИЕ(Перечисление.СтавкиНДС.ПустаяСсылка)), что удобно для поиска незаполненных полей.

Проверка через параметр запроса

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Заказы.Ссылка
|ИЗ
|	Документ.ЗаказКлиента КАК Заказы
|ГДЕ
|	Заказы.Статус = &Статус";

Запрос.УстановитьПараметр("Статус", Перечисления.СтатусыЗаказов.ВРаботе);
Результат = Запрос.Выполнить();

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

Для отбора по нескольким значениям перечисления удобно передать массив или список значений и использовать оператор В (&СписокСтатусов) вместо цепочки условий ИЛИ.

Запрос.УстановитьПараметр("Статусы", СтатусыМассив);
// В тексте запроса: ГДЕ Заказы.Статус В (&Статусы)

Проверка типа поля: перечисление это или нет

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

Для этого в языке запросов есть оператор ССЫЛКА. Он проверяет тип значения поля:

ВЫБРАТЬ
Данные.ЗначениеСвойства КАК Значение
ИЗ
РегистрСведений.ДополнительныеСведения КАК Данные
ГДЕ
Данные.ЗначениеСвойства ССЫЛКА Перечисление.ВариантыОплаты

Такой запрос вернёт только те записи, где поле содержит ссылку именно на указанное перечисление. Комбинация НЕ ... ССЫЛКА позволяет, наоборот, отсечь значения этого типа. Учтите, что ССЫЛКА работает только со ссылочными типами — для примитивных типов (строка, число, дата) используется функция ТИПЗНАЧЕНИЯ() совместно с ТИП().

Проверка в СКД и динамических списках

В схеме компоновки данных и в отборах динамических списков действуют те же правила, но с нюансами. В тексте запроса СКД можно свободно использовать ЗНАЧЕНИЕ() — это самый простой способ жёстко зафиксировать условие.

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

ЭлементОтбора = Список.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Статус");
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
ЭлементОтбора.ПравоеЗначение = Перечисления.СтатусыЗаказов.Закрыт;
ЭлементОтбора.Использование = Истина;

Частая проблема в СКД: параметр отбора объявлен с типом «Строка», и пользователь вводит представление значения. Отбор не срабатывает, потому что строка не равна ссылке. Тип параметра должен быть «Ссылка» на соответствующее перечисление — тогда платформа сама предложит выбор из списка значений.

Проверка в коде без запроса

Если значение уже получено в переменную (например, реквизит объекта), запрос не нужен — сравнение выполняется напрямую в коде. Здесь работает обычное равенство:

Если Заказ.Статус = Перечисления.СтатусыЗаказов.ВРаботе Тогда
// действия для статуса "В работе"
КонецЕсли;

Для проверки, что произвольное значение относится к перечислениям вообще, используется Перечисления.ТипВсеСсылки().СодержитТип(ТипЗнч(Значение)). Это полезно в универсальных процедурах сериализации, обмена и печати, где тип входящего значения заранее неизвестен.

Ещё один вариант — проверка через метаданные: Метаданные.НайтиПоТипу(ТипЗнч(Значение)) вернёт объект метаданных, по которому можно определить, является ли тип перечислением и каким именно. Этот способ тяжелее, но даёт доступ к имени перечисления и списку его значений.

Как проверить результат и отладить запрос

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

Полезный приём — временно вывести проверяемое поле в выборку вместе с его типом: добавьте в список полей ТИПЗНАЧЕНИЯ(Поле) КАК ТипПоля. Это сразу покажет, какие значения реально хранятся в базе и совпадает ли тип с ожидаемым.

При подозрении на незаполненные данные проверьте поле на пустую ссылку и на NULL (актуально для соединений таблиц): Поле ЕСТЬ NULL и Поле = ЗНАЧЕНИЕ(Перечисление.Имя.ПустаяСсылка) — это разные состояния, и обрабатывать их нужно отдельно.

FAQ