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

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

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

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

Назначение и возможности объекта Перечисление

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

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

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

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

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

Пошаговая инструкция по созданию перечисления

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

Имя объекта задается на английском языке без пробелов, например, StatusDocument или PaymentType. Это имя будет использоваться в коде программиста, поэтому оно должно быть лаконичным и понятным. Синоним же заполняется на русском языке и отображается в интерфейсе пользователя.

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

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

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

Настройка свойств и параметров отображения

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

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

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

Для сложных сценариев можно включить опцию Разрешить редактирование, но это делается крайне редко и требует написания дополнительного кода для контроля целостности данных. В стандартных конфигурациях 1С:Бухгалтерия или 1С:УТ перечисления почти всегда заблокированы для изменения пользователем.

Использование перечислений в программном коде

Работа с перечислениями в языке 1С максимально упрощена благодаря строгой типизации. Для обращения к конкретному элементу используется конструкция Перечисления.ИмяПеречисления.ИмяЭлемента. Это позволяет компилятору проверять корректность кода еще на этапе написания.

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

ТекущаяОперация = Перечисления.ВидыОпераций.Покупка;
Если ТекущаяОперация = Перечисления.ВидыОпераций.Продажа Тогда
Сообщить("Это продажа");
КонецЕсли;

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

⚠️ Внимание: При сравнении значений перечислений всегда используйте строгое равенство. Попытка сравнить значение перечисления с обычной строкой приведет к ошибке выполнения или логической неверности результата.

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

Заполнение данных и работа с формами

При размещении реквизита типа перечисление на форме системы 1С:Предприятие, интерфейс автоматически подстраивается под тип данных. Пользователь увидит классический выпадающий список (ComboBox), в котором отображаются синонимы элементов.

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

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

Для каждого Элемент Из Перечисления.ВидыДвижений Цикл
НоваяСтрока = Документ.Движения.Добавить();
НоваяСтрока.Вид = Элемент;
НоваяСтрока.Сумма = 0;
КонецЦикла;

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

Сравнение перечислений и справочников

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

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

Характеристика	Перечисление	Справочник
Хранение данных	В конфигурации	В информационной базе
Редактирование	Только в конфигураторе	В режиме предприятия
Доп. реквизиты	Нет	Неограниченно
Иерархия	Отсутствует	Поддерживается
Производительность	Максимальная	Зависит от объема

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

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

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

Частые ошибки и рекомендации экспертов

Одной из распространенных ошибок является создание слишком громоздких перечислений. Если список превышает 20-30 элементов, управлять им становится неудобно, а интерфейс формы перегружается. В таких случаях лучше сгруппировать данные или пересмотреть архитектуру в сторону справочников.

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

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

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

Можно ли использовать перечисления в запросах 1С?

Да, можно. В тексте запроса значения перечислений подставляются автоматически при использовании параметров или напрямую через конструктор. Например: ВЫБРАТЬ Документ.Вид ИЗ Документ.Заказ ГДЕ Документ.Вид = &ВидЗаказа, где параметр имеет тип перечисления.

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

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

Как переименовать элемент перечисления без потери данных?

Переименование элемента в конфигураторе (изменение имени на английском) безопасно для данных, так как внутренняя ссылка остается неизменной. Однако, если вы меняете Синоним, это отразится только на интерфейсе и не затронет логику работы программы.

Есть ли ограничение на количество элементов в перечислении?

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

Можно ли сделать перечисление иерархическим?

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