Разработка и Конфигурация · 12 мин
Как добавить консоль запросов в 1С: пошаговая инструкция
Как добавить консоль запросов в 1С: где скачать обработку, как открыть её в режиме предприятия, подключить через дополнительные отчеты и обработки и проверить права.
Консоль запросов — это внешняя обработка, которая позволяет писать и выполнять запросы на встроенном языке 1С прямо в режиме «Предприятие», не изменяя конфигурацию. Она не входит в типовую поставку, поэтому её нужно скачать и подключить отдельно. Сделать это можно двумя способами: просто открыть файл обработки через меню «Файл» или встроить её в подсистему «Дополнительные отчеты и обработки», чтобы она была доступна всем пользователям из интерфейса.
Прежде чем начинать, определитесь с двумя вещами: какая у вас конфигурация (управляемое приложение с БСП или старая обычная форма) и есть ли у вас права на открытие внешних обработок. От этого зависит, какую версию консоли скачивать и каким способом её подключать. Ниже разобраны оба сценария с проверкой результата на каждом шаге.
Что такое консоль запросов и когда она нужна
Консоль запросов — инструмент разработчика и аналитика, который принимает текст запроса на языке запросов 1С, выполняет его против текущей информационной базы и показывает результат в виде таблицы. Большинство версий поддерживают параметры, временные таблицы, пакетные запросы и просмотр плана выполнения. По сути, это аналог SQL-клиента, но «заточенный» под объектную модель 1С.
Инструмент нужен в нескольких типовых ситуациях: проверить, какие данные реально лежат в регистре или справочнике; отладить запрос перед вставкой в отчет или обработку; быстро найти документы по нестандартному условию, которого нет в типовых отчетах; проанализировать проблему с данными без запуска конфигуратора. Во всех этих случаях консоль экономит время, потому что не требует ни изменения конфигурации, ни перезапуска сеанса.
Важно понимать: консоль запросов не поставляется фирмой «1С» в составе типовых конфигураций. Это сторонняя разработка, существующая во множестве вариантов — от простых до версий с редактором кода, подсветкой синтаксиса и конструктором. Поэтому первый шаг — выбрать и скачать подходящий файл.
Где взять файл консоли запросов
Файл консоли — это внешняя обработка с расширением .epf. Получить её можно из нескольких источников. Самый распространенный — сообщество разработчиков и профильные порталы, где выложены десятки версий под разные платформы. Часто консоль уже есть у коллег-разработчиков или входит в состав инструментов, которые использует ваша команда поддержки.
При выборе версии обращайте внимание на три вещи. Первое — режим интерфейса: для конфигураций на управляемых формах (Бухгалтерия 3.0, ERP, УТ 11, ЗУП 3.1) нужна консоль, написанная под управляемые формы. Второе — режим совместимости платформы: некоторые старые обработки не открываются на новых релизах. Третье — поддержка тонкого клиента и веб-клиента, если вы работаете не только через толстый клиент.
Если в компании есть отдел разработки, правильнее взять у них уже проверенную версию. Это снимает вопрос доверия к источнику и гарантирует, что обработка совместима с вашей платформой и конфигурацией.
Способ 1: открыть консоль через меню «Файл»
Это самый быстрый способ, подходящий для разового использования. Он не требует прав администратора и не меняет ничего в базе — обработка просто открывается как файл и живёт, пока открыто её окно.
- 1Запустите 1С в режиме «Предприятие» под пользователем с нужными правами
- 2Откройте меню «Файл» и выберите пункт «Открыть…» (в такси-интерфейсе: кнопка меню в левом верхнем углу → «Файл» → «Открыть»)
- 3Укажите путь к файлу консоли запросов с расширением .epf и подтвердите открытие
- 4Если появится предупреждение безопасности о внешней обработке, подтвердите открытие
- 5Дождитесь загрузки формы консоли и введите тестовый запрос для проверки
После открытия проверьте работоспособность простым запросом, например выборкой нескольких элементов из любого справочника. Если таблица результата появилась — подключение прошло успешно. Если форма не открылась или платформа выдала ошибку, причина обычно в несовместимости версии обработки с режимом запуска (управляемое/обычное приложение) или в запрете на открытие внешних файлов.
У этого способа есть ограничение: при следующем запуске программы консоль снова придется открывать вручную, а другие пользователи её не увидят. Для постоянной работы удобнее второй способ.
Способ 2: подключить через «Дополнительные отчеты и обработки»
Конфигурации на базе Библиотеки стандартных подсистем (БСП) — это большинство современных типовых решений — содержат встроенный механизм регистрации внешних обработок. После регистрации консоль появится в общем списке, и её смогут запускать все пользователи с соответствующими правами.
Сначала убедитесь, что механизм включен. Откройте раздел «Администрирование», найдите настройку «Печатные формы, отчеты и обработки» и проверьте, что установлен флаг «Дополнительные отчеты и обработки». Если флага нет, включите его — это безопасная настройка, не влияющая на данные.
- 1Перейдите в «Администрирование» → «Печатные формы, отчеты и обработки» и включите опцию «Дополнительные отчеты и обработки»
- 2Откройте появившуюся ссылку «Дополнительные отчеты и обработки»
- 3Нажмите «Создать» или «Добавить из файла» и выберите файл консоли запросов .epf
- 4Подтвердите предупреждение безопасности, если оно появится
- 5В карточке обработки проверьте размещение (разделы, где она будет видна) и при необходимости настройте быстрый доступ для пользователей
- 6Запишите карточку и найдите консоль в списке дополнительных обработок
После регистрации консоль запускается из списка дополнительных обработок одним нажатием. В карточке обработки можно ограничить доступ: назначить её только конкретным пользователям или ролям, что полезно, если выполнять произвольные запросы должны не все сотрудники.
Права доступа и режим запуска
Даже правильно подключенная консоль не откроется, если у пользователя нет соответствующих прав. Для способа «Файл → Открыть» нужно право «Открытие внешних отчетов и обработок». Для работы через дополнительные обработки — право на использование этой подсистемы и доступ к конкретной обработке, если он ограничен в её карточке.
Отдельный момент — безопасный режим. В файловых базах и при настройках по умолчанию внешние обработки часто запускаются в безопасном режиме, где запрещены некоторые операции. Для консоли запросов это обычно не проблема, так как чтение данных запросом разрешено. Но если консоль предлагает дополнительные функции (например, выгрузку в файл), они могут блокироваться.
Помните главное ограничение безопасности: консоль выполняет запросы с правами того пользователя, который её запустил. Если у пользователя нет доступа к регистру или документу, запрос к этим данным вернет ошибку или пустой результат. Это нормальное поведение, а не неисправность обработки.
Как выбрать действие
Проверка результата и первый запрос
После подключения стоит убедиться, что консоль работает корректно. Откройте её и выполните простейший запрос к любому справочнику с ограничением количества строк. Например:
ВЫБРАТЬ ПЕРВЫЕ 10
Номенклатура.Ссылка,
Номенклатура.Наименование
ИЗ
Справочник.Номенклатура КАК Номенклатура
Если в нижней части окна появилась таблица с данными — всё настроено верно. Пустой результат при заведомо заполненном справочнике может означать, что у вашего пользователя нет прав на чтение этого объекта, либо вы работаете не в той базе (проверьте строку подключения в окне запуска).
Как проверить результат
Окно с полем текста запроса и кнопкой выполнения отображается без ошибок
Ошибка о режиме совместимости, внешних обработках или пустое окно
Таблица результата заполняется данными за секунды
Сообщение об ошибке синтаксиса, прав доступа или зависание
Обработка видна в списке дополнительных обработок у нужных сотрудников
Обработка видна только администратору — не настроен быстрый доступ
Частые ошибки при подключении
Большинство проблем при добавлении консоли запросов сводится к нескольким типовым причинам. Их легко диагностировать по тексту сообщения платформы.
Если ни одна из перечисленных причин не подходит, проверьте версию платформы: очень старые обработки могут не работать на свежих релизах из-за изменений в языке и модели форм. В этом случае проще найти актуальную версию консоли, чем дорабатывать старую.
Ограничения и меры предосторожности
Консоль запросов — инструмент чтения данных, и при обычном использовании она не изменяет базу. Однако есть нюансы, о которых стоит знать перед работой на продуктивной базе. Тяжелый запрос без ограничений по большим таблицам (например, полная выборка из регистра накопления за все периоды) может надолго заблокировать сеанс и создать нагрузку на сервер. Всегда начинайте с конструкции ВЫБРАТЬ ПЕРВЫЕ и добавляйте условия.
Некоторые версии консолей содержат дополнительные функции — например, консоль кода, которая выполняет произвольный код на встроенном языке. Такой код уже может изменять данные. Выполняйте произвольный код только если понимаете, что он делает, и в идеале — сначала на копии базы. Для ответственных экспериментов всегда держите актуальную резервную копию.
Что важно запомнить
Консоль запросов — это внешняя обработка .epf, которую нужно скачать отдельно. Быстрый способ — открыть через «Файл → Открыть», постоянный — зарегистрировать в «Дополнительных отчетах и обработках». Проверьте соответствие версии режиму интерфейса, наличие прав на внешние обработки и доверие к источнику файла. Работоспособность подтверждается выполнением простого тестового запроса.
Частые вопросы
Можно ли добавить консоль запросов в базовую версию 1С?
Да, базовые версии поддерживают открытие внешних обработок через «Файл → Открыть». Ограничения базовых версий касаются изменения конфигурации и COM-соединений, но не запуска внешних .epf. Механизм дополнительных обработок БСП в базовых версиях тоже обычно доступен.
Консоль не открывается: «Нарушение прав доступа». Что делать?
У вашего пользователя нет права на открытие внешних отчетов и обработок. Попросите администратора добавить это право в вашу роль или запустить консоль под учетной записью с достаточными полномочиями. Самостоятельно обойти ограничение нельзя — это сделано намеренно для защиты базы.
Чем консоль запросов отличается от консоли кода?
Консоль запросов выполняет только запросы на языке запросов — она читает данные и показывает их таблицей. Консоль кода выполняет произвольный код на встроенном языке 1С, включая операции записи и удаления. Первая относительно безопасна, вторая требует осторожности и понимания последствий каждой строки.
Можно ли выполнять запросы, изменяющие данные?
Язык запросов 1С предназначен для чтения: в нем нет команд INSERT, UPDATE или DELETE в привычном понимании. Изменить данные через консоль запросов напрямую нельзя. Для изменений используют консоль кода или специальные обработки, но делать это на рабочей базе следует только с резервной копией.
Работает ли консоль запросов через веб-клиент?
Только если конкретная версия обработки написана с поддержкой веб-клиента — это указывается в её описании. Многие консоли рассчитаны на тонкий или толстый клиент. При работе через браузер выбирайте версию с явно заявленной совместимостью, иначе форма может не открыться или работать с ошибками.
Как обновить консоль, зарегистрированную в дополнительных обработках?
Откройте карточку обработки в справочнике «Дополнительные отчеты и обработки», используйте команду замены файла (обычно «Загрузить из файла») и выберите новую версию .epf. Настройки размещения и быстрого доступа при этом сохраняются, повторно настраивать их не нужно.