Другое · 5 мин
Перечисления в 1С: практическое использование
Как использовать перечисления 1С: способы обращения к значениям, применение в реквизитах и формах, проверка результата и типичные ошибки при работе с конфигурацией 1С.
Перечисление в 1С — это набор заранее описанных константных значений, которые могут использоваться в реквизитах объектов, условиях отборов и программном коде. Каждое значение перечисления имеет фиксированное имя и относится к определённому типу, что позволяет избежать ошибок при вводе текста вручную.
Основное отличие перечисления от обычной строки или числа в том, что значение привязано к метаданным конфигурации. Если в коде обратиться к несуществующему элементу, платформа выдаст ошибку ещё при проверке синтаксиса или выполнении, что упрощает поиск опечаток.
Перечисления удобно использовать, когда список возможных вариантов известен заранее и редко меняется: виды номенклатуры, статусы документов, способы оплаты, группы контрагентов по признакам и т. п. Для часто пополняемых списков лучше использовать справочники, а не перечисления.
Что представляет собой перечисление в 1С
Перечисление создаётся в конфигураторе как отдельный объект метаданных. В его составе перечисляются значения, каждое из которых имеет синоним для отображения в интерфейсе и имя для обращения в коде. Тип данных значения совпадает с типом самого перечисления.
Значения перечисления нельзя создать напрямую в пользовательском режиме обычным вводом: они настраиваются разработчиком или администратором конфигурации. Пользователь обычно только выбирает одно из допустимых значений в форме документа, справочника или отчёта.
Где применяются перечисления
Перечисления добавляют в качестве типа реквизита документа, справочника, плана обмена или регистра. Например, реквизит «Статус» документа может иметь тип перечисления «СтатусыЗаказов» со значениями «Новый», «В обработке», «Завершён».
На формах такие реквизиты отображаются как поля выбора с выпадающим списком. В отчётах и обработках значения перечисления используются в отборах, группировках и условном оформлении, что позволяет разделять данные по категориям без ввода текста.
Перечисление.ВидыНоменклатуры.ТоварКак обращаться к значениям в коде
В коде обращение к значению выполняется через имя перечисления, точку и имя значения. Регистр и точное написание имеют значение, поэтому опечатка приведёт к ошибке компиляции или выполнения.
Значения можно сравнивать между собой, передавать в параметры процедур и функций, использовать в операторах Если,_CASE_ и циклах. При сравнении важно использовать именно ссылку на значение перечисления, а не его строковое представление.
Использование в объектах конфигурации и формах
При создании реквизита с типом перечисление платформа автоматически ограничивает ввод допустимыми значениями. В форме элемента справочника или документа такое поле обычно выглядит как список с фиксированным набором вариантов.
Если необходимо изменить доступные значения, вносит правки в конфигурацию: добавляет, переименовывает или удаляет элементы перечисления. После изменения конфигурацию нужно обновить и проверить, где использовались удалённые или переименованные значения.
Ограничения и риски при изменении перечислений
Удаление значения перечисления, которое уже встречается в данных, может привести к некорректному отображению документов, отчётов или нарушению логики обработок. Переименование значения тоже может сломать код, если в программе используется старое имя.
Безопаснее добавлять новые значения, чем удалять существующие. Если значение больше не нужно, лучше оставить его в перечислении, но перестать предлагать пользователям в интерфейсе, либо заменить на новое через обработку переноса данных.
Как проверить результат
Все ожидаемые значения доступны для выбора
Отсутствуют нужные значения или появляются некорректные
Значение сохраняется и отображается после чтения
Ошибка при сохранении или значение сбрасывается
Каждое значение ведёт себя предсказуемо
Необработанное значение или ошибка типа
Как проверить корректную работу перечисления
После добавления или изменения перечисления нужно открыть форму объекта с реквизитом этого типа и убедиться, что в списке отображаются ожидаемые значения. Выбор любого значения должен сохраняться без ошибок.
В коде стоит проверить условия, где используется перечисление, на всех возможных значениях. Если какое-то значение не обрабатывается, программа должна либо обрабатывать его явно, либо иметь ветку по умолчанию.
Что важно запомнить
Перечисления подходят для фиксированных списков, обращаются к ним через имя и точку, а удаление или переименование используемых значений требует осторожности и проверки ссылок.
Можно ли создать значение перечисления пользователем в рабочей базе?
Обычно нет. Значения перечисления настраиваются в конфигураторе, а пользователь только выбирает из уже заданных вариантов. Для пользовательского пополнения списка лучше использовать справочник.
Чем перечисление отличается от справочника?
Перечисление содержит жёстко заданный набор значений в метаданных, а справочник позволяет добавлять, редактировать и удалять элементы в обычном режиме работы. Справочник подходит для часто меняющихся списков.
Что будет, если удалить значение перечисления, которое уже есть в документах?
Могут возникнуть ошибки при чтении старых документов, отображении отчётов или выполнении обработок, которые ссылаются на удалённое значение. Перед удалением нужно проверить все места использования.
Как правильно сравнивать значения перечисления в коде?
Нужно сравнивать ссылки на значения перечисления между собой, например через оператор равно, а не приводить их к строкам. Это гарантирует корректную работу даже при изменении синонимов в интерфейсе.
Нужно ли обновлять конфигурацию после изменения перечисления?
Да, после добавления, переименования или удаления элементов перечисления конфигурацию необходимо обновить и проверить объекты, где используется изменённый тип, а также формы и отчёты.