Консоль запросов в 1С 8.3: где взять файл, как открыть и какие нужны права
Содержание
Чтобы загрузить консоль запросов в 1С 8.3, скачайте внешнюю обработку
(обычно файл QueryConsole.epf или КонсольЗапросов.epf) и откройте её в режиме Предприятия через Главное меню → Файл → Открыть (или Ctrl+O). Встраивать её в конфигурацию не нужно. Нужны только две вещи: версия обработки под ваш интерфейс и право на интерактивное открытие внешних обработок.
Типичная ситуация: бухгалтер просит выгрузить список контрагентов с незакрытыми авансами, а готового отчёта нет. Программист открывает консоль запросов, пишет запрос за пять минут и отдаёт результат в Excel. Но в новой базе консоль часто не открывается с первого раза: то нет прав, то файл не под тот клиент.
Что такое консоль запросов и когда без неё не обойтись
Консоль запросов — это внешняя обработка, которая выполняет запрос на языке запросов 1С прямо в пользовательском режиме. Результат выводится таблицей, которую можно сохранить или скопировать.
Зачем она нужна:
- 🔍 Проверить данные. Найти документы без контрагента, задвоенные элементы справочника, остатки с минусом.
- 🛠 Отладить запрос. Прежде чем вставлять текст запроса в модуль, его прогоняют в консоли и смотрят результат.
- 📊 Сделать разовую выборку. Когда отчёт нужен один раз и настраивать СКД долго.
- 🧩 Посмотреть временные таблицы и параметры. Хорошие консоли показывают результат каждого пакета отдельно.
Консоль работает только на чтение, если в тексте запроса нет ничего, кроме выборки. Язык запросов 1С не умеет UPDATE и DELETE, так что случайно испортить данные одним запросом нельзя. Но тяжёлый запрос без условий по большой таблице нагрузит сервер, и это почувствуют все пользователи.
Консоль выполняет запрос с правами того пользователя, под которым вы вошли. Если в базе настроено ограничение доступа на уровне записей, запрос без слова РАЗРЕШЕННЫЕ может завершиться ошибкой «Нарушение прав доступа», а с ним — вернуть только часть строк.
Откуда скачать консоль запросов для 1С 8.3
Своей консоли в типовых конфигурациях нет, обработку берут отдельно. Источников три.
| Источник | Что там | Кому подходит |
|---|---|---|
| Портал ИТС и набор стандартных обработок фирмы 1С | Консоль запросов на управляемых формах, QueryConsole.epf | Тем, у кого есть подписка ИТС; самый надёжный вариант |
| Комплект «Инструменты разработчика» (бесплатный, автор — Сергей Старых) | Расширенная консоль с деревом метаданных, планом запроса и множеством сервисов | Программистам, которые работают с консолью каждый день |
| Сообщество разработчиков (Инфостарт и подобные) | Десятки вариантов консолей | Если нужна конкретная функция; проверяйте автора и отзывы |
Как выбрать версию под свою базу:
- Узнайте интерфейс. Если у вас «Такси» и вы работаете в тонком клиенте (БП 3.0, ЗУП 3.1, УТ 11), нужна консоль на управляемых формах.
- Если база старая, на обычных формах (например, БП 2.0, УПП), подойдёт консоль на обычных формах. Она открывается только в толстом клиенте.
- Проверьте, под какую версию платформы сохранена обработка. Файл, сохранённый в более новой платформе, старая платформа может не открыть.
Не скачивайте .epf с сайтов-однодневок. Внешняя обработка — это исполняемый код с правами пользователя. Внутри может оказаться что угодно, вплоть до отправки данных базы на сторонний сервер. Если сомневаетесь, откройте файл в Конфигураторе и просмотрите модуль до первого запуска.
Как загрузить консоль запросов в режиме Предприятия
Основной способ — открыть обработку как файл. Он одинаковый для всех конфигураций на платформе 8.3, разницы между БП, ЗУП и УТ здесь нет.
- Сохраните файл обработки на диск. Удобно держать его в постоянной папке, например
C:\Tools\1C\QueryConsole.epf, чтобы не искать каждый раз. - Запустите базу в режиме «1С:Предприятие».
- Нажмите кнопку главного меню (значок с тремя полосками в левом верхнем углу) и выберите
Файл → Открыть. Быстрее —Ctrl+O. - Укажите файл
.epfи нажмите «Открыть». - Если появится окно «Предупреждение безопасности», прочтите его и подтвердите открытие. Это штатная защита платформы, о ней ниже.
- Откроется форма консоли. Слева или сверху — поле текста запроса, ниже — таблица результата.
Проверьте, что консоль работает, коротким запросом:
ВЫБРАТЬ ПЕРВЫЕ 10
Контрагенты.Ссылка,
Контрагенты.ИНН
ИЗ
Справочник.Контрагенты КАК Контрагенты
Нажмите кнопку выполнения (в большинстве консолей — «Выполнить» или F5/Ctrl+Enter, зависит от обработки). Если вернулось десять строк, всё настроено.
Пишите запрос через конструктор. Почти все консоли на управляемых формах умеют вызывать конструктор запроса: он покажет дерево таблиц базы, поля и связи. Так вы видите метаданные конфигурации без доступа в Конфигуратор.
Параметры и метаданные в консоли
Запросы с параметрами — главное, ради чего консоль удобнее любого отчёта. Параметр обозначают амперсандом, а значение задают в отдельной таблице параметров на форме консоли:
ВЫБРАТЬ
Остатки.Счет,
Остатки.Субконто1 КАК Контрагент,
Остатки.СуммаОстатокДт,
Остатки.СуммаОстатокКт
ИЗ
РегистрБухгалтерии.Хозрасчетный.Остатки(&Период, Счет В ИЕРАРХИИ (&Счет60), , ) КАК Остатки
После ввода текста нажмите в консоли команду заполнения параметров (обычно она так и называется). Консоль найдёт &Период и &Счет60 и предложит задать значения: дату и ссылку на счёт из плана счетов. Этот пример рассчитан на БП 3.0, где регистр бухгалтерии
называется Хозрасчетный.
Метаданные — имена справочников, документов, регистров и их полей — консоль берёт из самой базы. Поэтому дерево таблиц в конструкторе запроса всегда совпадает с вашей конфигурацией, включая доработки и расширения. Если нужное поле не видно, проверьте, есть ли у вас право на чтение этого объекта.
Почему консоль не стоит регистрировать как дополнительную обработку
В конфигурациях на БСП есть раздел Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. Туда добавляют обработки, которые потом видят пользователи. Консоль запросов для этого обычно не подходит: в ней нет служебного описания, которое требуется для регистрации, и программа откажется её добавлять. Да и давать её рядовым пользователям незачем. Открывайте консоль через Файл → Открыть.
Права, без которых консоль не откроется
Открыть внешнюю обработку из файла может только пользователь с правом «Интерактивное открытие внешних обработок». Это право задаётся в ролях конфигурации. Администратор с полными правами его имеет, рядовой бухгалтер — как правило, нет.
В типовых конфигурациях на БСП (БП 3.0, ЗУП 3.1, УТ 11)
Права здесь выдают не ролями напрямую, а через профили групп доступа.
- Откройте
Администрирование → Настройки пользователей и прав. - Перейдите в «Профили групп доступа».
- Найдите профиль, в который входит роль «Интерактивное открытие внешних отчетов и обработок». В профиле «Администратор» она есть.
- Если нужно выдать право не администратору, создайте копию подходящего профиля, отметьте в его ролях эту роль и включите пользователя в группу доступа с новым профилем.
- Пользователю нужно перезайти в базу, чтобы права применились.
Право открывать внешние обработки фактически даёт пользователю возможность выполнить любой код в базе. Выдавайте его только тем, кто отвечает за данные: программисту, администратору, главному бухгалтеру по согласованию.
В самописных и нетиповых конфигурациях
- Откройте Конфигуратор, ветку
Общие → Роли. - Откройте роль пользователя (или создайте отдельную роль) и встаньте на корень дерева — саму конфигурацию.
- В правах отметьте «Интерактивное открытие внешних обработок».
- Сохраните конфигурацию и обновите конфигурацию базы данных (
F7). - В списке пользователей (
Администрирование → Пользователи) добавьте эту роль нужному пользователю.
Окно «Предупреждение безопасности»
Начиная с платформы 8.3.9 при открытии внешней обработки появляется окно с предупреждением. Его вызывает флаг «Защита от опасных действий» в свойствах пользователя. Окно ничего не запрещает, оно лишь просит подтвердить, что вы доверяете файлу.
Если консоль открывает разработчик по десять раз в день, флаг можно снять для его учётной записи: в Конфигураторе Администрирование → Пользователи, карточка пользователя, флажок «Защита от опасных действий». Для остальных пользователей защиту лучше оставить.
Запуск консоли запросов через Конфигуратор и командную строку
Иногда нужен другой путь: нет нужного клиента, база на обычных формах или хочется открывать консоль одним ярлыком.
Запуск в толстом клиенте из Конфигуратора
Консоль на обычных формах не работает в тонком клиенте. Чтобы открыть её в базе с «Такси»:
- В Конфигураторе откройте
Сервис → Параметры, вкладка «Запуск 1С:Предприятия». - В основном режиме запуска выберите «Толстый клиент (обычное приложение)».
- Запустите Предприятие из Конфигуратора (
F5или кнопкой на панели). - Откройте обработку через
Файл → Открыть.
Тот же результат даёт параметр запуска /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С:Предприятие). В открывшемся Предприятии откройте тот же файл — отладчик остановится в нужном месте.
Встроить консоль через расширение
Когда внешние обработки в базе запрещены политикой, а консоль нужна постоянно, её добавляют в расширение конфигурации :
- В Конфигураторе
Конфигурация → Расширения конфигурациисоздайте расширение. - В его дереве на ветке «Обработки» вызовите контекстное меню и вставьте внешнюю обработку из файла.
- Добавьте в расширение роль с правами «Использование» и «Просмотр» на эту обработку и назначьте её пользователю.
- Обновите расширение в базе.
Обработка откроется через «Все функции» (Главное меню → Сервис → Параметры, флажок «Отображать команду “Все функции”») без права на внешние обработки.
Не открывается консоль: ошибки и решения
Если не помогло
- 🔄 Проверьте, что вы открываете тот файл. Иногда браузер сохраняет
.epfкак архив или переименовывает его. - 🧪 Откройте консоль в копии базы на своём компьютере. Если там работает, причина в правах или настройках рабочей базы, а не в обработке.
- 🛡 Посмотрите, не блокирует ли файл антивирус: некоторые помечают
.epfиз интернета как подозрительные и удаляют при скачивании. - 👤 Войдите под пользователем с полными правами. Если под ним всё открывается, дело точно в ролях.