Создание нового перечисления в 1С: полное руководство

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

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

Концепция и назначение перечислений в платформе

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

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

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

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

Пошаговый алгоритм создания объекта в конфигураторе

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

Имя перечисления должно соответствовать правилам именования идентификаторов в 1С: начинаться с буквы, не содержать пробелов и специальных символов. Синоним же будет отображаться в интерфейсе программы, поэтому его следует формулировать понятно для конечного пользователя, например, «Статусы заказов» вместо «СтатусыЗаказов».

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

Настройка свойств и режимов совместимости

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

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

Отдельного упоминания заслуживает настройка «Использование стандарта». Для новых разработок в режиме управляемого приложения рекомендуется использовать стандартные механизмы платформы, отказываясь от устаревших флагов совместимости. Это обеспечивает лучшую производительность и поддержку будущих версий 1С:Предприятие.

Свойство	Значение по умолчанию	Рекомендация
Право доступа	Полный	Оставлять полным, если не требуется скрытие
Глобальное	Нет	Да, для общих списков (Валюты, Виды оплат)
Режим совместимости	Такси / Обычное	Использовать актуальный режим Такси
Комментарий	Пусто	Заполнять для документации кода

Работа с предопределенными значениями

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

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

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

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

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

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

Интеграция перечислений в формы и отчеты

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

В отчетах и запросах перечисления используются для фильтрации данных. В языке запросов 1С обращение к значению перечисления выглядит как ЗНАЧЕНИЕ(Перечисление.Статусы.ВРаботе). Это позволяет писать типобезопасный код, который компилятор может проверить на наличие ошибок еще до запуска программы.

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

Использование в программном коде и типизация

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

Типизация переменных также выигрывает от использования перечислений. Объявляя переменную как ПеречислениеСсылка.ВидыОпераций, вы сужаете область допустимых значений, что помогает встроенному редактору кода предлагать автоподстановку (Autocomplete). Это снижает вероятность опечаток и логических ошибок.

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

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

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

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

В чем главное отличие перечисления от справочника с одним уровнем?

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

Как обращаться к элементу перечисления из внешнего кода или COM-соединения?

При работе через COM-соединение или внешние обработки необходимо использовать полное имя объекта в формате Перечисления.ИмяПеречисления.ИмяЭлемента. Важно учитывать, что имена должны совпадать с теми, что заданы в конфигураторе, регистр букв имеет значение в зависимости от настроек платформы, но обычно рекомендуется использовать латиницу для имен идентификаторов.

Что делать, если нужно добавить новый статус в работающую базу без остановки работы?

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