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

Другое · 8 мин

Перечисление в конфигурации 1С: для чего предназначено и как использовать

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

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

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

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

Что представляет собой объект конфигурации «Перечисление»

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

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

Для чего предназначены перечисления в прикладном решении

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

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

Сценарий: статусы документов

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

Сценарий: виды операций

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

Создание и заполнение предопределённых значений

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

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

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

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

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

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

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

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

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

Справочник

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

Перечисление или справочник: выбор и ограничения

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

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

Ограничения и риски при изменении перечислений

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

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

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

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

Реквизит типа перечисления
Норма

Выбираются только объявленные значения

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

Пользователь может ввести произвольный текст или отсутствуют нужные значения

Отбор по перечислению
Норма

Каждое значение возвращает ожидаемый набор документов

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

Пустой результат или несоответствие имён при обмене

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

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

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

Итог

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

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

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

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

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

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

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

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

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

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