Как в запросе указать тип документа 1С 8.3

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

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

Использование объектов метаданных в тексте запроса

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

В условии ГДЕ или ИМЕЕТ вы можете напрямую сравнивать поле типа с именем метаданных. Например, если вам нужно выбрать все документы вида "ЗаказКлиента", вы можете написать условие, где поле типа равно Документ.ЗаказКлиента. Это работает, потому что платформа автоматически преобразует ссылку на метаданные в соответствующий тип данных на стороне СУБД или виртуальной машины.

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

Рассмотрим пример кода, где мы выбираем номера документов из регистра сведений:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
|	СоставОбъектов.Ссылка
|ИЗ
|	РегистрСведений.СоставОбъектов КАК СоставОбъектов
|ГДЕ
|	СоставОбъектов.ТипЗначения = &ТипДок";

Запрос.УстановитьПараметр("ТипДок", Документ.ЗаказКлиента);
Результат = Запрос.Выполнить();

⚠️ Внимание: При передаче типа через параметры запроса убедитесь, что вы передаете именно объект метаданных, а не строковое представление его имени. Передача строки "Документ.ЗаказКлиента" приведет к ошибке типов.

Работа с таблицей значений для множественных типов

Часто возникает задача отфильтровать данные сразу по нескольким типам документов. Например, нужно получить историю движений по "ЗаказуКлиента" и "РеализацииТоваровУслуг" одновременно. В этом случае использование одного параметра типа невозможно, и на помощь приходит конструкция В (&ТаблицаТипов).

Для реализации такого подхода необходимо создать объект ТаблицаЗначений, добавить в него колонку с типом Тип и заполнить ее необходимыми значениями. Затем эта таблица передается в запрос как параметр. Это позволяет делать код гибким и не зависеть от количества обрабатываемых видов документов.

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

• 📋 Создайте объект ТаблицаЗначений и добавьте колонку "ТипДокумента" с типом Тип.
• ➕ Добавьте строки в таблицу, записывая в колонку нужные метаданные, например Документ.СчетФактураВыданный.
• 🚀 Передайте таблицу в запрос как параметр и используйте конструкцию В (&ПараметрТаблицы).

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

ТЗТипов = Новый ТаблицаЗначений;
ТЗТипов.Колонки.Добавить("ВидДокумента", Тип("Тип"));

Строка = ТЗТипов.Добавить();
Строка.ВидДокумента = ТипЗнч(Документ.ЗаказКлиента);

Строка = ТЗТипов.Добавить();
Строка.ВидДокумента = ТипЗнч(Документ.ЗаказПокупателю);

Запрос.УстановитьПараметр("СписокТипов", ТЗТипов);

Использование функции ТипЗнч и конструктора типов

В некоторых сценариях, особенно при динамической генерации кода или работе с внешними источниками данных, может потребоваться получение типа не напрямую из метаданных, а через функцию. Функция ТипЗнч() возвращает описание типа переданного объекта. Это полезно, когда у вас уже есть ссылочный объект, и вы хотите использовать его тип в запросе.

Кроме того, существует конструктор типов Тип(), который позволяет создать описание типа по строковому имени. Это мощный инструмент, но он требует осторожности. Если вы передаете в запрос тип, полученный через Тип("ДокументСсылка.ЗаказКлиента"), убедитесь, что строковое имя полностью соответствует структуре метаданных вашей конфигурации.

Различие между прямой ссылкой на метаданные и функцией ТипЗнч может быть критичным в контексте производительности. Прямая ссылка обрабатывается компилятором запросов более эффективно. Использование функций внутри текста запроса (если бы это было возможно напрямую) или передача результатов их работы требует дополнительных преобразований.

Ниже приведена таблица сравнения способов получения типа для использования в запросе:

Способ получения	Синтаксис в коде 1С	Гибкость	Производительность
Прямая ссылка	Документ.ЗаказКлиента	Низкая (статика)	Высокая
Функция ТипЗнч	ТипЗнч(СсылкаНаДок)	Средняя (зависит от объекта)	Средняя
Конструктор Тип	Тип("ДокументСсылка..")	Высокая (динамическая строка)	Низкая (парсинг строки)
Таблица значений	ТЗ.Добавить().Колонка =..	Максимальная (список)	Зависит от объема ТЗ

Нюансы работы с Тип()

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

Типизация в временных таблицах и соединениях

При работе с временными таблицами (#ВременнаяТаблица) структура полей фиксируется в момент создания таблицы. Если вы помещаете данные о типах документов во временную таблицу для последующего соединения, крайне важно корректно определить тип колонки. Ошибка в определении типа колонки временной таблицы может привести к потере данных или ошибкам при вставке.

Когда вы делаете ВЫБРАТЬ.. В #ВремТаб, система автоматически определяет типы полей на основе выражений. Однако, если в выборке участвуют null-значения или разнородные данные, тип может быть определен неверно (например, как Строка вместо Тип). В таких случаях рекомендуется явно описывать структуру временной таблицы через объект ОписаниеТипов или использовать предварительное заполнение.

Особое внимание стоит уделить соединениям (ЛЕВОЕ СОЕДИНЕНИЕ, ВНУТРЕННЕЕ СОЕДИНЕНИЕ), где условием выступает сравнение типов. Если типы в левой и правой части условия несовместимы на уровне метаданных, оптимизатор запросов может не смоcть построить эффективный план выполнения. Всегда проверяйте, что сравниваемые поля имеют совместимые типы данных.

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

ЗапросТекст = "ВЫБРАТЬ
|	'Заказ' КАК Вид,
|	&ТипЗаказ КАК ТипДок
|ПОМЕСТИТЬ В #ТипыДок";

Запрос = Новый Запрос;
Запрос.Текст = ЗапросТекст;
Запрос.УстановитьПараметр("ТипЗаказ", Документ.ЗаказКлиента);
Запрос.Выполнить();

⚠️ Внимание: При объединении результатов (ОБЪЕДИНИТЬ ВСЕ) убедитесь, что колонки с типами документов в обеих частях запроса имеют одинаковый порядок и совместимые определения типов, иначе структура итоговой временной таблицы может нарушиться.

Обработка ошибок и диагностика типов

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

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

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

• 🔍 Проверяйте тип параметра в отладчике перед выполнением запроса.
• 🛠 Используйте ТипЗнч() для проверки фактического типа переменной в коде.
• 📜 Анализируйте текст запроса в режиме отладки запросов (F10 в конфигураторе).

Особенности работы в управляемых формах

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

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

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

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

Передача типа через строку

Если вам необходимо передать тип с клиента на сервер, безопаснее передать строку "Документ.ЗаказКлиента", а на сервере выполнить преобразование: Тип(ПараметрСтрока). Это гарантирует корректную сериализацию.

FAQ: Частые вопросы по типам в запросах

Можно ли передать тип документа строкой напрямую в запрос?

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

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

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

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

Используйте встроенную функцию Тип(ИмяТипа). Например: МойТип = Тип("ДокументСсылка.ЗаказКлиента"). Затем переменную МойТип можно передавать в параметр запроса.

В чем разница между Документ.Заказ и ДокументСсылка.Заказ?

Документ.Заказ — это описание типа метаданных (вида документа). ДокументСсылка.Заказ — это описание типа ссылки на конкретный документ. В регистрах и таблицах обычно хранятся ссылки, но при сравнении поля "ТипЗначения" часто требуется именно тип метаданных. Экспериментально проверьте поведение в вашей конкретной таблице.

Можно ли использовать список типов в операторе В()?

Да, но список должен быть передан как таблица значений с одной колонкой типа Тип. Просто перечислить типы через запятую в тексте запроса в операторе В для полей типа нельзя, требуется параметр-таблица.