Как настроить расшифровку данных в СКД 1С

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

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

Основы механизма детализации в СКД

В основе механизма расшифровки лежит понятие запроса детализации. Это специальный запрос, который выполняется системой при двойном клике пользователя по ячейке отчета. СКД автоматически формирует этот запрос, подставляя значения выбранных строк или колонок в качестве отборов. Разработчику необходимо лишь указать, какие именно поля должны участвовать в этом процессе.

Важно различать два типа детализации: стандартную и пользовательскую. Стандартная расшифровка работает автоматически, если в макете отчета присутствуют измерения, не вошедшие в текущий уровень группировки. Например, если отчет сгруппирован по "Контрагентам", а в запросе есть поле "Договор", то при клике на контрагента система предложит показать список договоров.

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

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

Настройка полей расшифровки в конфигураторе

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

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

Существует несколько основных типов расшифровки, которые вы можете выбрать из выпадающего списка:

• 📊 Детальные записи — показывает список записей регистра или таблицы, из которых сформирована цифра.
• 📄 Документ — открывает форму конкретного документа, если поле содержит ссылку на тип документа.
• 📑 Отчет — запускает другой отчет 1С, передавая ему параметры отбора.
• 🔗 Внешняя обработка — вызывает стороннюю обработку или печатную форму.

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

Использование параметров в запросах детализации

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

В теле запроса детализации объявите параметры, имена которых должны совпадать с полями, передаваемыми из основного отчета. Например, если вы детализируете продажи по конкретному товару, в запросе детализации должен быть параметр &Товар. Значение этого параметра будет взято из ячейки, по которой кликнул пользователь.

ВЫБРАТЬ
РеализацияТоваровУслуг.Ссылка КАК Документ,
РеализацияТоваровУслуг.Дата КАК ДатаДокумента
ИЗ
Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
ГДЕ
РеализацияТоваровУслуг.Товар = &Товар

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

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

Переход к документам и формам списка

Одним из самых востребованных сценариев является быстрый переход от цифры в отчете к первичному документу. Для этого в поле расшифровки указывается ссылка на тип документа. 1С автоматически определит, что нужно открыть форму объекта.

Если в одной ячейке отчета могут содержаться документы разных видов (например, "Поступление товаров" и "Счет-фактура"), механизм расшифровки предложит пользователю выбор. Это поведение настраивается через свойство Множественный выбор. Если оно включено, при клике откроется список всех найденных документов.

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

⚠️ Внимание: При переходе к документам учитывайте права доступа пользователя. Если у пользователя нет прав на чтение конкретного документа, система может выдать ошибку или просто не показать запись в детализации. Проверьте РПП (Роли и Права Доступа).

Также можно настроить открытие конкретной формы объекта, отличной от основной. Например, для быстрого просмотра можно открыть форму "Только просмотр", запретив редактирование прямо из отчета. Это делается путем указания полного имени формы в свойствах перехода.

Сложные сценарии и вложенная детализация

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

Вы можете настроить несколько строк расшифровки для одного и того же поля, но с разными условиями видимости или приоритетами. Система будет выбирать подходящий сценарий в зависимости от контекста. Например, если группировка выполнена по периодам, сработает переход к более мелкому периоду.

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

Тип перехода	Объект назначения	Передача параметров	Пример использования
Детальные записи	Табличный документ / Запрос	Автоматически	Показ состава суммы
Документ	Ссылка на документ	Ссылка	Открытие накладной
Отчет	Объект метаданных Отчет	Набор параметров	Анализ продаж по товару
Внешняя обработка	Файл или объект	Произвольно	Печать этикеток

Использование процедур позволяет реализовать логику, недоступную стандартными средствами. Например, можно проверять дополнительные условия перед открытием формы или формировать динамический список доступных действий для пользователя.

Отладка и типовые ошибки настройки

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

Всегда проверяйте состав полей, доступных в момент клика. Если вы используете сложные вычисления в макете (например, сумму нескольких колонок), система может не знать, какое именно исходное поле подставить в отбор. В таких случаях явно указывайте источник данных для расшифровки.

Для отладки используйте режим предприятия с отладчиком. Установите точку останова в процедуре обработки расширения или в самом запросе детализации. Это позволит увидеть, какие именно значения параметров передаются системой в момент выполнения.

⚠️ Внимание: Интерфейс и возможности СКД могут незначительно меняться в разных версиях платформы 1С. Если вы не находите описанных настроек, сверьтесь со справкой по вашей конкретной версии платформы или проверьте обновления конфигурации.

Также стоит помнить о производительности. Запрос детализации не должен быть слишком тяжелым, так как он выполняется синхронно при клике пользователя. Оптимизируйте отборы и используйте индексы в базе данных для полей, по которым часто проводится детализация.

Секрет быстрой отладки

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

Почему при клике на ячейку ничего не происходит?

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

Как передать несколько параметров в отчет детализации?

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

Можно ли сделать расшифровку по вычисляемому полю?

Да, но с ограничениями. Вычисляемое поле должно быть включено в запрос детализации как источник. Если поле вычисляется только в макете (без участия запроса), расшифровка по нему невозможна, так как система не знает исходных данных для отбора.

Как запретить расшифровку для определенных строк отчета?

Используйте условное оформление или настройки видимости полей расшифровки. Можно настроить условие, при котором поле расшифровки становится неактивным, например, если значение ячейки равно нулю или принадлежит определенной группе.