Как правильно обращаться к перечислению в 1С: от базовых методов до продвинутых приёмов

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

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

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

1. Что такое перечисление в 1С и зачем оно нужно

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

• 📌 Статусы документов: "Черновик", "Проведён", "Отменён"
• 📌 Виды операций: "Поступление", "Списание", "Перемещение"
• 📌 Типы контрагентов: "Поставщик", "Покупатель", "Комиссионер"
• 📌 Уровни доступа: "Администратор", "Менеджер", "Гость"

Основные преимущества перечислений:

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

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

2. Базовые способы обращения к перечислению

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

ТекущийВид = Перечисления.ВидыДокументов.Поступление;

Этот метод работает во всех контекстах — на сервере, клиенте и в тонком клиенте. Однако он требует, чтобы имя перечисления было известно на этапе написания кода. Если имя динамическое (например, хранится в переменной), точечная нотация не подойдёт.

Альтернативный вариант — использование функции Перечисление():

ТекущийВид = Перечисление("ВидыДокументов.Поступление");

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

Это сократит код и улучшит его читаемость.-->

3. Работа с перечислениями в запросах

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

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

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

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

Важный нюанс: в запросах нельзя использовать точечную нотацию напрямую (например, Перечисления.ВидыДокументов.Поступление). Это приведёт к ошибке компиляции. Также стоит помнить, что значения перечислений в результатах запросов возвращаются как объекты, а не как строки.

Если вам нужно получить строковое представление значения перечисления в запросе, используйте функцию ПРЕДСТАВЛЕНИЕ():

ВЫБРАТЬ
ПРЕДСТАВЛЕНИЕ(ВидДокумента) КАК ВидДокументаСтрока

4. Динамическое получение значений перечислений

Иногда требуется получить все возможные значения перечисления программно — например, для заполнения списка выбора или валидации данных. Для этого можно использовать метод ЗначенияПеречисления():

ЗначенияВидов = Перечисления.ВидыДокументов.ЗначенияПеречисления();
Для Каждого Значение Из ЗначенияВидов Цикл
Сообщить(Значение.Представление());
КонецЦикла;

Этот метод возвращает коллекцию всех значений перечисления, которую можно обойти в цикле. Если вам нужно проверить, существует ли конкретное значение в перечислении, используйте функцию ЭтоЗначениеПеречисления():

Если ЭтоЗначениеПеречисления(Перечисления.ВидыДокументов, "НесуществующееЗначение") Тогда
Сообщить("Значение существует!");
Иначе
Сообщить("Значение отсутствует!");
КонецЕсли;

Для динамического получения перечисления по имени (например, если имя хранится в переменной) используйте функцию Метаданные().Перечисление():

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

Имя перечисления существует в конфигурации|Значение перечисления существует|Права доступа позволяют читать метаданные|Учёт регистра при сравнении строковых имён-->

5. Типовые ошибки при работе с перечислениями

Даже опытные разработчики иногда допускают ошибки при работе с перечислениями. Вот наиболее распространённые из них и способы их избежать:

Одна из самых коварных ошибок — сравнение перечислений через "=" в запросах без функции ЗНАЧЕНИЕ(). Например, такой код вызовет ошибку:

// НЕПРАВИЛЬНО!
ВЫБРАТЬ *
ИЗ Документ.ПоступлениеТоваров
ГДЕ ВидДокумента = Перечисления.ВидыДокументов.Поступление

Платформа не может автоматически преобразовать объект перечисления в значение для запроса. Всегда используйте ЗНАЧЕНИЕ()!

6. Продвинутые приёмы: расширения, обмен данными и производительность

При работе с большими объёмами данных или в распределённых системах возникают дополнительные нюансы. Например, при обмене данными через Универсальный формат обмена значения перечислений сериализуются в XML как строки с указанием UID. Если UID в принимающей базе не совпадает, данные могут не загрузиться.

Для решения этой проблемы можно:

1. Синхронизировать UID объектов конфигурации между базами (через выгрузку/загрузку .cf файлов).
2. Использовать строковые представления значений и сопоставлять их вручную при загрузке.
3. Заменить перечисления на справочники, если состав значений может меняться.

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

// Кеширование значений перечисления для ускорения доступа
ПеречСтатусы = Перечисления.СтатусыДокументов;
СтатусПроведён = ПеречСтатусы.Проведён;
СтатусОтменён = ПеречСтатусы.Отменён;

В управляемых формах перечисления часто используются для заполнения элементов выбора (например, ПолеВыбора). Чтобы динамически обновить список значений, используйте метод ЗаполнитьЗначениями():

ЭлементыФормы.СписокСтатусов.ЗаполнитьЗначениями(Перечисления.СтатусыДокументов);

7. Альтернативы перечислениям: когда их лучше не использовать

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

• 🔄 Динамический состав значений: если набор значений может изменяться в процессе работы (например, пользователи должны добавлять новые виды операций), используйте справочник.
• 🔄 Сложная иерархия: если значения нужно группировать или строить деревья (например, "Категории товаров → Подкатегории"), подойдёт иерархический справочник.
• 🔄 Мультиязычность: если представления значений должны переводиться на несколько языков, используйте справочник с реквизитом "Наименование" и механизм перевода.
• 🔄 Большой объём данных: если значений сотни или тысячи, перечисления станут неудобны для поддержки (придётся обновлять конфигурацию при каждом изменении).

Пример замены перечисления на справочник:

1. Создайте справочник ВидыОпераций с реквизитом Код (тип Строка).
2. Заполните справочник начальными данными (можно через обработку загрузки).
3. Замените в коде все обращения к Перечисления.ВидыОпераций на выборку из справочника.

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

FAQ: Ответы на частые вопросы

СтрокаСтатуса = Перечисления.СтатусыДокументов.Проведён.Представление();

ЗначениеДляОтправки = Перечисления.ВидыДокументов.Поступление.Представление();
// или
ЗначениеДляОтправки = Перечисления.ВидыДокументов.Поступление.УникальныйИдентификатор();

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