Как открыть консоль запросов в 1С 8.3 и начать с ней работать

· 9 мин

Содержание

В типовых конфигурациях 1С 8.3 (Бухгалтерия, ЗУП, УТ) консоли запросов нет. Её открывают как внешнюю обработку : файл .epf через меню Файл — Открыть или через раздел дополнительных обработок, если он включён в базе. Второй способ — написать запрос прямо в отладчике Конфигуратора.

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

Что такое консоль запросов и откуда она берётся

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

Для чего консоль нужна на практике:

  • 🔍 проверить, почему в отчёте нет нужной строки;
  • 📊 быстро выгрузить данные из регистра, который не выводится в интерфейс;
  • 🛠 отладить запрос перед тем, как вставить его в код отчёта или обработки;
  • 🧹 найти дубли и «битые» ссылки в справочниках.

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

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

Запуск готовой консоли в режиме 1С:Предприятие

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

Открыть файл консоли вручную

  1. Запустите базу в режиме 1С:Предприятие под пользователем с полными правами.
  2. Нажмите Ctrl+O или откройте меню Файл — Открыть. В 8.3 на тонком клиенте меню «Файл» скрыто за значком главного меню в левом верхнем углу.
  3. Выберите файл .epf с консолью.
  4. Если платформа спросит про безопасный режим, подтвердите открытие. Для консоли это нормально, она ничего не ставит на компьютер.

Если пункта «Открыть» нет — у вашей роли нет права «Интерактивное открытие внешних обработок и отчётов». Про это ниже, в разделе про права.

Подключить консоль к базе постоянно

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

  1. Откройте раздел администрирования и найдите настройки дополнительных отчётов и обработок. Название раздела зависит от конфигурации, поэтому ищите по слову «обработки» в строке поиска по меню.
  2. Включите использование дополнительных отчётов и обработок.
  3. Создайте новый элемент справочника «Дополнительные отчёты и обработки» и загрузите в него файл консоли.
  4. Укажите вид — «Дополнительная обработка», разместите её в нужном разделе и задайте, кому она доступна.
  5. Запишите элемент. Консоль появится в выбранном разделе как обычная команда.

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

Запуск консоли через Конфигуратор

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

Есть два способа.

Внешний файл из Конфигуратора

Откройте Конфигуратор, затем Файл — Открыть и выберите .epf. Обработка откроется в редакторе. Из него её можно запустить на исполнение кнопкой «Запуск 1С:Предприятие» или F5, а также отладить: поставить точку останова и пройти код по шагам.

Так проверяют консоль, которая выдаёт ошибку: в отладчике видно, на какой строке модуля всё падает.

Запрос без консоли — в отладчике

Если консоли нет вообще, а запрос выполнить надо срочно, поможет окно вычисления выражения.

  1. Запустите базу из Конфигуратора в режиме отладки.
  2. Остановите выполнение на любой точке останова.
  3. Откройте Отладка — Вычислить выражение (сочетание Shift+F9).
  4. Введите код, который создаёт объект запроса и выполняет его, и посмотрите результат в окне.

Результат придётся разворачивать построчно. Для больших выборок это неудобно, зато работает там, где ничего другого нет.

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

Внешняя обработка Console.epf: откуда взять и как проверить

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

Как выбрать безопасный вариант:

КритерийНа что смотреть
ИсточникСайт или форум 1С-разработчиков с историей и обсуждением, а не файл из случайного архива
Исходный кодЛучше, чтобы автор выкладывал его открыто: обработку можно открыть в Конфигураторе и прочитать модуль
Версия платформыКонсоль должна поддерживать вашу версию 8.3 — это указано в описании
Режим формДля тонкого клиента нужна версия на управляемых формах

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

Дальше консоль проверяют так: запускают на тестовой копии и выполняют простой запрос.

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

Если таблица заполнилась десятью строками — консоль работает. В конфигурации без справочника «Номенклатура» (например, в ЗУП) замените имя на Справочник.Сотрудники.

Права доступа: какая роль нужна для консоли

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

Что нужноГде включаетсяЧто будет без этого
Открытие внешних файловПраво «Интерактивное открытие внешних обработок и отчётов» в ролиНет пункта «Открыть» или он выдаёт отказ
Выполнение самой обработкиПраво на её использование: для дополнительной обработки — список пользователей в карточке, для файла — полные праваКонсоль открывается, но кнопки не работают
Чтение данныхПрава на чтение объектов, к которым обращается запросЗапрос выполняется, но возвращает меньше данных или падает с ошибкой прав

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

Как выдать право

  1. Откройте Конфигуратор и найдите нужную роль в дереве конфигурации.
  2. Включите право на интерактивное открытие внешних обработок. Для расширенных конфигураций роль могут не менять, а добавляют свою.
  3. Назначьте роль пользователю в списке пользователей базы.
  4. Пользователь должен перезапустить сеанс: права подхватываются при входе.

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

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

Что делать, если консоль не запускается

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

Диагностика: выберите симптом

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

Частые ошибки и как их избежать

Многие проблемы с консолью возникают не из-за неё, а из-за того, как с ней работают.

  • ❌ Запуск на рабочей базе без копии. Консоль в большинстве версий умеет только читать, но некоторые поддерживают выполнение кода. Сделайте копию, прежде чем пробовать незнакомую обработку.
  • ❌ Запрос без ограничений. Выборка всех строк из регистра накопления за пять лет может занять минуты и нагрузить сервер. Начинайте с ПЕРВЫЕ 100.
  • ❌ Забытые параметры. Если в запросе есть &Организация или &НачалоПериода, их нужно задать в таблице параметров консоли. Без этого запрос вернёт пусто.
  • ❌ Консоль у всех. Файл на общем сетевом диске, который открывают все сотрудники, — это открытый доступ к данным. Раздавайте её через список пользователей дополнительной обработки.
  • ❌ Копирование чужого запроса без проверки. Имена объектов в разных конфигурациях отличаются, поэтому запрос из интернета часто требует правки.

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

Перед первым запуском консоли на рабочей базе
Выполнено: 0 / 5

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

Консоль нужна не всегда. Иногда задачу решают другие инструменты, и их стоит знать.

ИнструментКогда подойдётОграничение
Конструктор запроса в КонфигуратореСобрать текст запроса мышью, без памяти по синтаксисуНе показывает результат на данных
Система компоновки данных, отчёт пользователяПостоянный отчёт с отбором и группировкойДля разовой выгрузки слишком громоздко
Универсальный отчёт из типовой конфигурацииПосмотреть данные регистра без программированияНе всегда есть в базе, ограничен набором полей
Выгрузка данных в файл и анализ в таблицахДанных мало, а аналитик привык к электронным таблицамНужно выгружать, данные быстро устаревают
Прямой запрос к базе на стороне СУБДФайловая или клиент-серверная база, нужна скоростьСтруктура таблиц сложная, это небезопасно и может нарушить лицензионные условия

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

Обращаться к таблицам СУБД напрямую в обход 1С не рекомендуют: можно получить неверные данные и сломать целостность, если что-то записать. Для чтения лучше консоль, она работает через объектную модель 1С.

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

Консоль запросов встроена в 1С 8.3?
Нет, в типовых конфигурациях её нет. Её загружают как внешнюю обработку .epf или добавляют в базу через дополнительные обработки.
Можно ли пользоваться консолью без прав администратора?
Да, если у роли есть право открывать внешние обработки и читать нужные объекты. Полные права для этого не обязательны, но так проще.
Консоль может испортить данные?
Большинство версий только читают, но обработка — это код, а код может делать что угодно. Поэтому незнакомый файл проверяют в Конфигураторе и сначала запускают на копии.
Работает ли консоль в тонком клиенте и веб-клиенте?
Тонкий клиент — да, если консоль на управляемых формах. В веб-клиенте открытие внешних файлов часто ограничено настройками браузера и сервера, поэтому надёжнее тонкий клиент.
Нужно ли знать язык запросов, чтобы работать с консолью?
Базовые знания нужны. Помогает конструктор запроса, который есть в большинстве консолей: он собирает текст по выбору таблиц и полей.
Как сохранить написанный запрос, чтобы не потерять?
Расширенные консоли умеют сохранять запросы в файл или список. Если такой функции нет, держите текст отдельным файлом с описанием, для чего он нужен.