Консоль запросов в 1С 8.3: где взять файл, как открыть и какие нужны права

· 9 мин

Содержание

Чтобы загрузить консоль запросов в 1С 8.3, скачайте внешнюю обработку (обычно файл QueryConsole.epf или КонсольЗапросов.epf) и откройте её в режиме Предприятия через Главное меню → Файл → Открыть (или Ctrl+O). Встраивать её в конфигурацию не нужно. Нужны только две вещи: версия обработки под ваш интерфейс и право на интерактивное открытие внешних обработок.

Типичная ситуация: бухгалтер просит выгрузить список контрагентов с незакрытыми авансами, а готового отчёта нет. Программист открывает консоль запросов, пишет запрос за пять минут и отдаёт результат в Excel. Но в новой базе консоль часто не открывается с первого раза: то нет прав, то файл не под тот клиент.

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

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

Зачем она нужна:

  • 🔍 Проверить данные. Найти документы без контрагента, задвоенные элементы справочника, остатки с минусом.
  • 🛠 Отладить запрос. Прежде чем вставлять текст запроса в модуль, его прогоняют в консоли и смотрят результат.
  • 📊 Сделать разовую выборку. Когда отчёт нужен один раз и настраивать СКД долго.
  • 🧩 Посмотреть временные таблицы и параметры. Хорошие консоли показывают результат каждого пакета отдельно.

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

Консоль выполняет запрос с правами того пользователя, под которым вы вошли. Если в базе настроено ограничение доступа на уровне записей, запрос без слова РАЗРЕШЕННЫЕ может завершиться ошибкой «Нарушение прав доступа», а с ним — вернуть только часть строк.

Откуда скачать консоль запросов для 1С 8.3

Своей консоли в типовых конфигурациях нет, обработку берут отдельно. Источников три.

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

Как выбрать версию под свою базу:

  1. Узнайте интерфейс. Если у вас «Такси» и вы работаете в тонком клиенте (БП 3.0, ЗУП 3.1, УТ 11), нужна консоль на управляемых формах.
  2. Если база старая, на обычных формах (например, БП 2.0, УПП), подойдёт консоль на обычных формах. Она открывается только в толстом клиенте.
  3. Проверьте, под какую версию платформы сохранена обработка. Файл, сохранённый в более новой платформе, старая платформа может не открыть.

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

Как загрузить консоль запросов в режиме Предприятия

Основной способ — открыть обработку как файл. Он одинаковый для всех конфигураций на платформе 8.3, разницы между БП, ЗУП и УТ здесь нет.

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

Проверьте, что консоль работает, коротким запросом:

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

Нажмите кнопку выполнения (в большинстве консолей — «Выполнить» или F5/Ctrl+Enter, зависит от обработки). Если вернулось десять строк, всё настроено.

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

Параметры и метаданные в консоли

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

ВЫБРАТЬ
    Остатки.Счет,
    Остатки.Субконто1 КАК Контрагент,
    Остатки.СуммаОстатокДт,
    Остатки.СуммаОстатокКт
ИЗ
    РегистрБухгалтерии.Хозрасчетный.Остатки(&Период, Счет В ИЕРАРХИИ (&Счет60), , ) КАК Остатки

После ввода текста нажмите в консоли команду заполнения параметров (обычно она так и называется). Консоль найдёт &Период и &Счет60 и предложит задать значения: дату и ссылку на счёт из плана счетов. Этот пример рассчитан на БП 3.0, где регистр бухгалтерии называется Хозрасчетный.

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

Почему консоль не стоит регистрировать как дополнительную обработку

В конфигурациях на БСП есть раздел Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. Туда добавляют обработки, которые потом видят пользователи. Консоль запросов для этого обычно не подходит: в ней нет служебного описания, которое требуется для регистрации, и программа откажется её добавлять. Да и давать её рядовым пользователям незачем. Открывайте консоль через Файл → Открыть.

Права, без которых консоль не откроется

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

В типовых конфигурациях на БСП (БП 3.0, ЗУП 3.1, УТ 11)

Права здесь выдают не ролями напрямую, а через профили групп доступа.

  1. Откройте Администрирование → Настройки пользователей и прав.
  2. Перейдите в «Профили групп доступа».
  3. Найдите профиль, в который входит роль «Интерактивное открытие внешних отчетов и обработок». В профиле «Администратор» она есть.
  4. Если нужно выдать право не администратору, создайте копию подходящего профиля, отметьте в его ролях эту роль и включите пользователя в группу доступа с новым профилем.
  5. Пользователю нужно перезайти в базу, чтобы права применились.

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

В самописных и нетиповых конфигурациях

  1. Откройте Конфигуратор, ветку Общие → Роли.
  2. Откройте роль пользователя (или создайте отдельную роль) и встаньте на корень дерева — саму конфигурацию.
  3. В правах отметьте «Интерактивное открытие внешних обработок».
  4. Сохраните конфигурацию и обновите конфигурацию базы данных (F7).
  5. В списке пользователей (Администрирование → Пользователи) добавьте эту роль нужному пользователю.

Окно «Предупреждение безопасности»

Начиная с платформы 8.3.9 при открытии внешней обработки появляется окно с предупреждением. Его вызывает флаг «Защита от опасных действий» в свойствах пользователя. Окно ничего не запрещает, оно лишь просит подтвердить, что вы доверяете файлу.

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

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

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

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

Консоль на обычных формах не работает в тонком клиенте. Чтобы открыть её в базе с «Такси»:

  1. В Конфигураторе откройте Сервис → Параметры, вкладка «Запуск 1С:Предприятия».
  2. В основном режиме запуска выберите «Толстый клиент (обычное приложение)».
  3. Запустите Предприятие из Конфигуратора (F5 или кнопкой на панели).
  4. Откройте обработку через Файл → Открыть.

Тот же результат даёт параметр запуска /RunModeOrdinaryApplication. Его можно прописать в дополнительных параметрах базы в окне запуска («Изменить» → последняя страница мастера).

Ярлык, который сразу открывает консоль

Параметр /Execute указывает внешнюю обработку, которую платформа откроет при запуске:

"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Администратор" /Execute "C:\Tools\1C\QueryConsole.epf"

Для клиент-серверной базы вместо /F укажите /S"сервер\имябазы". Пароль в ярлыке лучше не хранить: оставьте /N, а пароль вводите при входе.

Отладка консоли из Конфигуратора

Если консоль ведёт себя странно, её можно открыть в Конфигураторе через Файл → Открыть, поставить точку останова в модуле и запустить отладку (Отладка → Начать отладку → 1С:Предприятие). В открывшемся Предприятии откройте тот же файл — отладчик остановится в нужном месте.

Встроить консоль через расширение

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

  1. В Конфигураторе Конфигурация → Расширения конфигурации создайте расширение.
  2. В его дереве на ветке «Обработки» вызовите контекстное меню и вставьте внешнюю обработку из файла.
  3. Добавьте в расширение роль с правами «Использование» и «Просмотр» на эту обработку и назначьте её пользователю.
  4. Обновите расширение в базе.

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

Не открывается консоль: ошибки и решения

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

Если не помогло

  • 🔄 Проверьте, что вы открываете тот файл. Иногда браузер сохраняет .epf как архив или переименовывает его.
  • 🧪 Откройте консоль в копии базы на своём компьютере. Если там работает, причина в правах или настройках рабочей базы, а не в обработке.
  • 🛡 Посмотрите, не блокирует ли файл антивирус: некоторые помечают .epf из интернета как подозрительные и удаляют при скачивании.
  • 👤 Войдите под пользователем с полными правами. Если под ним всё открывается, дело точно в ролях.

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

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