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

Другое · 8 мин

Перечисления в 1С: что это, зачем нужны и как с ними работать

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

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

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

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

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

Что такое перечисление и зачем оно нужно

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

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

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

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

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

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

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

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

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

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

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

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

Справочники и перечисления: когда что выбирать

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

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

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

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

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

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

Справочник

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

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

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

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

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

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

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

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

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