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