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

Другое · 6 мин

Перечисление в 1С: что это, для чего нужно и как работает

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

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

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

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

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

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

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

Перечисление

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

Справочник

Подходит если список должен пополняться пользователями в режиме предприятия

Константа

Подходит когда нужно хранить одно значение, а не список вариантов

Типичные области применения: статусы сделок, виды документов, способы расчёта, группы номенклатуры, состояния задач и признаки готовности отчёта. В форме пользователь видит понятное представление, а в базе и коде используется программное имя значения.

Отличие перечисления от справочника, константы и плана обмена

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

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

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

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

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

1C
Если Документ.Статус = Перечисления.СтатусыЗаказа.Оплачен Тогда

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

Использование перечислений в коде и формах

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

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

Ограничения, риски и проверка при изменении значений

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

Типичные ошибки
01
Использование представления значения вместо программного имени в коде, что ломается при переименовании
02
Изменение программного имени значения после начала эксплуатации, что делает старые данные некорректными
03
Удаление используемого значения без анализа ссылок из документов и отчётов

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

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

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

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

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

Список открывается и значение сохраняется

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

Значение отсутствует или не сохраняется

Код обращается к значению по программному имени
Норма

Компиляция и выполнение проходят без ошибок

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

Ошибка компиляции или пустое значение при выполнении

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

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

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

Итог

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

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

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

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

Чем перечисление отличается от справочника?

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

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

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