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

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

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

1. Поиск через дерево конфигурации

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

1. Откройте конфигуратор в режиме 1С:Предприятие (с правами администратора).
2. Перейдите в меню Конфигурация → Открыть конфигурацию (или нажмите F7).
3. В дереве объектов разверните ветку Общие → Перечисления.
4. Используйте клавишу F3 для поиска по названию (работает только в классическом интерфейсе конфигуратора).

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

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

2. Глобальный поиск по тексту конфигурации

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

1. В конфигураторе откройте меню Правка → Найти (или нажмите Ctrl+F).
2. В поле поиска введите известную часть названия перечисления (например, Статус* для поиска всех перечислений со словом "Статус").
3. Установите галочки:
   • 📄 Искать в модулях — для поиска в программном коде.
   • 📋 Искать в текстах — для поиска в метаданных (названиях, синонимах).
   • 🔍 Учитывать морфологию — если нужно найти все формы слова.

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

Искать в модулях объектов|Искать в общих модулях|Проверять внешние обработки/отчеты|Использовать регистронезависимый поиск-->

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

ГДЕ Статус = ЗНАЧЕНИЕ(Перечисление.СтатусыДокументов.Подтвержден)

3. Поиск через отладчик (Debug)

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

1. Запустите 1С:Предприятие в режиме отладки (через конфигуратор: Отладка → Начать отладку).
2. Откройте форму, где предположительно используется искомое перечисление (например, форму документа или справочника).
3. Поставьте точку останова в модуле формы (например, в процедуре ПриСозданииНаСервере).
4. Когда выполнение прервётся, откройте окно Вычислить выражение (Ctrl+Alt+F8).
5. Введите имя перечисления (например, Перечисление.СтатусыЗаказов) и нажмите Выполнить.

Если перечисление существует, отладчик покажет его структуру со всеми значениями. Если нет — выдаст ошибку Неопределённое имя.

Как найти перечисление, если неизвестно его полное имя?

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

💡 Полезный совет: Если перечисление используется в динамическом списке или отчёте, поставьте точку останова в модуле менеджера объекта (например, Документ.ЗаказПокупателя.МодульМенеджера) и проанализируйте переменные в момент выполнения.

4. Поиск через запросы к метаданным

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

ВЫБРАТЬ
Метаданные.Перечисления.Имя КАК Имя,
Метаданные.Перечисления.Синоним КАК Синоним,
Метаданные.Перечисления.ПолноеИмя() КАК ПолноеИмя
ИЗ
Метаданные.Перечисления КАК Метаданные.Перечисления
ГДЕ
Метаданные.Перечисления.Имя ПОДОБНО "%Статус%"

Чтобы выполнить этот запрос:

1. Откройте конфигуратор и перейдите в Сервис → Запрос (Ctrl+Q).
2. Вставьте текст запроса и нажмите Выполнить.
3. Результаты отобразятся в таблице, где вы сможете увидеть полные имена перечислений и их синонимы.

⚠️ Внимание: Запросы к метаданным работают только в тонком клиенте и веб-клиенте. В толстом клиенте этот метод недоступен.

Метод поиска	Когда использовать	Ограничения
Дерево конфигурации	Если известно полное или частичное название	Не находит динамические перечисления
Глобальный поиск	Для поиска в коде и метаданных	Может быть медленным в крупных базах
Отладчик	Если перечисление используется в текущем сеансе	Требует прав на отладку
Запросы к метаданным	Для массового поиска по шаблону	Не работает в толстом клиенте

5. Поиск в внешних обработках и расширениях

Если перечисление не найдено в основной конфигурации, проверьте внешние обработки и расширения. Эти объекты могут содержать собственные перечисления, которые не отображаются в дереве метаданных. Как искать:

• 📁 Внешние обработки: Откройте файл обработки (.epf или .erf) в конфигураторе и используйте глобальный поиск (Ctrl+Shift+F).
• 🔗 Расширения: Перейдите в Конфигурация → Расширения, выберите нужное расширение и проверьте его объекты.
• 🔄 Подключаемые библиотеки: Некоторые перечисления могут быть определены в БСП (Библиотека Стандартных Подсистем) или других подключаемых решениях.

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

В дереве конфигурации|Через глобальный поиск|В отладчике|Через запросы к метаданным|В внешних обработках-->

6. Поиск по синонимам и псевдонимам

Иногда перечисление сложно найти по техническому имени, но известно его синоним (отображаемое имя) или псевдоним (имя на английском). В этом случае:

1. Откройте конфигуратор и перейдите в Конфигурация → Открыть конфигурацию.
2. Нажмите Ctrl+F и введите известный синоним (например, Статус заказа).
3. Установите галочку Искать в синонимах.
4. Если поиск не дал результатов, попробуйте английский вариант (например, OrderStatus).

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

💡

Если перечисление не найдено ни одним из методов, проверьте, не является ли оно динамическим (созданным в коде через Новый Перечисление). Такие объекты существуют только во время выполнения и не хранятся в метаданных.

7. Типичные ошибки и как их избежать

При поиске перечислений пользователи часто сталкиваются с типичными проблемами, которые мешают найти объект. Вот самые распространённые из них:

• 🔤 Опечатки в названии: Перечисления чувствительны к регистру. СтатусЗаказа и статусзаказа — разные вещи.
• 📂 Поиск не в той конфигурации: Убедитесь, что вы работаете с нужной базой (особенно актуально для многобазовых решений).
• 🔍 Игнорирование расширений: Перечисление может быть определено в расширении, а не в основной конфигурации.
• 📝 Путаница с типами: Не перепутайте перечисление со справочником или константой (например, Справочник.Статусы вместо Перечисление.Статусы).

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

FAQ: Частые вопросы по поиску перечислений

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