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