Как найти перечисление в 1С по синониму: 5 работающих способов

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

В этой статье разберём 5 проверенных способов поиска перечислений по синониму — от простых штатных инструментов до программных обходных путей. Методы актуальны для платформы 8.3 и большинства типовых конфигураций (Управление торговлей, Бухгалтерия предприятия, Зарплата и управление персоналом). Особое внимание уделим случаям, когда стандартный поиск не срабатывает: например, при работе с динамическими списками, внешними обработками или унаследованными перечислениями из других конфигураций.

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

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

1. Стандартный поиск через «Все функции»

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

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

🔍 В поле поиска введите часть синонима (например, «статус» вместо полного «СтатусДокумента»). Система ищет совпадения не только в названиях, но и в синонимах объектов.
📋 В результатах отфильтруйте список по типу Перечисление. Это исключит справочники, документы и другие объекты.
🔄 Если поиск не дал результатов, попробуйте разные формы слова (например, «оплата» вместо «оплачен»). В некоторых конфигурациях синонимы регистрируются без склонений.

Этот метод работает в 80% случаев, но может подвести, если:

⚠️ Внимание: Синонимы перечислений в 1С не всегда индексируются для быстрого поиска. Если перечисление было добавлено через расширение или внешнюю обработку, стандартный поиск его не найдёт.

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

2. Поиск через справочник «Перечисления»

В типовых конфигурациях (БП 3.0, УТ 11, ЗУП 3.1) есть системный справочник Перечисления, который содержит все зарегистрированные в базе значения. Доступ к нему можно получить через меню Справочники → Общие → Перечисления (путь может отличаться в зависимости от конфигурации).

Алгоритм поиска:

Откройте справочник Перечисления.
Включите отображение колонки Синоним (если её нет — нажмите правой кнопкой на заголовок таблицы и выберите Настройка списка).
Отсортируйте список по колонке Синоним и воспользуйтесь поиском (Ctrl+F).

Если колонки Синоним в списке нет, это означает, что:

🔧 В вашей конфигурации синонимы не выводятся в интерфейсе (требуется доработка).
🛠️ Перечисление является динамическим (создано на лету через код, а не через метаданные).

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

💡

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

3. Использование отчёта «Анализ метаданных»

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

Как запустить отчёт:

Перейдите в Сервис → Анализ метаданных (или Администрирование → Печатные формы и отчёты → Анализ метаданных).
В настройках отчёта выберите раздел Перечисления.
Добавьте в вывод колонки:
- Имя (внутренний идентификатор),
- Синоним,
- Представление (как отображается пользователю),
- Модуль (если перечисление программное).

Сформируйте отчёт и экспортируйте в Excel для удобного поиска.

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

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

Пример выгрузки из отчёта:

Имя	Синоним	Представление	Модуль
`ВидыДокументов`	ТипДокумента	Виды документов	-
`СтатусыЗаказов`	СтатусЗаказа, СостояниеЗаказа	Статусы заказов	`ОбщийМодуль.РаботаСЗаказами`
`СпособыОплаты`	Оплата, ВариантОплаты	Способы оплаты	-

Обратите внимание на колонку Модуль — если там указан путь, перечисление создаётся динамически, и его нельзя найти через стандартные инструменты.

4. Поиск через конфигуратор (для разработчиков)

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

Инструкция:

Откройте базу в режиме Конфигуратор.
Нажмите Ctrl+Shift+F (или выберите Правка → Найти в метаданных).
В поле поиска введите синоним (например, ТипКонтрагента).
Установите флаги:
- 🔘 Поиск в синонимах,
- 🔘 Только перечисления (чтобы исключить другие объекты).
Запустите поиск. Результаты отобразят все перечисления, где встречается указанный синоним.

Дополнительные возможности:

🔗 Если найдено несколько перечислений, дважды кликните по нужному, чтобы перейти к его определению в дереве метаданных.
📌 Чтобы найти все синонимы перечисления, откройте его свойства (F4) и перейдите на вкладку Синонимы.
🔧 Если перечисление является реквизитом другого объекта (например, справочника), используйте поиск по Использованию (Правка → Найти использование).

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

Открыть базу в режиме конфигуратора|Запустить глобальный поиск (Ctrl+Shift+F)|Включить поиск по синонимам|Фильтровать по типу "Перечисление"|Просмотреть результаты и открыть нужное перечисление-->

5. Программный поиск через встроенный язык

Когда стандартные методы не работают (например, для динамических перечислений или в управляемых формах), остаётся программный обход. Этот способ требует знания 1С:Предприятие на уровне встроенного языка, но даёт 100% результат.

Используйте следующий код для поиска перечисления по синониму (работает в тонком клиенте и веб-клиенте):

// Поиск перечисления по синониму Процедура НайтиПеречислениеПоСинониму(ЗначениеСинонима) Перем РезультатПоиска; // Получаем все перечисления метаданных Метаданные = Метаданные.Перечисления(); Для Каждого Перечисление Из Метаданные Цикл // Проверяем синонимы перечисления Синонимы = Перечисление.Синонимы(); Для Каждого Синоним Из Синонимы Цикл Если НРег(Синоним) = НРег(ЗначениеСинонима) Тогда РезультатПоиска = Перечисление.Имя; Прервать; КонецЕсли; КонецЦикла; Если РезультатПоиска <> Неопределено Тогда Прервать; КонецЕсли; КонецЦикла; Если РезультатПоиска = Неопределено Тогда Сообщить("Перечисление с синонимом '" + ЗначениеСинонима + "' не найдено!"); Иначе Сообщить("Найдено перечисление: " + РезультатПоиска); КонецЕсли; Возврат РезультатПоиска; КонецПроцедуры // Пример вызова:

НайтиПеречислениеПоСинониму("СтатусЗаказа");

Этот код:

🔍 Проходит по всем перечислениям в метаданных.
🔤 Сравнивает синонимы без учёта регистра (НРег).
📌 Возвращает внутреннее имя перечисления, если найдено совпадение.

Для поиска значений перечисления (не самого перечисления, а его элементов) используйте модифицированный вариант:

// Поиск значения перечисления по синониму
Процедура НайтиЗначениеПеречисленияПоСинониму(ИмяПеречисления, СинонимЗначения)
Перем ПеречислениеОбъект;
Перем Результат;

// Получаем объект перечисления
ПеречислениеОбъект = Перечисления[ИмяПеречисления];

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

Возврат Результат;
КонецПроцедуры

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

Эти скрипты можно выполнить в отладчике (Ctrl+Alt+F12) или через внешнюю обработку. Для удобства сохраните их в общем модуле и вызывайте по мере необходимости.

💡

Программный поиск — единственный способ найти динамические перечисления, которые создаются в коде через Новый Перечисление и не хранятся в метаданных.

6. Альтернативные способы: внешние обработки и расширения

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

Частые ошибки и как их избежать

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

Ошибка 1: Пустые результаты при явном совпадении синонима

🔹 Причина: Синоним зарегистрирован с опечаткой или в другом регистре.
🔹 Решение: Проверьте все возможные варианты написания (например, «СтатусЗаказа» vs «Статус_Заказа»).

Ошибка 2: Перечисление найдено, но его значения не отображаются

🔹 Причина: Перечисление является виртуальным (создано через Новый Перечисление в коде).
🔹 Решение: Ищите его в модулях (см. раздел 5).

Ошибка 3: Поиск работает только в конфигураторе

🔹 Причина: В пользовательском режиме отключены права на просмотр метаданных.
🔹 Решение: Запросите у администратора роль с правом Просмотр метаданных.

Ошибка 4: Найдено несколько перечислений с одинаковым синонимом

🔹 Причина: Синонимы не уникальны (например, «Тип» может использоваться в разных перечислениях).
🔹 Решение: Уточните контекст (в каком документе или справочнике используется перечисление).

Если ни один из методов не помог, проверьте:

🔧 Наличие обновлений конфигурации — в новых версиях могут добавляться синонимы.
📂 Расширения конфигурации — иногда перечисления скрыты там.
👥 Права доступа — возможно, ваша роль не позволяет просматривать некоторые объекты.

Что делать, если перечисление найдено, но его нельзя изменить?

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

FAQ: Ответы на частые вопросы

Можно ли найти перечисление по синониму в мобильном клиенте 1С?

В стандартном мобильном клиенте функционал поиска по метаданным ограничен. Вы можете:

📱 Использовать веб-клиент (если он настроен) — там доступны те же инструменты, что и в десктопной версии.
🔧 Запросить у администратора выгрузку справочника перечислений в удобный формат (например, Excel).

Для полноценной работы с метаданными требуется доступ к конфигуратору или тонкому клиенту.

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

Откройте документ в режиме редактирования и:

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

Если поле неактивно, посмотрите его название в свойствах формы (Ctrl+Shift+F4).

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

Это связано с особенностями индексации метаданных:

🔍 Динамические перечисления (созданные в коде) не попадают в стандартный поиск.
📌 Синонимы из расширений могут не отображаться, если расширение отключено.
🔧 Ограничения прав — пользователь с ролью «Бухгалтер» не увидит перечисления из модуля «Зарплата».

Для полного анализа используйте конфигуратор или программный обход (раздел 5).

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

Да, для этого подходит:

📊 Отчёт «Анализ метаданных» (см. раздел 3).
📝 Внешняя обработка с функцией выгрузки в CSV/Excel.
🖥️ 1С:EDT — позволяет экспортировать метаданные в формат XML.

Пример кода для выгрузки в Excel:

Процедура ЭкспортироватьПеречисленияВExcel()
ТабДок = Новый ТабличныйДокумент;
ТабДок.Очистить();

// Заголовки колонок
ТабДок.ВывестиСекцию("|Имя|Синоним|Представление|");

// Данные
Метаданные = Метаданные.Перечисления();
Для Каждого Перечисление Из Метаданные Цикл
СинонимыСтрока = "";
Синонимы = Перечисление.Синонимы();
Для Каждого Синоним Из Синонимы Цикл
СинонимыСтрока = СинонимыСтрока + ?(СинонимыСтрока = "", "", ", ") + Синоним;
КонецЦикла;

ТабДок.ВывестиСекцию(
"|" + Перечисление.Имя +
"|" + СинонимыСтрока +
"|" + Перечисление.Представление() + "|"
);
КонецЦикла;

// Сохранение
ТабДок.Записать("C:\Temp\Перечисления.xlsx", ТипФайлаТабличногоДокумента.XLSX);
КонецПроцедуры

Как добавить синоним к существующему перечислению?

Для этого:

Откройте конфигуратор (Ctrl+Shift+C).
Найдите нужное перечисление в дереве метаданных.
Откройте его свойства (F4) и перейдите на вкладку Синонимы.
Добавьте новый синоним и сохраните конфигурацию (Ctrl+S).

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

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