ВЫРАЗИТЬ как Номенклатура в запросе 1С: синтаксис и практика

Функция ВЫРАЗИТЬ в языке запросов 1С приводит значение поля к указанному типу данных. Одна из самых частых практических задач — привести составное поле (например, реквизит, который может хранить ссылки на разные справочники) к конкретному типу СправочникСсылка.Номенклатура. Без такого приведения невозможно обратиться к реквизитам номенклатуры через точку и корректно выполнить соединение таблиц.

Типичная ситуация: в регистре или документе есть поле составного типа, допускающее ссылки на «Номенклатуру», «Контрагентов» и другие объекты. При попытке получить, например, артикул через точку запрос либо возвращает NULL, либо падает с ошибкой, потому что платформа не знает, какой именно тип скрывается в поле. ВЫРАЗИТЬ решает эту проблему, явно сообщая запросу нужный тип.

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

Зачем приводить поле к типу Номенклатура

Приведение типа требуется в трёх основных случаях. Первый — составной тип поля: когда реквизит объявлен как ссылка на несколько видов справочников или документов, обращение к реквизитам конкретного объекта через точку невозможно без явного приведения. Второй случай — поле типа «Хранилище значения» или строковое представление, которое нужно трактовать как ссылку (хотя здесь ВЫРАЗИТЬ помогает только для ссылочных составных типов, а не для преобразования строки в ссылку). Третий — оптимизация: явное приведение сужает выборку и упрощает план запроса при соединениях.

Без приведения запрос вида Товары.Номенклатура.Артикул для составного поля вернёт NULL даже там, где ссылка действительно указывает на номенклатуру. Платформа не выполняет неявное разыменование по составному типу — это осознанное ограничение языка запросов.

Синтаксис ВЫРАЗИТЬ для ссылочного типа

Общий вид конструкции для ссылочного типа:

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

Обратите внимание: в языке запросов указывается имя объекта метаданных без слова «Ссылка» — пишется Справочник.Номенклатура, а не СправочникСсылка.Номенклатура. Это частая ошибка у тех, кто переносит привычку из встроенного языка 1С.

Пример реального запроса, где поле «Аналитика» имеет составной тип:

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

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

ВЫРАЗИТЬ(Таблица.СоставноеПоле КАК Справочник.Номенклатура) КАК Номенклатура

Приведение в условиях и соединениях

ВЫРАЗИТЬ применяется не только в списке выборки, но и в секциях ГДЕ и СОЕДИНЕНИЕ. Типовой сценарий — соединение регистра с составным измерением со справочником номенклатуры:

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

В условии ГДЕ приведение удобно для фильтрации по реквизиту: ГДЕ ВЫРАЗИТЬ(Поле КАК Справочник.Номенклатура).ВидНоменклатуры = &Вид. Учтите, что такое условие автоматически отсекает строки, где поле содержит ссылку другого типа, — для них результат приведения равен NULL, а сравнение с NULL не выполняется.

Поведение при несовпадении типов

Ключевое свойство функции: если фактическое значение поля не является ссылкой на номенклатуру, ВЫРАЗИТЬ возвращает NULL, а не ошибку. Это делает конструкцию безопасной для составных полей, но требует аккуратности: строки с «чужими» типами молча выпадают из результатов при внутреннем соединении или получают пустые значения реквизитов.

Если нужно сохранить все строки и просто дополнить их данными номенклатуры, используйте левое соединение вместо внутреннего. Если же нужно отобрать только строки с номенклатурой, достаточно условия Поле ССЫЛКА Справочник.Номенклатура — оператор ССЫЛКА проверяет тип без приведения и часто читается проще.

Типичные ошибки и ограничения

Первая ошибка — написание СправочникСсылка.Номенклатура в тексте запроса. Конструктор запросов такую форму не примет: правильно Справочник.Номенклатура. Вторая — попытка привести строковое поле к ссылочному типу. ВЫРАЗИТЬ работает только с совместимыми типами; строку в ссылку она не превратит, результат будет NULL.

Третья ошибка — избыточное применение. Если поле уже имеет единственный тип «СправочникСсылка.Номенклатура», приведение ничего не даёт и лишь усложняет текст запроса. Четвёртая — использование ВЫРАЗИТЬ в условиях соединения больших таблиц без необходимости: приведение в условии может мешать оптимизатору использовать индексы, что замедляет запрос на больших объёмах данных.

Отдельное ограничение: в СКД (системе компоновки данных) приведение к ссылочному типу в вычисляемых полях имеет свои нюансы — там приведение лучше выполнять на уровне запроса набора данных, а не в выражениях ресурсов.

Как проверить результат

После добавления приведения выполните запрос в консоли запросов и проверьте три вещи. Во-первых, колонка с приведённым значением заполнена ссылками там, где исходное поле содержало номенклатуру. Во-вторых, обращение через точку (например, к артикулу) возвращает реальные значения, а не сплошные NULL. В-третьих, число строк в результате соответствует ожиданию — если строк стало меньше, проверьте, не отсеклись ли записи с другими типами в составном поле.

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

Альтернативы и смежные приёмы

Если задача — найти ссылку номенклатуры по строковому коду или артикулу, ВЫРАЗИТЬ не поможет. В запросе это решается соединением со справочником по полю Код или Артикул, а во встроенном языке — методом Справочники.Номенклатура.НайтиПоКоду() или НайтиПоНаименованию().

Для приведения примитивных типов ВЫРАЗИТЬ работает иначе: ВЫРАЗИТЬ(Поле КАК Строка(100)) или ВЫРАЗИТЬ(Поле КАК Число(15,2)) — здесь указываются квалификаторы типа. Это полезно, чтобы усечь строку неограниченной длины перед группировкой или сравнением, что нередко встречается рядом с задачами приведения ссылок в одном запросе.

Частые вопросы