СКД 1С: как выразить поле как документ

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

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

Ниже разобран синтаксис, типовые сценарии в запросе набора данных СКД, ограничения производительности и способы проверить, что приведение работает корректно.

Где именно применяется ВЫРАЗИТЬ и зачем оно нужно

Оператор ВЫРАЗИТЬ работает на уровне языка запросов, поэтому используется в тексте запроса набора данных СКД (закладка «Наборы данных» → поле «Запрос»). Сам по себе конструктор СКД не имеет отдельной настройки «выразить как документ» — всё делается в запросе.

Типовые ситуации, когда без приведения типа не обойтись:

• обращение к реквизиту регистратора: Регистратор.Контрагент не сработает, пока регистратор не приведён к конкретному документу;
• соединение таблицы регистра с таблицей документа по ссылке составного типа — без ВЫРАЗИТЬ соединение технически возможно, но обращение к реквизитам документа всё равно потребует приведения;
• отбор по реквизиту документа: например, показать движения только тех реализаций, где склад равен заданному;
• сравнение поля составного типа с параметром-ссылкой конкретного типа.

Синтаксис приведения к документу

Базовая форма в запросе набора данных:

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

Здесь поле «Регистратор» имеет составной тип (любой документ, который может делать движения по регистру). Выражение ВЫРАЗИТЬ(... КАК Документ.РеализацияТоваровУслуг) приводит его к конкретному виду, и дальше через точку доступен реквизит «Контрагент». Для строк, где регистратор — другой документ (например, «Возврат товаров от покупателя»), поле «Контрагент» будет NULL.

Обратите внимание: имя документа указывается без кавычек, как оно задано в метаданных конфигурации. Ошибка в имени приведёт к ошибке проверки запроса ещё в конструкторе.

ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.РеализацияТоваровУслуг).Контрагент КАК Контрагент

Сценарий: несколько видов документов в одном поле

Объединение через ВЫБОР

Если регистратором может быть несколько видов документов и нужно вытащить «Контрагента» из каждого, применяют конструкцию ВЫБОР с несколькими приведениями:

ВЫБОР
КОГДА Продажи.Регистратор ССЫЛКА Документ.РеализацияТоваровУслуг
ТОГДА ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.РеализацияТоваровУслуг).Контрагент
КОГДА Продажи.Регистратор ССЫЛКА Документ.ВозвратТоваровОтПокупателя
ТОГДА ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.ВозвратТоваровОтПокупателя).Контрагент
ИНАЧЕ NULL
КОНЕЦ КАК Контрагент

Проверка ССЫЛКА Документ.Имя отсекает ненужные типы до обращения к реквизиту. Это и надёжнее, и читабельнее: сразу видно, какие документы обрабатываются.

Соединение с таблицей документа

Альтернатива — левое соединение с таблицей документа по ссылке:

ЛЕВОЕ СОЕДИНЕНИЕ Документ.РеализацияТоваровУслуг КАК Реализация
ПО Продажи.Регистратор = Реализация.Ссылка

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

ВЫРАЗИТЬ в отборах, параметрах и настройках СКД

Приведённое выражение можно использовать не только в списке полей. В секции ГДЕ допустимо условие вида:

ГДЕ
ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.РеализацияТоваровУслуг).Склад = &Склад

Однако для отборов, которые пользователь будет менять в настройках отчёта, удобнее вычислить поле в запросе (дать ему псевдоним) и вынести его в список доступных полей СКД. Тогда отбор настраивается визуально, без правки запроса.

Ещё одно применение — приведение параметра. Если параметр объявлен составного типа, а сравнивать его нужно с реквизитом конкретного документа, в запросе пишут ВЫРАЗИТЬ(&Документ КАК Документ.ЗаказКлиента). Это снимает неоднозначность типов при сравнении.

Производительность и ограничения

Каждое обращение вида ВЫРАЗИТЬ(...).Реквизит фактически порождает обращение к таблице документа. Если в запросе десять таких выражений к одному документу, платформа может сформировать несколько соединений с одной и той же таблицей, что замедляет выполнение на больших объёмах.

Практические рекомендации:

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

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

После добавления ВЫРАЗИТЬ пройдите контрольные точки:

• конструктор запроса не выдаёт ошибок при нажатии «ОК» — значит, имена документа и реквизитов указаны верно;
• в отчёте по строкам с нужным видом документа реквизит заполнен, а по строкам с другими документами пуст — это нормальное поведение, а не ошибка;
• итоговые суммы по количеству и суммам не изменились по сравнению с вариантом без приведения — соединение не задвоило строки;
• отбор по новому полю в настройках СКД отрабатывает и не приводит к пустому отчёту при корректном значении.

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

Типичные ошибки

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

Вторая группа ошибок связана с ожиданиями от данных: разработчик приводит регистратор к одному виду документа и забывает, что движения делают и другие документы. Строки «чужих» документов остаются в отчёте с пустыми реквизитами, а если добавить внутреннее соединение вместо левого — эти строки пропадут вовсе, и итоги перестанут сходиться с типовыми отчётами.

Третья ошибка — приведение к типу, которого нет в составе поля. Например, регистратор регистра никогда не бывает документом «Счёт на оплату», а разработчик указал именно его. Запрос отработает без ошибок, но поле будет всегда NULL.

Итог

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

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