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

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

Где найти консоль запросов в 1С и как ей пользоваться

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

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

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

Зачем нужна консоль запросов и кому она доступна

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

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

Консоль запросов в конфигураторе: конструктор запроса

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

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

Где искать консоль в типовых конфигурациях

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

В конфигурациях «1С:ERP», «1С:Комплексная автоматизация» и «1С:Управление холдингом» встречаются встроенные инструменты разработчика, доступные при включённом режиме технического специалиста. Путь обычно выглядит так: «НСИ и администрирование» → «Администрирование» → «Обслуживание» → включить «Режим технического специалиста», после чего в меню появляются дополнительные команды. Состав инструментов зависит от версии конфигурации.

Внешняя обработка «Консоль запросов»: где взять и как открыть

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

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

Консоль кода и инструменты разработчика как альтернатива

Если задача шире, чем один запрос, удобнее использовать расширенные инструменты: консоль кода, консоль СКД, редактор СКД. Они входят, например, в подсистему «Инструменты разработчика» и позволяют выполнять произвольный код, работать с наборами данных и отлаживать схемы компоновки. Такие инструменты подключаются как внешние обработки и работают в толстом, тонком и веб-клиенте (с ограничениями).

Для разработчиков, работающих в EDT, есть отдельные плагины и панели для выполнения запросов. Выбор инструмента зависит от задачи: для одноразового просмотра данных достаточно простой консоли запросов, для регулярной отладки отчётов — консоли СКД, для комплексной разработки — полного набора инструментов.

Сравнение вариантов

Конструктор запроса в конфигураторе

Подходит для построения и проверки синтаксиса запроса. Ограничение: не выполняет запрос и не показывает данные.

Внешняя консоль запросов (.epf)

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

Инструменты разработчика

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

Отладка в конфигураторе

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

Настройка прав и типичные ограничения

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

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

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

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

Обработка открылась
Норма

Появилось окно консоли с полем текста запроса

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

Ошибка «Нарушение прав доступа» — нет права интерактивного открытия внешних обработок

Запрос выполняется
Норма

В нижней части окна появилась таблица с данными

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

Ошибка синтаксиса или «Поле не найдено» — проверьте имена таблиц и полей

Данные соответствуют ожиданиям
Норма

Количество строк и значения совпадают с данными в отчётах

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

Пустой результат при заведомо существующих данных — проверьте параметры, период и права на объекты

Частые ошибки при работе с консолью запросов

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

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

Типичные ошибки
01
Открытие обработки для обычных форм в управляемом приложении — консоль не запускается, нужна версия для управляемых форм.
02
Неуказанные параметры запроса — ошибка выполнения или пустой результат; сначала заполните таблицу параметров.
03
Выполнение тяжёлого запроса без отбора по периоду в рабочей базе — долгое выполнение и блокировки; добавляйте условия по дате и измерениям.
04
Работа в рабочей базе без копии при отладке сложных запросов — риск нагрузить систему в часы работы пользователей.

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

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

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

Итог

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

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

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

Есть ли консоль запросов в стандартной поставке 1С:Бухгалтерии?

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

Почему при открытии обработки появляется ошибка «Нарушение прав доступа»?

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

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

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

Можно ли пользоваться консолью запросов в облачной 1С (модель сервиса)?

В модели сервиса произвольные внешние обработки обычно запрещены политикой безопасности. Разрешены только обработки, прошедшие проверку сервиса и добавленные через механизм дополнительных отчетов и обработок. Уточните у администратора сервиса, какие инструменты доступны в вашем абоненте.

Как выполнить запрос, если база файловая и нет диска ИТС?

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

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

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