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

Другое · 10 мин

Перечисления в 1C: назначение, применение и отличие от справочников

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

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

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

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

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

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

Что такое перечисление в конфигурации 1C

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

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

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

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

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

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

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

Где перечисления используются: формы, отчёты, запросы

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

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

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

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

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

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

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

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

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

Справочник

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отображение нового значения в форме
Норма

Значение есть в выпадающем списке и сохраняется

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

Значение отсутствует или вызывает ошибку при сохранении

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

Группировка и отбор работают корректно

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

Данные не попадают в группы или отчёт пуст

Обработка в коде
Норма

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

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

Программа завершается с ошибкой на новом значении

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

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

Итог

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

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

Частые вопросы о перечислениях

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

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

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

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

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

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

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

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

Что делать после обновления конфигурации с изменёнными перечислениями?

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