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