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