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

Другое · 7 мин

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

Разберём, как получить значение перечисления в 1С: через метаданные, по строке, сравнение элементов и проверку результата в коде для пользователей платформы.

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

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

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

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

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

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

Пример прямого обращения может выглядеть так:

МояПеременная = Перечисления.СтатусЗаказа.Новый;

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

Способы обращения к элементам перечисления

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

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

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

Сравнение вариантов

Прямое обращение к элементу

Подходит, когда имя известно заранее; надёжно и просто в поддержке

Получение по строке

Подходит для динамических имён из импорта или ввода; требует проверки результата преобразования

Получение значения по строке и обратное преобразование

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

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

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

Проверка и сравнение значений перечисления

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

Контрольные точки

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

Значение переменной после присваивания
Норма

Содержит элемент перечисления нужного типа

Тревожный признак

Пустое значение или строка вместо элемента

Сравнение двух элементов
Норма

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

Тревожный признак

Ошибка типов или неожиданный результат при разных перечислениях

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

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

Типичные ошибки
01
Использование текстового имени вместо значения перечисления без преобразования
02
Сравнение значений разных перечислений или зависимость от порядка элементов может привести к ошибке.
03
Перенос значений перечисления между базами с разными конфигурациями

Ограничения и частые ошибки

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

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

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

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

Когда обращаться к разработчику или администратору

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

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

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

Итог

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

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

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

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

Что делать, если элемент перечисления не найден по строке?

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

Зависит ли строковое представление от языка интерфейса?

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

Безопасно ли копировать значения перечисления между базами?

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