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

Другое · 6 мин

Перечисление в 1С: определение, применение и работа со значениями

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

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

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

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

Что представляет собой перечисление в 1С

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

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

Где применяются перечисления

Типичные примеры: статус документа (ЧерныйЧерновик, Проведен, Замкнут), вид номенклатуры (Товар, Услуга, Себестоимость), способ расчета (Наличие, Безналичный, Взаимозачет). Перечисления удобны в отборах отчетов, правилах условного оформления и бизнес-процессах, где нужно жестко фиксировать допустимые состояния.

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

Создание и редактирование значений

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

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

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

Работа с перечислениями в коде 1С

Обращение к значению выполняется через имя перечисления и имя значения, например: Перечисления.СтатусЗаказа.Оплачен. В условии можно писать: Если Статус = Перечисления.СтатусЗаказа.Оплачен Тогда. Это делает логику прозрачной и упрощает поддержку.

Перечисление можно использовать в параметрах запросов и отборов, но Сравнение со строкой может не сработать даже при одинаковом текстовом представлении.

Ограничения и риски

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

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

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

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

Значение доступно в списке выбора
Норма

Элемент отображается с корректным представлением

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

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

Код корректно обрабатывает значение
Норма

Срабатывает ожидаемая ветка условия

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

Попадает в ветку по умолчанию или ошибка типа

Проверка результата и выбор варианта

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

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

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

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

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

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

Итог

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

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

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

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

В чем разница между перечислением и справочником?

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

Безопасно ли переименовывать значение перечисления?

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

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

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