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

В системе 1С:Предприятие перечисления — это один из базовых объектов конфигурации, который часто остаётся в тени более сложных механизмов, но при этом играет ключевую роль в структурировании данных. Если вы когда-нибудь видели в форме документа выпадающий список с фиксированными значениями (например, «Мужской/Женский», «Да/Нет», «Новый/Б/У»), то скорее всего это было реализовано именно через перечисление. Без них многие бизнес-процессы в 1С потеряли бы логическую стройность, а интерфейс стал бы менее интуитивным.

Перечисления решают две ключевые задачи: обеспечивают целостность данных за счёт ограниченного набора значений и упрощают работу пользователей, предлагая готовые варианты вместо ручного ввода. Например, в модуле «Зарплата и кадры» статус сотрудника («Работает», «В отпуске», «Уволен») чаще всего реализуется через перечисление — это исключает ошибки при вводе и ускоряет обработку данных. Однако у этого инструмента есть нюансы: от различий между простыми и иерархическими перечислениями до особенностей хранения в базе данных. Разберём всё по порядку.

Что такое перечисление в 1С и зачем оно нужно

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

Основные преимущества перечислений:

• 🔒 Контроль целостности: исключают опечатки и некорректные значения (например, вместо «Да» пользователь не сможет ввести «ДА» или «даа»).
• ⚡ Быстродействие: значения хранятся в памяти, а не в базе данных, что ускоряет доступ.
• 🎨 Удобство интерфейса: автоматически формируют выпадающие списки в формах.
• 🔄 Локализация: поддерживают многоязычные синонимы (например, «Male» и «Мужской» для одного значения).

Типичные примеры использования:

• 📌 Статусы документов: «Черновик», «Проведён», «Отменён».
• 📌 Виды оплат: «Наличные», «Безналичный расчёт», «Карта».
• 📌 Типы контрагентов: «Поставщик», «Покупатель», «Партнёр».
• 📌 Единицы измерения: «Штука», «Килограмм», «Метр».

Виды перечислений: простые vs иерархические

В 1С:Предприятие 8 существует два типа перечислений, которые отличаются структурой и областями применения:

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

⚠️ Внимание: В версиях 1С:Предприятие ниже 8.3.10 составной тип значений перечислений не поддерживается. Перед использованием проверьте версию платформы в меню Справка → О программе.

Как создать перечисление в конфигураторе: пошаговая инструкция

Рассмотрим процесс создания простого перечисления на примере 1С:Предприятие 8.3. Для этого:

1. Откройте конфигуратор в режиме 1С:Предприятие (для этого запустите базу с ключом /Config или выберите «Конфигуратор» в меню запуска).

2. В дереве объектов найдите ветку Общие → Перечисления и кликните правой кнопкой мыши. Выберите Добавить.

3. Введите имя перечисления (например, ВидыОплат) и нажмите Enter.

4. В панели свойств заполните:

   • 📝 Синоним: «Виды оплат» (отображается в интерфейсе).
   • 📝 Комментарий: «Способы оплаты заказов».
   • 📝 Иерархическое: снимите флажок (для простого перечисления).

Наличные
БезналичныйРасчёт
Карта
ЭлектронныеДеньги

Имя перечисления латиницей без пробелов|

Синонимы заполнены для всех значений|

Нет дублирующихся значений|

Права доступа настроены (если нужно)-->

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

Значение = Перечисления.ВидыОплат.Наличные;

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

Перечисления в 1С — это не только статичные списки, но и полноценные объекты, с которыми можно работать программно. Вот ключевые операции:

1. Получение значения по имени

Чтобы обратиться к элементу перечисления, используйте точечную нотацию:

ТекущийВидОплаты = Перечисления.ВидыОплат.Карта;

2. Проверка типа

Чтобы убедиться, что переменная содержит значение перечисления, используйте функцию ТипЗнч():

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

3. Перебор всех значений

Для итерации по элементам перечисления подходит цикл Для каждого:

Для Каждого ВидОплаты Из Перечисления.ВидыОплат Цикл
Сообщить(ВидОплаты.Представление());
КонецЦикла;

4. Сравнение значений

Перечисления поддерживают операторы сравнения (=, <>), но ВидыОплат.Наличные Тогда

// Логика для наличной оплаты

КонецЕсли;

5. Работа с составными типами (8.3.10+)

В новых версиях платформы перечисления могут хранить дополнительные данные. Например, для значения «Карта» можно указать Приоритет = 2:

Значение = Перечисления.ВидыОплат.Карта;
Приоритет = Значение.Приоритет; // Вернёт 2

Типичные ошибки при работе с перечислениями и как их избежать

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

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

1. Путаница между представлением и внутренним именем

Внутреннее имя значения (например, Наличные) и его представление (например, «Наличный расчёт») — это разные вещи. Ошибка возникает, когда в коде сравнивают строковое представление вместо ссылки:

// НЕПРАВИЛЬНО:
Если Строка(ТекущийВидОплаты) = "Наличные" Тогда
// Такой код сломается при изменении синонима!

// ПРАВИЛЬНО:
Если ТекущийВидОплаты = Перечисления.ВидыОплат.Наличные Тогда
// Работает стабильно

2. Изменение перечислений в работающей базе

Если вы удалите значение из перечисления, которое уже используется в документах, 1С не сможет корректно загрузить эти документы. Решение:

• 🔄 Сначала перенесите данные на новое значение (например, через обработку).
• 🗑️ Удалите старые значения только после очистки ссылок.
• 🔄 Используйте механизм ПоддержкаВерсий для совместимости.

3. Неучёт локализации

Если в конфигурации несколько языков, не забывайте заполнять синонимы для всех значений. Иначе пользователи увидят внутренние имена (например, Cash вместо «Наличные»).

Что делать, если перечисление "сломалось" после обновления?

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

1. Проверьте, не изменились ли внутренние имена значений в новой версии.

2. Запустите тестирование и исправление базы (Администрирование → Тестирование и исправление).

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

4. В крайнем случае восстановите данные из резервной копии.

Перечисления vs справочники: когда что использовать

Новички часто путают перечисления и справочники, ведь оба хранят наборы значений. Однако у них принципиальные различия:

Критерий	Перечисление	Справочник
Изменяемость	Значения задаются при разработке, не редактируются пользователями.	Пользователи могут добавлять/удалять элементы.
Хранение	В метаданных конфигурации (не в базе данных).	В таблицах базы данных.
Производительность	Быстрее, так как значения кэшируются.	Медленнее при больших объёмах данных.
Пример использования	Статусы документов, виды операций.	Список контрагентов, номенклатура.

Выбор между перечислением и справочником зависит от задачи:

• 🔹 Используйте перечисление, если:
  • Набор значений постоянный (например, дни недели).
  • Нужна максимальная производительность (значения часто читаются в коде).
  • Важно исключить ошибки ввода.
• 🔹 Используйте справочник, если:
  • Список значений динамически изменяется (например, города доставки).
  • Нужны дополнительные реквизиты (адрес, телефон и т.д.).
  • Требуется иерархия с неограниченной вложенностью.

💡

Если сомневаетесь, задайте себе вопрос: "Будут ли пользователи добавлять новые значения в этот список?" Если ответ "да" — используйте справочник. Если "нет" — перечисление.

Практические примеры использования перечислений

Разберём реальные кейсы, где перечисления незаменимы.

1. Статусы документов

В любой учётной системе документы проходят несколько состояний. Например, для заказа покупателя можно задать перечисление СтатусыЗаказа:

Новый
ВОбработке
Собран
Отгружен
Отменён

В коде это позволит легко фильтровать заказы:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|  ЗаказыПокупателей.Ссылка КАК Ссылка
|ИЗ
|  Документ.ЗаказПокупателя КАК ЗаказыПокупателей
|ГДЕ
|  ЗаказыПокупателей.Статус = &Статус";

Запрос.УстановитьПараметр("Статус", Перечисления.СтатусыЗаказа.ВОбработке);
Результат = Запрос.Выполнить();

2. Виды цен

В торговой конфигурации перечисление ВидыЦен поможет управлять ценами номенклатуры:

Розничная
Оптовая
Дилерская
Специальная

Пример использования в модуле:

ТекущаяЦена = ПолучитьЦену(Номенклатура, Перечисления.ВидыЦен.Оптовая);

3. Логические флаги

Замена булевых значений (Истина/Ложь) на перечисление делает код более читаемым. Например:

Перечисление ДаНет
Да
Нет

// Вместо:
Если Флаг Тогда..
// Пишем:
Если Флаг = Перечисления.ДаНет.Да Тогда..

4. Классификаторы для отчётов

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

День
Неделя
Месяц
Квартал
Год

Позволяет гибко настраивать периодичность без жёсткого кодирования.

FAQ: Частые вопросы о перечислениях в 1С

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

Да, порядок значений можно изменить в конфигураторе на вкладке Значения перечисления. Для этого перетаскивайте строки мышью или используйте кнопки «Вверх»/«Вниз». Однако учтите, что это может повлиять на логику работы отчётов или обработок, если в них используется индексация значений (например, Перечисление.ВидыОплат[0]).

Как экспортировать/импортировать перечисление между базами?

Перечисления экспортируются вместе с конфигурацией через файлы .cf или .epf. Чтобы перенести только одно перечисление:

1. Откройте исходную базу в конфигураторе.
2. Найдите перечисление в дереве объектов, кликните правой кнопкой и выберите Копировать.
3. Откройте целевую базу, вставьте перечисление (Вставить).
4. Обновите конфигурацию базы данных.

Для переноса данных, связанных с перечислением (например, значения в документах), потребуется выгрузка/загрузка через XML или Универсальный обмен данными.

Почему в отчёте не отображаются значения перечисления?

Чаще всего это связано с одной из причин:

• 🔹 В схеме компоновки данных не указано представление перечисления. Добавьте поле с типом «Строка» и выражением ВЫРАЗИТЬ(Статус КАК Строка).
• 🔹 Не обновлена конфигурация базы данных после изменения перечисления.
• 🔹 В настройках отчёта отключено отображение служебных полей.

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

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

Для поддержки нескольких языков:

1. В конфигураторе откройте свойства перечисления.
2. На вкладке Синонимы добавьте строки для каждого языка (например, «Male» для английского, «Мужской» для русского).
3. В коде используйте метод .Представление() — он автоматически подставит синоним для текущего языка интерфейса.

Убедитесь, что в настройках базы (Администрирование → Настройки программы → Языки) включены нужные языки.

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

Да, перечисления можно передавать в запросы как параметры. Пример:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|  Номенклатура.Наименование,
|  Номенклатура.ВидНоменклатуры КАК Вид
|ИЗ
|  Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|  Номенклатура.ВидНоменклатуры = &Вид";

Запрос.УстановитьПараметр("Вид", Перечисления.ВидыНоменклатуры.Товар);
Результат = Запрос.Выполнить();

Важно: в тексте запроса сравнивайте с полем того же типа (в примере ВидНоменклатуры должно быть перечислением).