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

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

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

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

Почему прямое обращение к перечислению не работает на клиенте

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

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

Понимание этого разделения важно и при директивах компиляции. Процедура с директивой &НаКлиенте компилируется отдельно, и платформа проверяет доступность каждого обращения именно для клиентского контекста.

Основной способ — функция ПредопределенноеЗначение

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

&НаКлиенте
Процедура ПриОткрытии(Отказ)
Ставка = ПредопределенноеЗначение("Перечисление.СтавкиНДС.НДС20");
Сообщить(Ставка);
КонецПроцедуры

Функция не выполняет запрос к базе данных — значение подставляется из кэша предопределённых данных, поэтому вызывать её можно в циклах и обработчиках событий без потери производительности. Это ключевое отличие от серверных вызовов, где каждый обход границы «клиент–сервер» стоит заметного времени.

Если указанное имя не существует (опечатка, значение удалено из конфигурации), функция вернёт Неопределено, а не вызовет исключение. Поэтому результат стоит проверять перед использованием в сравнениях и присваиваниях.

Ставка = ПредопределенноеЗначение("Перечисление.СтавкиНДС.НДС20");
Если Ставка = Неопределено Тогда
    ВызватьИсключение "Значение перечисления не найдено";
КонецЕсли;

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

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

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

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

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

Получение значения через серверный вызов

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

&НаСервереБезКонтекста
Функция ПолучитьЗначениеПеречисления(ИмяПеречисления, ИмяЗначения) Экспорт
Возврат Перечисления[ИмяПеречисления][ИмяЗначения];
КонецФункции

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

Стандартный приём — получить значение один раз (например, при создании формы на сервере в обработчике ПриСозданииНаСервере) и сохранить в реквизит формы. Дальше клиентский код работает с реквизитом без дополнительных обращений.

1. 1
   Создайте общий модуль с флагами «Сервер» и «Вызов сервера»
2. 2
   Добавьте экспортную функцию, возвращающую значение перечисления
3. 3
   Вызовите её из клиентской процедуры один раз — например, при открытии формы
4. 4
   Сохраните результат в реквизит формы или переменную модуля формы
5. 5
   Проверьте, что повторные обращения идут к сохранённому значению, а не к серверу

Динамическое имя значения и проверка существования

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

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

Строгая проверка существования значения через метаданные (Метаданные.Перечисления) доступна только на сервере. Если конфигурация развивается и имена значений могут меняться, имеет смысл валидировать список допустимых имён один раз на сервере и передавать на клиент готовое соответствие «имя — значение».

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

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

Самая частая ошибка — перенос кода из серверной процедуры в клиентскую без замены обращения Перечисления.Имя.Значение. Модуль не компилируется, и форма перестаёт открываться. Лечится заменой на ПредопределенноеЗначение() с полным строковым именем.

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

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

Проверка результата и ограничения

После получения значения убедитесь, что оно не Неопределено и имеет ожидаемый тип. Проверить тип можно через ТипЗнч() и сравнение с Тип("ПеречислениеСсылка.ИмяПеречисления") — это тоже работает на клиенте.

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

Ограничения, о которых стоит помнить: веб-клиент накладывает те же ограничения, что и тонкий; код с директивой &НаКлиенте в мобильном клиенте имеет ещё более узкий контекст; значения перечислений нельзя создавать программно — только выбирать из предопределённых в конфигурации.

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