К статье
Практический материал

Разработка и Конфигурация · 12 мин

Как вызвать консоль запросов в 1С

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

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

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

Ниже разобраны все рабочие способы открыть консоль запросов: через меню «Файл», из типовых конфигураций на базе БСП, через отладку, а также программный вызов. Отдельно рассмотрены ограничения по правам доступа и типичные ошибки, из-за которых обработка не открывается.

Что такое консоль запросов и когда она нужна

Консоль запросов — это внешняя обработка или встроенный инструмент, который принимает текст запроса на языке запросов 1С, выполняет его в контексте текущей информационной базы и показывает результат в виде таблицы. Большинство версий консоли позволяют работать с параметрами, временными таблицами и пакетными запросами.

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

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

Открытие консоли запросов как внешней обработки

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

Порядок действий в тонком клиенте: откройте меню «Файл» → «Открыть» (в некоторых интерфейсах — кнопка с папкой или сочетание Ctrl+O), укажите путь к файлу консоли запросов на диске, подтвердите открытие. Платформа может показать предупреждение безопасности об открытии внешних файлов — подтвердите, если источнику файла вы доверяете.

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

Порядок действий
  1. 1
    Найдите или скачайте файл консоли запросов (.epf)
  2. 2
    В режиме 1С:Предприятие откройте Файл → Открыть (Ctrl+O)
  3. 3
    Укажите путь к файлу обработки и подтвердите открытие
  4. 4
    При появлении предупреждения безопасности подтвердите запуск
  5. 5
    Выполните тестовый запрос к любому справочнику для проверки

Запуск консоли в типовых конфигурациях на базе БСП

В конфигурациях, построенных на библиотеке стандартных подсистем (1С:ERP, 1С:Комплексная автоматизация, 1С:ЗУП, 1С:Бухгалтерия и других), часто встроена подсистема «Инструменты разработчика» или аналогичная. В таком случае консоль запросов доступна прямо из интерфейса, без внешнего файла.

Типичный путь: раздел «Администрирование» → «Обслуживание» → группа «Инструменты разработчика» или отдельная команда «Консоль запросов». В некоторых конфигурациях эти команды скрыты функциональными опциями — тогда сначала включите соответствующую опцию в настройках или запустите базу с правами администратора.

Если встроенной консоли нет, но конфигурация на управляемых формах, обратите внимание на формат внешней обработки: старые консоли, написанные под обычные формы, в управляемом приложении не откроются или откроются с ошибкой. Нужна версия консоли, адаптированная под управляемые формы.

Вызов консоли запросов из конфигуратора и при отладке

Если вы работаете в конфигураторе, полноценная внешняя консоль не нужна для проверки текста запроса: встроенный конструктор запроса вызывается из контекстного меню модуля. Установите курсор в текст запроса в коде, нажмите правую кнопку мыши и выберите «Конструктор запроса» — откроется визуальный редактор, где можно проверить синтаксис и структуру запроса.

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

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

Программный вызов и открытие из кода

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

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

Если консоль встроена в состав конфигурации как объект «Обработка», её форму открывают стандартно — через команду открытия формы обработки по имени объекта метаданных, без указания файлового пути. Это самый надёжный вариант для внедрений, где консоль должна быть доступна пользователям постоянно.

bsl
// Открытие внешней консоли запросов в управляемом приложении
ПутьКОбработке = "C:\Tools\КонсольЗапросов.epf";
АдресХранилища = "";
НачатьПомещениеФайла(, АдресХранилища, ПутьКОбработке, Ложь);
ИмяОбработки = ВнешниеОбработки.Подключить(АдресХранилища,, Ложь);
ОткрытьФорму("ВнешняяОбработка." + ИмяОбработки + ".Форма");

Права доступа и ограничения безопасности

Открытие внешних обработок регулируется правами. Если у пользователя нет права «Интерактивное открытие внешних обработок», команда «Файл → Открыть» для .epf-файла будет недоступна или завершится ошибкой. Право назначается в роли пользователя в конфигураторе.

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

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

Частые ошибки при открытии консоли и их решение

Ошибка «Ошибка при вызове метода контекста» или пустое окно вместо формы чаще всего означает несовместимость режимов: обработка написана под обычные формы, а запускается в управляемом приложении. Решение — найти версию консоли под управляемые формы либо запустить базу в режиме обычного приложения через толстый клиент.

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

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

Типичные ошибки
01
Запуск консоли под обычные формы в управляемом приложении — обработка не открывается или падает с ошибкой
02
Отсутствие права интерактивного открытия внешних обработок — команда открытия недоступна
03
Копирование текста запроса из консоли в модуль без замены имён таблиц под конкретную конфигурацию
04
Открытие обработки из непроверенного источника без просмотра её модуля — риск выполнения вредоносного кода
Маршрут решения

Как выбрать способ вызова

Конфигурация типовая на БСП и есть раздел «Инструменты разработчика»Используйте встроенную консоль запросов из этого раздела
Встроенной консоли нет, работаете в тонком клиентеОткройте внешнюю обработку .epf под управляемые формы через Файл → Открыть
Нужно только проверить синтаксис запроса из модуляИспользуйте конструктор запроса в конфигураторе через контекстное меню
Консоль нужна пользователям постоянноВстройте обработку в состав конфигурации или подключите через механизм дополнительных отчётов и обработок

Как проверить, что консоль работает корректно

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

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

Контрольные точки

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

Выполнение тестового запроса к справочнику
Норма

Таблица результата заполнена, ошибок нет

Тревожный признак

Ошибка о несуществующей таблице или пустой результат при заведомо заполненном справочнике

Работа с параметрами запроса
Норма

Параметр подставляется, отбор срабатывает

Тревожный признак

Ошибка несовпадения типов или параметр игнорируется

Открытие формы обработки
Норма

Форма открылась полностью, все элементы доступны

Тревожный признак

Пустое окно или ошибка при создании формы — несовместимость режимов

Итог

Что важно запомнить

Консоль запросов вызывается либо как внешняя обработка через Файл → Открыть, либо из встроенных инструментов разработчика в типовых конфигурациях. Проверяйте совместимость обработки с режимом приложения, наличие прав на открытие внешних файлов и не запускайте обработки из непроверенных источников.

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

Почему команда «Файл → Открыть» не открывает файл консоли запросов?

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

Можно ли открыть консоль запросов в веб-клиенте?

Да, если обработка написана под управляемые формы и не использует недоступные в веб-клиенте механизмы. Открытие происходит так же — через команду открытия файла, но файл сначала передаётся на сервер. Обработки под обычные формы в веб-клиенте не работают.

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

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

Опасно ли выполнять запросы в консоли на рабочей базе?

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

Как сделать консоль запросов доступной пользователям постоянно?

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

Консоль открылась, но запрос к моему документу выдаёт ошибку. В чём дело?

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