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

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

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

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

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

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

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

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

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

Способ 1. Запуск внешней обработки через меню «Файл»

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

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

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

Способ 2. Запуск через «Все функции» и стандартные команды

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

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

Способ 3. Запуск из конфигуратора

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

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

Способ 4. Программный запуск консоли

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

bsl
// Толстый клиент — прямое открытие внешней обработки
Обработка = ВнешниеОбработки.ПолучитьФорму("C:\Инструменты\КонсольЗапросов.epf");
Обработка.Открыть();

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

Настройка прав доступа и режима запуска

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

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

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

Внешняя обработка (.epf)

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

Встроенная в конфигурацию

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

Через доп. обработки БСП

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

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

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

bsl
ВЫБРАТЬ ПЕРВЫЕ 10
	Номенклатура.Ссылка КАК Ссылка,
	Номенклатура.Наименование КАК Наименование
ИЗ
	Справочник.Номенклатура КАК Номенклатура
Контрольные точки

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

Форма консоли открылась
Норма

Видны поле текста запроса, кнопка выполнения, область результата

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

Пустое окно или ошибка открытия формы — вероятно, обработка на обычных формах запущена в тонком клиенте

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

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

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

Ошибка «Таблица не найдена» — в конфигурации нет такого объекта, проверьте имя справочника

Конструктор запроса
Норма

Конструктор открывается и показывает список объектов базы

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

Конструктор недоступен в тонком клиенте у части обработок — это ограничение платформы

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

Наиболее частая проблема — сообщение «Рекомендуется не запускать внешние обработки из недоверенных источников» или полный запрет открытия. Это работает защита от опасных действий: её можно отключить в настройках пользователя (галочка «Защита от опасных действий» в свойствах пользователя в конфигураторе) или подтвердить открытие в диалоге.

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

Типичные ошибки
01
Открытие обработки на обычных формах в тонком клиенте — форма не отображается. Решение: использовать консоль на управляемых формах или толстый клиент.
02
Игнорирование предупреждения безопасности и открытие обработки из непроверенного источника — риск выполнения вредоносного кода. Скачивайте инструменты только из доверенных источников.
03
Попытка выполнить запрос с параметром-таблицей значений без её заполнения в консоли — ошибка выполнения. Сначала создайте таблицу на вкладке параметров.
04
Отсутствие прав на чтение объекта — запрос выполняется, но возвращает пустой результат, что легко принять за отсутствие данных.

FAQ

В меню нет пункта «Консоль запросов» — где её искать?

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

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

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

Консоль запросов изменяет данные в базе?

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

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

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

Где взять файл консоли запросов, если его нет?

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

Как открыть консоль, если запрещены внешние обработки?

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

Итог

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

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