Как посмотреть результаты запроса в 1С

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

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

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

Где вообще «живёт» результат запроса в 1С

Когда вы вызываете Запрос.Выполнить(), платформа возвращает объект типа «РезультатЗапроса». Сам по себе он не является таблицей данных — это объект-обёртка, из которого нужно получить выборку методом Выбрать() или выгрузить данные методом Выгрузить() в таблицу значений или дерево значений.

Именно поэтому «просто посмотреть» результат нельзя: платформа не показывает его визуально. Необходимо либо использовать инструмент, который делает выгрузку за вас (консоль запросов), либо выполнить выгрузку программно и посмотреть полученную таблицу.

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

Способ 1. Консоль запросов в режиме 1С:Предприятие

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

Порядок работы простой: откройте консоль в режиме предприятия, вставьте текст запроса, заполните параметры (если они есть), нажмите «Выполнить». Результат появится в табличном поле, его можно прокручивать, сортировать и при необходимости выгрузить.

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

1. 1
   Откройте консоль запросов в режиме 1С:Предприятие
2. 2
   Вставьте текст запроса из кода или напишите новый
3. 3
   Заполните значения всех параметров запроса
4. 4
   Нажмите «Выполнить» и просмотрите таблицу результата
5. 5
   Проверьте количество строк и значения ключевых полей

Способ 2. Просмотр результата через отладчик

Если нужно увидеть результат именно в том контексте, в котором запрос выполняется в коде, используйте отладчик конфигуратора. Поставьте точку останова на строке после Результат = Запрос.Выполнить(), запустите отладку и дождитесь остановки.

Затем откройте «Вычислить выражение» (Ctrl+F9 или Shift+F9 в зависимости от версии платформы) и введите выражение Результат.Выгрузить(). Платформа покажет таблицу значений, которую можно развернуть и просмотреть построчно. Альтернатива — проверить Результат.Пустой, чтобы быстро понять, вернул ли запрос хоть что-то.

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

Результат = Запрос.Выполнить();
// В отладчике вычислите выражение:
// Результат.Выгрузить()
Если Результат.Пустой() Тогда
    Сообщить("Запрос ничего не вернул");
КонецЕсли;

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

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

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

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

Как проверить выборку при обходе результата

Частая задача — убедиться, что обход выборки через Выборка.Следующий() обрабатывает правильные данные. Для этого в отладчике поставьте точку останова внутри цикла обхода и смотрите поля текущей строки выборки через табло или «Вычислить выражение».

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

Полезный приём — перед циклом проверить количество записей: у выгруженной таблицы значений есть метод Количество(). Если строк ноль, а вы ожидали данные, проблема в условиях запроса или параметрах, а не в логике обхода.

Типичные ошибки при просмотре результатов запроса

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

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

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

Что выбрать в разных ситуациях

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

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

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