Как получить синоним перечисления в запросе 1С: от простого к сложному

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

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

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

1. Базовый метод: функция Представление() в запросе

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

Пример запроса для получения синонима значения перечисления ВидыНоменклатуры:

ВЫБРАТЬ
Номенклатура.Наименование КАК Наименование,
ПРЕДСТАВЛЕНИЕ(Номенклатура.ВидНоменклатуры) КАК ВидНоменклатуры
ИЗ
Справочник.Номенклатура КАК Номенклатура

Важно понимать, что функция Представление() возвращает текущий синоним значения перечисления в контексте сеанса. Это означает:

• 🌍 Если база многоязычная, результат будет зависеть от языка интерфейса пользователя
• 🔄 При изменении синонимов в конфигураторе (без обновления данных) старые значения в базе не обновятся автоматически
• ⚡ Функция работает медленнее, чем прямая выборка из таблиц, если применяется к большому объему данных

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

2. Альтернативный подход: временные таблицы с предварительным заполнением

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

Алгоритм действий:

1. Создать временную таблицу с полями Значение (тип — перечисление) и Синоним (тип — строка)
2. Заполнить её программно всеми возможными значениями перечисления и их синонимами
3. Использовать эту таблицу в основном запросе через оператор СОЕДИНИТЬ

Пример кода для создания временной таблицы:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|    &ЗначенияПеречисления КАК Значение,
|    ПРЕДСТАВЛЕНИЕ(&ЗначенияПеречисления) КАК Синоним
|ПОМЕСТИТЬ ВТ_СинонимыПеречисления";

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

Преимущества этого метода:

• ⚡ Значительно ускоряет выполнение сложных запросов за счет однократного вычисления синонимов
• 🔧 Позволяет гибко управлять форматом выходных данных (например, добавлять префиксы)
• 🌐 Легко адаптируется для многоязычных баз

Создать объект Запрос|Определить структуру временной таблицы|Заполнить параметр значениями перечисления|Выполнить запрос с помещением во временную таблицу|Использовать таблицу в основном запросе-->

3. Работа с синонимами в программном коде: когда запрос не подходит

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

• 📊 Формировании отчетов с сложной логикой представления данных
• 🔄 Динамическом создании запросов на основе пользовательских настроек
• 🖥️ Работе с внешними системами через API

Основные методы программного извлечения синонимов:

Для оптимизации производительности при частом обращении к синонимам рекомендуется кэшировать результаты:

Процедура ПолучитьСинонимыПеречисления(ИмяПеречисления)
Если Не ЗначениеЗаполнено(КэшСинонимов[ИмяПеречисления]) Тогда
КэшСинонимов[ИмяПеречисления] = Новый Соответствие;
Для Каждого Значение Из Перечисление[ИмяПеречисления] Цикл
КэшСинонимов[ИмяПеречисления].Вставить(Значение, Значение.Представление());
КонецЦикла;
КонецЕсли;
Возврат КэшСинонимов[ИмяПеречисления];
КонецПроцедуры

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

4. Особенности работы с синонимами в многоязычных базах

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

Ключевые моменты, которые нужно учитывать:

• 🌍 Синоним возвращается на языке текущего сеанса (задается в настройках пользователя)
• 🔄 При изменении языка интерфейса синонимы обновляются динамически без перезапуска системы
• 📝 В конфигураторе синонимы можно задавать для каждого поддерживаемого языка отдельно

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

// Установить язык сеанса временно
ТекущийЯзык = НСтр("ru = 'Русский'; en = 'English'");
ЯзыкСеанса = ТекущийЯзык.Получить("en");

НастройкиСеанса = Новые НастройкиСеанса();
НастройкиСеанса.Язык = ЯзыкСеанса;
УстановитьНастройкиСеанса(НастройкиСеанса);

// Получить синоним на английском
СинонимEN = Перечисление.ВидыНоменклатуры.Товар.Представление();

// Вернуть исходные настройки
ВосстановитьНастройкиСеанса();

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

Функция ПолучитьВсеСинонимыПеречисления(ИмяПеречисления)
Результат = Новый Структура;
Для Каждого Язык Из Метаданные.Языки Цикл
НастройкиСеанса = Новые НастройкиСеанса();
НастройкиСеанса.Язык = Язык;
УстановитьНастройкиСеанса(НастройкиСеанса);

Результат.Вставить(Язык.Идентификатор, Новый Соответствие);
Для Каждого Значение Из Перечисление[ИмяПеречисления] Цикл
Результат[Язык.Идентификатор].Вставить(Значение, Значение.Представление());
КонецЦикла;
КонецЦикла;
ВосстановитьНастройкиСеанса();
Возврат Результат;
КонецФункции

5. Оптимизация запросов с перечислениями: практические советы

Работа с перечислениями в запросах может существенно влиять на производительность системы, особенно в больших базах данных. Вот несколько проверенных приемов для оптимизации:

1. Избегайте многократного вызова Представление() в одном запросе

Каждый вызов этой функции требует дополнительных вычислений. Лучше один раз получить все синонимы во временную таблицу и затем присоединять её.

2. Используйте индексированные поля

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

3. Ограничивайте объем обрабатываемых данных

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

4. Рассмотрите возможность денормализации

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

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

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

1. Пустые синонимы в отчетах

Если в конфигураторе для значения перечисления не задан синоним, функция Представление() вернет пустую строку. Всегда проверяйте это:

Синоним = Перечисление.ВидыНоменклатуры.Товар.Представление();
Если ПустаяСтрока(Синоним) Тогда
Синоним = "Не задано";
КонецЕсли;

2. Несоответствие синонимов после обновления конфигурации

При изменении синонимов в конфигураторе старые значения остаются в базе данных до её обновления. Используйте обработку ОбновлениеИнформационнойБазы для принудительного обновления.

3. Проблемы с сортировкой по синонимам

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

4. Забывают про права доступа

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

⚠️ Внимание: В версиях платформы 8.3.18 и выше появилась возможность использовать конструкцию ЗНАЧЕНИЕПЕРЕЧИСЛЕНИЯ() непосредственно в запросах. Однако этот синтаксис не поддерживает получение синонимов — только сравнение по внутренним идентификаторам.

7. Продвинутые техники: динамическое формирование запросов

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

Пример динамического формирования запроса с учетом синонимов:

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

Запрос = Новый Запрос(ТекстЗапроса);
Запрос.УстановитьПараметр("СинонимПеречисления",
"ПРЕДСТАВЛЕНИЕ(Номенклатура." + ИмяПеречисления + ")");

Результат = Запрос.Выполнить();

Для еще более гибкого подхода можно использовать строитель запросов:

Строитель = Новый СтроительЗапроса();
Строитель.ИсточникДанных = Новый ОписаниеИсточникаДанных("Номенклатура", "Справочник.Номенклатура");
Строитель.ДобавитьПоле("Наименование");
Строитель.ДобавитьПоле("ПРЕДСТАВЛЕНИЕ(Номенклатура." + ИмяПеречисления + ")", "ВидНоменклатуры");

Запрос = Строитель.ПолучитьЗапрос();
Результат = Запрос.Выполнить();

Преимущества динамического подхода:

• 🔧 Универсальность — один код работает с разными перечислениями
• 🛠️ Легко адаптируется под изменяющиеся требования
• 📊 Позволяет создавать гибкие отчеты с настраиваемыми группировками

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

Синонимы = Перечисление.ВидыНоменклатуры.Метаданные().Синонимы;

ТекущийЯзык = НастройкиСеанса().Язык;
НастройкиСеанса().Язык = Новый Язык("en"); // Английский
Синоним = Перечисление.ВидыНоменклатуры.Товар.Представление();
НастройкиСеанса().Язык = ТекущийЯзык;

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