Консоль запросов 1С: как установить и начать работу

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

Установка занимает несколько минут, если понимать, откуда брать обработку и какой способ подключения подходит под вашу задачу: разовый запуск через «Файл → Открыть», добавление в дополнительные обработки или встраивание в конфигурацию через конфигуратор. Каждый вариант имеет свои ограничения по правам доступа и режиму работы базы.

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

Что такое консоль запросов и какие версии существуют

Консоль запросов — это инструмент разработчика и аналитика: она показывает результат запроса, дерево запроса, временные таблицы, параметры и позволяет переносить текст запроса в код на встроенном языке. По сути, это аналог SQL-клиента, но для языка запросов 1С.

Существует несколько распространённых вариантов консоли. Первый — консоль с диска ИТС (информационно-технологического сопровождения), которая поставляется в составе инструментов разработчика. Второй — консоли с портала 1С и из состава библиотеки стандартных подсистем. Третий — многочисленные открытые разработки, которые публикуются на профильных ресурсах и отличаются расширенными возможностями: подсветкой синтаксиса, сохранением списка запросов, сравнением результатов.

Перед установкой важно понять, в каком режиме работает ваша база: обычное приложение (толстый клиент) или управляемое приложение (тонкий клиент, веб-клиент). Многие классические консоли написаны под обычные формы и не откроются в управляемом режиме. Для управляемого приложения нужна консоль, явно рассчитанная на управляемые формы.

Где взять файл консоли запросов

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

Альтернативный источник — портал portal.1c.ru, где в разделах для разработчиков доступны обработки для подписчиков. Там же можно найти версии, адаптированные под управляемые формы и тонкий клиент.

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

Способ 1. Разовое открытие через «Файл → Открыть»

Это самый быстрый способ, не требующий никакой настройки. Подходит для разового анализа данных, отладки запроса или проверки гипотезы перед написанием отчёта.

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

У этого способа есть ограничения. Во-первых, у пользователя должно быть право «Открытие внешних отчетов и обработок» — в ряде конфигураций оно отключено у рядовых пользователей. Во-вторых, в некоторых конфигурациях включен профиль безопасности или защита от опасных действий, и тогда обработку придётся открывать с отключением защиты, что требует повышенных прав.

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

Способ 2. Подключение через дополнительные отчеты и обработки

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

Сначала проверьте, что механизм включен: зайдите в раздел «Администрирование» → «Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки». После этого в разделе появится одноимённая команда.

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

Учтите нюанс: механизм дополнительных обработок требует, чтобы обработка содержала функцию СведенияОВнешнейОбработке() в модуле объекта. Консоли с ИТС и большинство популярных версий её содержат. Если при добавлении появляется ошибка «обработка не содержит сведений о внешней обработке» — используйте разовое открытие или доработайте модуль.

Способ 3. Встраивание в конфигурацию через конфигуратор

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

Для этого откройте конфигуратор, загрузите внешнюю обработку через «Файл → Открыть», затем сохраните её в конфигурацию: в дереве метаданных в ветке «Обработки» добавьте новый объект и загрузите в него форму и модуль из внешнего файла. Проще всего использовать функцию сравнения и объединения с файлом обработки либо скопировать объект через буфер обмена между двумя окнами конфигуратора.

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

Проверка работоспособности после установки

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

Самый простой тест — выполнить минимальный запрос к любому справочнику, например выбрать первые несколько элементов номенклатуры или контрагентов. Если запрос выполнился и в таблице результата появились строки — консоль работает. Если появилась ошибка компиляции текста запроса — проблема не в установке, а в синтаксисе конкретного запроса.

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

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

Типичные ошибки при установке и их решение

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

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

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

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

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

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

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

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