К статье
Практический материал

Разработка и Конфигурация · 12 мин

Консоль в 1С: что это и зачем она нужна

Что такое консоль в 1С: консоль запросов, консоль кода, обработчики. Где скачать, как открыть, для чего нужна разработчику и администратору 1С.

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

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

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

Что именно называют консолью в 1С

Термин «консоль» в экосистеме 1С объединяет несколько близких инструментов. Все они работают по одному принципу: пользователь вводит текст (запрос или код), платформа выполняет его в контексте текущей информационной базы, а результат выводится на экран. Это отличает консоль от конфигуратора, где изменения сначала вносятся в метаданные, а потом обновляются в базе.

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

Основные виды консолей и их назначение

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

Консоль кода (иногда называется «консоль программиста») выполняет произвольный код на встроенном языке 1С. С её помощью можно обойти документы циклом, изменить реквизиты, вызвать процедуры общих модулей, удалить записи регистра. Это мощный и одновременно опасный инструмент: код выполняется без проверок бизнес-логики, если разработчик явно их не вызвал.

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

Сравнение вариантов

Консоль запросов

Для чтения и анализа данных, отладки запросов. Не меняет данные, безопасна для базы.

Консоль кода

Для разовых исправлений и массовых операций. Может изменять и удалять данные — требует бэкапа.

Консоль заданий

Для диагностики регламентных и фоновых заданий. Нужна администраторам серверных баз.

Где взять консоль и как её открыть

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

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

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

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

Как работать с консолью запросов

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

Полезные возможности, которые стоит освоить: работа с пакетными запросами и временными таблицами (можно посмотреть содержимое каждой временной таблицы отдельно), сохранение запросов в файл для повторного использования, перенос текста запроса в код встроенного языка одной командой. Последнее особенно удобно: отлаженный запрос сразу превращается в готовый фрагмент модуля с объявлением параметров.

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

bsl
ВЫБРАТЬ
	РеализацияТоваровУслуг.Номер,
	РеализацияТоваровУслуг.Дата,
	РеализацияТоваровУслуг.Контрагент
ИЗ
	Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
ГДЕ
	РеализацияТоваровУслуг.Дата МЕЖДУ &НачалоПериода И &КонецПериода

Консоль кода: возможности и риски

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

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

Безопасная практика: сначала выполнить код в режиме «только чтение» — вывести список объектов, которые попадут под изменение, и сверить их количество с ожиданием. Затем сделать выгрузку базы или резервную копию. Только после этого запускать модифицирующий вариант, желательно сначала на копии базы.

Типичные ошибки
01
Запуск изменяющего кода без предварительного просмотра списка затрагиваемых объектов — под изменение попадают лишние записи.
02
Отсутствие резервной копии перед массовой обработкой данных — восстановить информацию не из чего.
03
Использование консоли, скачанной из недоверенного источника — обработка может содержать вредоносный код с доступом ко всей базе.
04
Отладка запроса на полных данных без ограничения периода — запрос выполняется часами и блокирует работу пользователей.

Когда консоль действительно нужна, а когда нет

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

Консоль не подходит для регулярных операций. Если одно и то же действие через консоль выполняется еженедельно, это признак того, что задачу нужно оформить в конфигурации: отдельной обработкой с интерфейсом, регламентным заданием или доработкой документа. Постоянная работа «в обход» системы накапливает технические риски и делает базу зависимой от конкретного специалиста.

Маршрут решения

Как выбрать действие

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

Проверка результата и границы самостоятельной работы

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

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

Контрольные точки

Как проверить результат

Количество строк в результате запроса
Норма

Совпадает с ожиданием или с данными типового отчёта

Тревожный признак

Строк заметно больше или меньше — вероятно, ошибка в условиях или соединениях

Изменённые объекты после выполнения кода
Норма

Открываются в интерфейсе, реквизиты корректны, документы проводятся

Тревожный признак

Ошибки при открытии или проведении — изменения выполнены некорректно

Движения документов после обработки
Норма

Проводки и записи регистров соответствуют логике учёта

Тревожный признак

Движения отсутствуют или дублируются — код обошёл штатные механизмы

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

Консоль запросов входит в типовую конфигурацию 1С?

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

Можно ли испортить базу через консоль запросов?

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

Какие права нужны для работы с консолью?

Минимально — право на запуск внешних обработок и доступ к тем данным, которые нужно читать. Для консоли кода и работы со всеми объектами обычно требуются полные права. В клиент-серверном варианте дополнительно может понадобиться разрешение администратора кластера.

Чем консоль отличается от конфигуратора?

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

Безопасно ли скачивать консоль из интернета?

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

Что делать, если запрос в консоли выполняется слишком долго?

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

Итог

Что важно запомнить

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