Где найти и как работать с перечислениями в 1С

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

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

Физическое расположение объектов в дереве конфигурации

Для того чтобы найти или создать новый объект типа Перечисление, вам необходимо открыть окно Конфигурация в среде разработки. Обычно это делается через меню Конфигурация → Открыть конфигурацию или нажатием сочетания клавиш Ctrl+Shift+M. В открывшемся дереве метаданных корневой элемент имеет название вашей базы данных.

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

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

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

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

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

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

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

• 📁 Имя объекта должно быть уникальным в рамках всей конфигурации.
• 🏷️ Синонимы значений могут повторяться в разных перечислениях, но имена — нет.
• ⚙️ Флаг «Предопределенный» ускоряет работу кода, но усложняет обновление конфигурации.

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

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

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

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

Для проверки типа значения часто используется функция ТипЗнч или оператор Тип. Это позволяет убедиться, что в переменную передан именно элемент нужного перечисления, а не строка или число. Типизация в 1С динамическая, поэтому контроль типов лежит на совести разработчика.

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

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

Поиск ссылок на перечисления в существующем коде

В больших проектах часто возникает необходимость найти все места, где используется конкретное перечисление. Это нужно при рефакторинге или удалении устаревших объектов. Самый простой способ — использовать встроенный поиск по модулям. Нажмите Ctrl+Shift+F и введите имя перечисления.

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

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

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

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

Часто разработчики задаются вопросом: когда использовать перечисление, а когда план видов характеристик (ПВХ)? Оба объекта позволяют хранить списки значений, но имеют принципиальные различия в архитектуре и назначении. Перечисления хранятся в памяти и в составе конфигурации, а ПВХ — это регистровая сущность, данные которой хранятся в таблицах базы данных.

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

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

Критерий	Перечисление	План видов характеристик
Хранение данных	В конфигурации (файл .cf)	В базе данных (таблицы SQL)
Изменение пользователем	Невозможно без конфигуратора	Возможно в режиме предприятия
Производительность	Высокая (в памяти)	Зависит от объема данных в БД
Использование в запросах	Как виртуальная таблица	Как обычная таблица БД

Почему нельзя хранить курсы валют в перечислении?

Курсы валют меняются ежедневно и их количество не ограничено. Хранение их в перечислении потребовало бы ежедневного обновления конфигурации на всех рабочих местах, что технически нецелесообразно и нарушает архитектуру 1С.

Типичные ошибки и способы их решения

Одной из самых распространенных ошибок является попытка сравнить значение перечисления со строкой. Например, конструкция Если Статус = "Новый" Тогда вернет ложь, так как слева находится ссылка на объект метаданных, а справа — строка. Для корректного сравнения нужно использовать Перечисления.Статусы.Новый.

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

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

• 🚫 Никогда не сравнивайте ссылку на перечисление с текстовой строкой напрямую.
• 🔄 Избегайте изменения имен предопределенных элементов в типовых объектах.
• 🔍 Всегда проверяйте существование значения перед обращением к нему в динамическом коде.

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

⚠️ Внимание: Интерфейсы и названия пунктов меню могут незначительно отличаться в разных версиях платформы 1С (8.2, 8.3) и в разных режимах запуска (Тонкий клиент, Толстый клиент). Всегда сверяйтесь с официальной документацией к вашей конкретной версии платформы.

Вопросы и ответы (FAQ)

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

Нет, объект метаданных «Перечисление» не поддерживает иерархию. Элементы перечисления всегда находятся на одном уровне. Если вам нужна иерархия (папки и вложенные элементы), необходимо использовать Справочник с иерархией или План видов характеристик.

Как получить все значения перечисления в цикле?

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

Где хранятся данные перечислений в базе данных SQL?

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

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

Да, вы можете выбрать тип измерения или ресурса регистра сведений/накопления как «ПеречислениеСсылка.ИмяВашегоПеречисления». Это распространенная практика для классификации записей регистра.