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

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

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

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

Когда перечисление — правильный выбор

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

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

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

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

Откройте конфигурацию в конфигураторе (меню «Конфигурация — Открыть конфигурацию»). В дереве объектов найдите ветку «Перечисления», нажмите правой кнопкой мыши и выберите «Добавить». Платформа откроет палитру свойств нового объекта.

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

Обратите внимание на свойство «Быстрый выбор»: если оно включено, значение в поле ввода выбирается из выпадающего списка без открытия отдельной формы. Для перечислений это обычно удобно и включено по умолчанию.

Добавление и настройка значений

Состав значений задаётся на закладке «Данные» в палитре свойств перечисления. Нажмите кнопку добавления и введите имя значения — оно, как и имя объекта, используется в программном коде. Например, для перечисления «СтатусыЗаказа» значения могут называться «Новый», «ВРаботе», «Выполнен», «Отменён».

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

Порядок значений в списке имеет значение: именно в нём значения показываются пользователю при выборе и участвуют в операциях сравнения «больше/меньше» в запросах. Располагайте значения в логичной последовательности — например, статусы по ходу жизненного цикла документа.

Использование перечисления в реквизитах объектов

Чтобы документ или справочник мог хранить значение перечисления, добавьте в объект реквизит и укажите его тип — «ПеречислениеСсылка.ИмяПеречисления». Например, в документе «ЗаказКлиента» создайте реквизит «Статус» с типом «ПеречислениеСсылка.СтатусыЗаказа».

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

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

Работа с перечислением в коде

Обращение к значению перечисления в модуле выполняется через менеджер: Перечисления.СтатусыЗаказа.Выполнен. Такая конструкция возвращает ссылку на значение, которую можно присваивать реквизитам, сравнивать и передавать в запросы.

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

У перечисления есть служебное значение «ПустаяСсылка» — оно возвращается, если реквизит не заполнен. Проверка на незаполненность: Если Объект.Статус = Перечисления.СтатусыЗаказа.ПустаяСсылка() Тогда ... или функция ЗначениеЗаполнено(Объект.Статус).

Если Документ.Статус = Перечисления.СтатусыЗаказа.Отменён Тогда
    Сообщить("Заказ отменён, проведение запрещено");
    Отказ = Истина;
КонецЕсли;

В запросах значение перечисления передаётся через параметр: Запрос.УстановитьПараметр(\"Статус\", Перечисления.СтатусыЗаказа.Выполнен);. Также в тексте запроса доступна конструкция ЗНАЧЕНИЕ(Перечисление.СтатусыЗаказа.Выполнен), позволяющая указать значение без параметра.

Проверка результата и типичные ошибки

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

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

Ограничения и безопасные изменения

Главное ограничение — нельзя безопасно удалить значение перечисления, если оно уже записано в данных. В документах и регистрах останутся ссылки на удалённое значение, и при обращении к ним возникнут ошибки. Перед удалением выполните поиск ссылок на объект через сервис «Поиск ссылок на объекты» и замените значения в данных.

Добавление новых значений и изменение синонимов — безопасные операции, не затрагивающие существующие данные. Изменение порядка значений тоже безопасно для данных, но может повлиять на логику, если где-то в запросах используется сравнение значений на «больше/меньше».

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

Часто задаваемые вопросы