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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если конфигурация построена на Библиотеке стандартных подсистем (это большинство типовых решений: «Управление торговлей», «ERP», «Зарплата и управление персоналом», «Бухгалтерия предприятия»), в ней есть механизм дополнительных отчётов и обработок. Он позволяет зарегистрировать консоль один раз и запускать её из раздела «Администрирование» или «Печатные формы, отчеты и обработки».

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

Способ 3. Установить консоль как расширение конфигурации

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

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

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

Способ 4. Использовать встроенные и альтернативные инструменты

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

Сравнение способов подключения

Открытие .epf через «Файл → Открыть»

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

Дополнительные отчеты и обработки

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

Расширение конфигурации

Для встраивания в интерфейс и работы на базах под полной поддержкой. Требует конфигуратора и прав администратора.

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

Дают расширенные функции (отладка СКД, консоль кода), но нужно проверять совместимость с версией платформы и конфигурации.

Настройка прав и защиты от опасных действий

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

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

Проверка работы и типичные ошибки

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

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

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

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

Форма консоли отображается без сообщений об ошибках

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

Ошибка «Нарушение прав доступа» или пустое окно

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

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

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

Сообщение о синтаксической ошибке или отсутствии прав на объект

Доступность конструктора
Норма

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

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

Конструктор недоступен — обработка запущена в безопасном режиме

FAQ

Можно ли подключить консоль запросов без прав администратора?

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

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

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

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

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

Почему консоль открывается, но не видит таблиц конфигурации?

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

Нужно ли снимать конфигурацию с поддержки для подключения консоли?

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

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

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

Итог

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

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