К статье
Практический материал

Другое · 7 мин

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

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

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

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

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

Что такое перечисление на клиенте и где оно используется

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

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

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

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

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

Поле на формеЗначение видно в реквизите

Проверьте, привязана ли форма к объекту и заполнено ли поле

Сравнение в кодеПеречисления.Имя.Элемент

Убедитесь, что имя перечисления и элемента написаны верно

Вывод пользователюСтроковое представление

Проверьте, отображается ли понятное наименование, а не внутренний код

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

Как получить строковое представление и вывести в форму

Для показа пользователю значение перечисления преобразуют в строку. На клиенте это делается через приведение к строке или получение представления, в зависимости от контекста формы. Полученную строку можно вывести в поле формы, сообщение или печатную форму.

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

Порядок действий
  1. 1
    Убедитесь, что форма привязана к объекту и реквизит перечисления добавлен на форму
  2. 2
    Обратитесь к значению через реквизит или через Перечисления.Имя.Элемент
  3. 3
    Проверьте значение на заполненность перед использованием
  4. 4
    При необходимости получите строковое представление для вывода пользователю
  5. 5
    Сравните результат с ожидаемым элементом перечисления

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

Когда значение нужно получить из базы или справочника

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

При получении из базы учитывайте права доступа. Если пользователю запрещено читать справочник или регистр, на клиенте значение не вернётся или вернётся пустое. В таких случаях лучше обрабатывать отсутствие прав явно, а не пытаться обойти ограничение на клиенте.

Ограничения и права доступа на клиенте

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

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

Частые ошибки и проверка результата

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

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

Типичные ошибки
01
Сравнение значения перечисления со строкой вместо элемента перечисления
02
Использование числового кода элемента вместо символьного имени
03
Чтение представления на клиенте без серверного вызова там, где оно недоступно
04
Отсутствие проверки на пустоту перед записью или проведением

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

Альтернативы и границы безопасной работы

Если прямой доступ к перечислению на клиенте затруднён, можно использовать общий модуль с серверной функцией, которая возвращает нужное значение или представление. Это отделяет логику от интерфейса и упрощает поддержку при изменении конфигурации.

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

Итог

Что важно запомнить

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

Можно ли сравнивать значение перечисления с текстом?

Не рекомендуется. Сравнение должно выполняться с элементом перечисления, например Перечисления.Имя.Элемент. Текстовое наименование может измениться или отличаться в зависимости от языка интерфейса.

Что делать, если на клиенте значение перечисления пустое?

Сначала проверьте, заполнён ли реквизит и есть ли права на чтение объекта. Если поле обязательное, сообщите пользователю о необходимости заполнить его перед сохранением или проведением.

Нужен ли серверный вызов для получения перечисления?

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

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

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

Может ли клиент сам изменить состав перечисления?

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