Как добавить консоль запросов в 1С: 3 проверенных способа для разных режимов

Работа с консолью запросов в 1С — обязательный навык для разработчиков, аналитиков и опытных пользователей системы. Этот инструмент позволяет тестировать SQL-подобные запросы на языке 1С, отлаживать сложные выборки и проверять корректность работы с базой данных без написания полноценных обработок. Однако в стандартных конфигурациях (например, 1С:Бухгалтерия или 1С:Управление торговлей) консоль запросов часто отсутствует "из коробки".

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

Зачем нужна консоль запросов в 1С и кому она пригодится

Консоль запросов — это не просто "игрушка для программистов". Она решает конкретные задачи:

• 🔍 Отладка сложных отчётов. Перед тем как встраивать запрос в отчёт, можно протестировать его прямо в консоли, увидеть структуру результата и время выполнения.
• 📊 Анализ данных. Быстро получить выборку по нестандартным критериям (например, "показать клиентов, которые заказывали товар X, но не заказывали товар Y").
• 🛠️ Поиск ошибок. Если отчёт или обработка выдаёт некорректные данные, консоль помогает локализовать проблему — выполнить запрос пошагово и проверить промежуточные результаты.
• 📚 Обучение. Новичкам проще осваивать язык запросов 1С, когда есть возможность сразу видеть результат выполнения кода.

Кому точно пригодится этот инструмент:

• 👨‍💻 Разработчикам 1С — для отладки и оптимизации кода.
• 👩‍🔬 Аналитикам — для оперативного получения данных без ожидания доработок от программистов.
• 👨‍🏫 Преподавателям 1С — для демонстрации примеров на занятиях.
• 👨‍💼 Администраторам баз — для диагностики проблем производительности.

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

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

Способ 1: Добавление консоли через конфигуратор (для обычных форм)

Этот метод подходит для 1С:Предприятие 8.3 в режиме обычного приложения. Если вы работаете с управляемыми формами, переходите к второму способу.

Пошаговая инструкция:

1. Откройте конфигуратор в режиме 1С:Предприятие → Конфигуратор (с правами администратора).
2. Перейдите в дерево объектов конфигурации: Общие → Обработки.
3. Создайте новую обработку:
   • 📌 Название: КонсольЗапросов (или любое другое).
   • 📌 Установите флажок Открывать форму в обычном режиме.

Процедура Выполнить(Кнопка)
Запрос = Новый Запрос;
Запрос.Текст = ЭлементыФормы.ТекстЗапроса.Значение;
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

ТаблицаРезультата = ЭлементыФормы.ТаблицаРезультата;
ТаблицаРезультата.Очистить();

Пока Выборка.Следующий() Цикл
НоваяСтрока = ТаблицаРезультата.Добавить();
Для Каждого Поле Из Выборка.Поля Цикл
НоваяСтрока.Поля.Добавить(Поле.Имя);
НоваяСтрока.Значения.Добавить(Поле.Значение);
КонецЦикла;
КонецЦикла;
КонецПроцедуры

Имя обработки не содержит пробелов|Поле ввода имеет имя "ТекстЗапроса"|Табличное поле имеет имя "ТаблицаРезультата"|Кнопка имеет процедуру "Выполнить"|Права на выполнение запросов настроены-->

Если после выполнения запроса таблица остаётся пустой, проверьте:

• 🔹 Корректность синтаксиса запроса (например, отсутствие опечаток в именах таблиц).
• 🔹 Права текущего пользователя на чтение данных.
• 🔹 Наличие данных, соответствующих условиям запроса (иногда запрос syntactically верен, но не возвращает строк из-за жёстких фильтров).

Способ 2: Консоль запросов для управляемых форм

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

Инструкция для управляемых форм:

1. В конфигураторе перейдите в Общие → Обработки и создайте новую обработку с типом Управляемая форма.
2. На форме разместите:
   • 📝 Поле ввода (тип Строка, имя ТекстЗапроса).
   • 🖱️ Кнопка (Выполнить).
   • 📊 Табличный документ или Динамический список для вывода результата.
3. В модуле формы добавьте серверную процедуру:

   &НаСервере
   Процедура ВыполнитьНаСервере(ТекстЗапроса)
   Запрос = Новый Запрос;
   Запрос.Текст = ТекстЗапроса;
   Результат = Запрос.Выполнить();
   Возврат Результат;
   КонецПроцедуры
   
   &НаКлиенте
   Процедура Выполнить(Команда)
   Результат = ВыполнитьНаСервере(Элементы.ТекстЗапроса.Значение);
   Выборка = Результат.Выбрать();
   
   Таблица = Новый ТаблицаЗначений;
   Таблица.Колонки.Добавить("Поля");
   Таблица.Колонки.Добавить("Значения");
   
   Пока Выборка.Следующий() Цикл
   Для Каждого Поле Из Выборка.Поля Цикл
   Строка = Таблица.Добавить();
   Строка.Поля = Поле.Имя;
   Строка.Значения = Поле.Значение;
   КонецЦикла;
   КонецЦикла;
   
   Элементы.ТаблицаРезультата.Значение = Таблица;
   КонецПроцедуры

4. Сохраните обработку и опубликуйте её в списке доступных команд (через Администрирование → Печатные формы, отчёты и обработки).

Ключевые отличия от обычных форм:

Параметр	Обычная форма	Управляемая форма
Разделение кода	Весь код выполняется на клиенте	Код делится на клиентскую и серверную части (&НаКлиенте, &НаСервере)
Вывод результата	Табличное поле	Таблица значений или динамический список
Производительность	Может тормозить при больших выборках	Лучше оптимизирована для работы с сервером
Доступность	Только в толстом клиенте	Работает в тонком клиенте и веб-браузере

⚠️ Внимание: В управляемых формах нельзя напрямую модифицировать данные через консоль (например, выполнять Запрос.ВыполнитьСПаузами() для изменений). Для этого потребуется расширять функционал обработки или использовать внешние отчёты.

Способ 3: Готовые обработки от сообщества 1С

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

• 📥 "Консоль запросов" от Евгения Гилева — поддерживает подсветку синтаксиса, историю запросов и экспорт результатов в Excel. Ссылка на Инфостарт.
• 📥 "Универсальная консоль" от Алексея Гаврилова — включает не только запросы, но и выполнение произвольного кода на встроенном языке.
• 📥 "Query Console" для управляемых форм — оптимизирована для работы в тонком клиенте, имеет встроенный конструктор запросов.

1. Скачайте файл обработки (.epf или .erf) с проверенного источника (например, Инфостарт, 1С:ИТС).
2. В 1С перейдите в Файл → Открыть и выберите скачанный файл.
3. Если обработка требует дополнительных прав, запустите её от имени администратора.
4. Настройте интерфейс под свои нужды (например, включите автоподстановку или историю запросов).

Процедура ЗаписатьВЖурнал(ТекстЗапроса, Пользователь)
Лог = Новый ЖурналДокументов.ЛогЗапросов;
НовыйДокумент = Лог.СоздатьДокумент();
НовыйДокумент.Дата = ТекущаяДата();
НовыйДокумент.Пользователь = Пользователь;
НовыйДокумент.ТекстЗапроса = ТекстЗапроса;
НовыйДокумент.Записать();
КонецПроцедуры

ВЫБРАТЬ
Контрагент,
СУММА(СуммаДокумента) КАК Итого
ИЗ
Документ.РеализацияТоваровУслуг
ГРУППИРОВКА ПО
Контрагент

Процедура СохранитьЗапросВИсторию(ТекстЗапроса)
Запись = РегистрыСведений.ИсторияЗапросов.СоздатьМенеджерЗаписи();
Запись.ТекстЗапроса = ТекстЗапроса;
Запись.ДатаВыполнения = ТекущаяДата();
Запись.Записать();
КонецПроцедуры

Запрос = Новый Запрос;
Запрос.Текст =
"ОБНОВИТЬ Справочник.Номенклатура
УСТАНОВИТЬ ПометкаУдаления = Истина
ГДЕ НЕ ПометкаУдаления И Номенклатура.Артикул ПУСТОЙ";
Результат = Запрос.Выполнить();