Как включить консоль запросов в 1С

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

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

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

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

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

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

Способ 1. Открыть консоль запросов как внешнюю обработку

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

Порядок действий одинаков для большинства конфигураций на управляемых формах (Управление торговлей, Бухгалтерия предприятия, ERP и другие):

1. 1
   Запустите базу в режиме 1С:Предприятие под пользователем с достаточными правами.
2. 2
   Откройте главное меню (кнопка с логотипом или «бургер» в левом верхнем углу) и выберите «Файл → Открыть».
3. 3
   Укажите путь к файлу консоли запросов с расширением .epf и нажмите «Открыть».
4. 4
   Дождитесь загрузки формы обработки, введите текст запроса и нажмите «Выполнить».
5. 5
   Проверьте результат: таблица с данными должна появиться в нижней части окна консоли.

В конфигурациях на обычных формах (например, старые версии Управления торговлей 10.3) путь аналогичен: меню «Файл → Открыть» доступно в главном меню программы. После открытия обработка работает как обычное окно внутри сеанса.

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

Способ 2. Подключить консоль через дополнительные отчёты и обработки

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

Чтобы подключить обработку, перейдите в раздел «Администрирование → Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки». Затем откройте одноимённый справочник, создайте новый элемент и загрузите файл консоли. После записи обработка станет доступна в выбранных разделах командного интерфейса.

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

Способ 3. Консоль запросов в конфигураторе и отладке

Если у вас есть доступ к конфигуратору, для отладки запроса не всегда нужна отдельная консоль. Во время отладки можно остановиться на точке останова, открыть «Табло» (Ctrl+Alt+W) или окно «Вычислить выражение» (Shift+F9) и выполнить произвольный код, включая создание объекта «Запрос» с нужным текстом.

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

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

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ ПЕРВЫЕ 10 Ссылка ИЗ Справочник.Номенклатура";
Результат = Запрос.Выполнить().Выгрузить();

Способ 4. Готовые инструменты разработчика

Существуют распространённые наборы инструментов для разработчика, в состав которых входит продвинутая консоль запросов: с подсветкой синтаксиса, конструктором, просмотром временных таблиц и планов запроса. Такие наборы распространяются как внешние обработки и открываются тем же способом — через «Файл → Открыть».

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

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

Открытие внешних обработок регулируется правом «Интерактивное открытие внешних обработок». Если у пользователя этого права нет, при попытке открыть файл появится сообщение о нарушении прав доступа. Право назначается через роли в конфигураторе или через профили групп доступа в конфигурациях на БСП.

Дополнительно платформа поддерживает режим защиты от опасных действий. Если он включён, при открытии обработки появится предупреждение, а часть операций (работа с файловой системой, запуск внешних приложений) будет заблокирована. На сервере защита включается свойством кластера, в файловом режиме — параметром запуска.

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

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

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

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

Проверка результата и дальнейшие шаги

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

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

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