Разработка и Конфигурация · 10 мин
Как подключить консоль запросов 1С
Как подключить консоль запросов в 1С:Предприятие 8.3: внешние обработки, расширения, типовые средства. Пошаговая инструкция, настройка прав и решение ошибок.
Консоль запросов — инструмент, который позволяет разработчику и аналитику писать, отлаживать и выполнять запросы на встроенном языке запросов 1С без запуска конфигуратора и без изменения самой конфигурации. В типовых поставках платформы отдельной «консоли запросов» в меню нет, поэтому инструмент подключают одним из нескольких способов: внешней обработкой, расширением конфигурации либо через типовые механизмы, встроенные в конфигурацию.
Выбор способа зависит от трёх условий: есть ли у вас права администратора, работаете вы в файловой или клиент-серверной базе и допускает ли политика компании подключение внешних обработок. Ниже разобраны все рабочие варианты — от самого простого открытия файла обработки до постоянной установки через расширение.
Что такое консоль запросов и когда она нужна
Консоль запросов — это внешняя обработка (реже — часть конфигурации), в которой можно составить текст запроса, задать параметры, выполнить запрос и посмотреть результат в виде таблицы. Большинство версий включают конструктор запроса, просмотр временных таблиц и вывод плана выполнения.
Инструмент применяют в нескольких сценариях: проверка выборок перед написанием отчёта, поиск «потерянных» данных в регистрах, анализ причин расхождений в учёте, разовая выгрузка данных для анализа. Бухгалтеру без навыков программирования консоль обычно не нужна — для неё достаточно типовых отчётов. Разработчику и внедренцу консоль заменяет десятки тестовых отчётов.
Способ 1. Открыть консоль как внешнюю обработку
Самый быстрый вариант — запустить готовый файл консоли запросов прямо в режиме предприятия. Подходит, когда нужно разово выполнить запрос и нет задачи встраивать инструмент в интерфейс. Обработку можно взять из стандартной поставки платформы (каталог шаблонов и дистрибутивов), с диска ИТС или использовать один из распространённых вариантов, разработанных сообществом.
- 1Запустите информационную базу в режиме 1С:Предприятие под пользователем с достаточными правами.
- 2Откройте меню «Файл» и выберите пункт «Открыть» (либо нажмите Ctrl+O).
- 3Укажите путь к файлу консоли запросов с расширением .epf и подтвердите открытие.
- 4Если появится предупреждение системы защиты от опасных действий, проверьте источник файла и разрешите открытие.
- 5Дождитесь загрузки формы консоли и выполните тестовый запрос, например выборку из любого справочника.
Если обработка открылась и отобразила форму — подключение завершено. Признак корректной работы: простой запрос вида «ВЫБРАТЬ ПЕРВЫЕ 10 Ссылка ИЗ Справочник.Номенклатура» возвращает таблицу без ошибок. Обратите внимание: при каждом новом сеансе файл придётся открывать заново, если не сохранить его в избранном или не подключить постоянно.
Способ 2. Подключить через «Дополнительные отчеты и обработки»
Если конфигурация построена на Библиотеке стандартных подсистем (это большинство типовых решений: «Управление торговлей», «ERP», «Зарплата и управление персоналом», «Бухгалтерия предприятия»), в ней есть механизм дополнительных отчётов и обработок. Он позволяет зарегистрировать консоль один раз и запускать её из раздела «Администрирование» или «Печатные формы, отчеты и обработки».
Порядок подключения: перейдите в раздел «Администрирование» → «Печатные формы, отчеты и обработки», включите флажок «Дополнительные отчеты и обработки», затем откройте одноимённый список и создайте новый элемент, указав файл .epf. После записи обработка появится в списке и будет доступна всем пользователям, которым выдано соответствующее право.
Способ 3. Установить консоль как расширение конфигурации
Расширение подходит, когда консолью пользуются постоянно и нужно встроить её команду в интерфейс без изменения основной конфигурации. Это актуально для баз, где конфигурация находится на полной поддержке и обновляется автоматически: расширения не мешают обновлению.
Для установки откройте конфигуратор, перейдите в меню «Конфигурация» → «Расширения конфигурации», создайте новое расширение с понятным именем (например, «ИнструментыРазработчика») и добавьте в него обработку с формой консоли. Затем обновите конфигурацию базы данных (F7) и перезапустите сеанс. Команды обработки станут доступны в интерфейсе согласно настройкам подсистем.
Учтите ограничение: расширения работают только в режиме совместимости, который их поддерживает, и требуют прав на администрирование. В файловых базах с несколькими пользователями установку расширения выполняют при завершённых сеансах других пользователей, иначе обновление структуры базы будет заблокировано.
Способ 4. Использовать встроенные и альтернативные инструменты
В некоторых конфигурациях консоль уже присутствует. Например, в типовых решениях на базе БСП есть «Групповое изменение реквизитов» и универсальный отчёт, которые частично закрывают задачи консоли. Кроме того, существуют популярные наборы инструментов разработчика, распространяемые как единая обработка или подсистема, — они включают консоль запросов, редактор СКД, консоль кода и другие средства.
Сравнение способов подключения
Подходит для разовой работы. Не требует настройки, но файл нужно открывать в каждом сеансе.
Оптимально для постоянного использования в типовой конфигурации. Требует включённого механизма БСП и прав на регистрацию.
Для встраивания в интерфейс и работы на базах под полной поддержкой. Требует конфигуратора и прав администратора.
Дают расширенные функции (отладка СКД, консоль кода), но нужно проверять совместимость с версией платформы и конфигурации.
Настройка прав и защиты от опасных действий
Частая причина проблем — не сама консоль, а права доступа. Для открытия внешней обработки пользователю нужно право «Интерактивное открытие внешних отчетов и обработок». Для выполнения запросов к данным — права на чтение соответствующих объектов: консоль не обходит ограничения доступа, и запрос к закрытому регистру вернёт ошибку или пустой результат.
Второй барьер — механизм защиты от опасных действий. При открытии файла платформа может показать предупреждение либо заблокировать выполнение. Администратор управляет этим через параметр защиты в настройках пользователя или через свойства информационной базы. Полностью отключать защиту для всех пользователей не следует: это открывает путь для запуска вредоносных обработок.
Проверка работы и типичные ошибки
После подключения выполните контрольный запрос и сверьте результат с данными, которые видны в интерфейсе. Например, количество элементов справочника в консоли должно совпадать с количеством строк в форме списка (с учётом помеченных на удаление, если запрос их не отбирает). Если консоль открылась, но запрос не выполняется, причина обычно в синтаксисе, правах или в том, что обработка запущена в безопасном режиме.
Как проверить результат
Форма консоли отображается без сообщений об ошибках
Ошибка «Нарушение прав доступа» или пустое окно
Таблица результата заполняется данными
Сообщение о синтаксической ошибке или отсутствии прав на объект
Конструктор запроса открывается и показывает список таблиц
Конструктор недоступен — обработка запущена в безопасном режиме
FAQ
Можно ли подключить консоль запросов без прав администратора?
Да, если у пользователя есть право интерактивного открытия внешних обработок — файл .epf открывается через «Файл → Открыть» без прав администратора. Регистрация в справочнике дополнительных обработок и установка расширения уже требуют расширенных прав.
Работает ли консоль запросов в веб-клиенте?
Большинство современных консолей поддерживают веб-клиент, но с ограничениями: может не работать конструктор запроса и доступ к локальным файлам. Перед использованием проверьте в описании конкретной обработки заявленную поддержку тонкого и веб-клиента.
Консоль запросов может изменить данные в базе?
Сам механизм запросов только читает данные. Однако многие консоли содержат дополнительные функции (консоль кода, пакетная обработка), способные изменять данные. Запускайте такие функции осознанно и предварительно делайте резервную копию или работайте в копии базы.
Почему консоль открывается, но не видит таблиц конфигурации?
Обычно причина в правах: консоль выполняется от имени текущего пользователя и показывает только те объекты, к которым у него есть доступ на чтение. Проверьте роли пользователя или выполните запрос под администратором в тестовой базе.
Нужно ли снимать конфигурацию с поддержки для подключения консоли?
Нет. Все три способа — открытие файла, регистрация в дополнительных обработках и расширение — не требуют изменения основной конфигурации и не нарушают поддержку. Снятие с поддержки потребуется только если вы решите встроить консоль непосредственно в состав конфигурации, что делать не рекомендуется.
Чем консоль запросов отличается от универсального отчёта?
Универсальный отчёт строит выборки по заданным настройкам и ориентирован на пользователя. Консоль запросов работает с произвольным текстом запроса, временными таблицами и параметрами и предназначена для разработчика или аналитика, которому нужен полный контроль над логикой выборки.
Что важно запомнить
Для разовой работы откройте консоль запросов как внешнюю обработку через «Файл → Открыть», для постоянной — зарегистрируйте её в дополнительных отчётах и обработках или установите расширением. Проверяйте права пользователя, источник файла и совместимость с версией платформы, а перед запуском незнакомых обработок работайте в копии базы.