Использование системы компоновки данных (СКД) в модуле обработки 1С

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

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

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

Архитектурные особенности СКД внутри обработки

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

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

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

Создание макета и описание источников данных

Первым шагом является создание макета компоновки данных в конфигураторе. В дереве метаданных обработки создайте новый макет с типом МакетКомпоновкиДанных. Внутри редактора макета необходимо определить источники данных. Чаще всего используется тип"Запрос", но для сложных случаев можно подключить"Поля других наборов данных" или"Объект 1С".

В тексте запроса вы описываете логику выборки. Здесь можно использовать параметры, которые будут передаваться из модуля обработки. Для этого в тексте запроса параметры обозначаются знаком"&", например, &Период или &Организация. Система автоматически создаст соответствующие элементы в списке параметров макета.

• 📊 Определите поля вывода: выберите из доступных полей запроса только те, которые должны попасть в итоговый отчет, чтобы не перегружать структуру.
• 🔗 Настройте связи: если используется несколько источников данных, явно укажите поля соединения для корректной работы объединений.
• ⚙️ Задайте ресурсы: для полей, требующих агрегации (сумма, количество), укажите тип ресурса в свойствах поля макета.

После описания структуры перейдите на вкладку"Настройки". Здесь формируется первичный вид отчета. Вы можете задать группировки, порядок сортировки и условное оформление. Например, можно выделить цветом строки с отрицательным остатком товара. Эти настройки станут отправной точкой для пользователя.

Секрет оптимизации запросов

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

Программная инициализация в модуле обработки

Для работы с данными в коде обработки используется встроенный объект КомпоновщикНастроек. Его создание и инициализация обычно происходят в обработчике команды формы или в модуле формы перед выводом результата. Главный принцип — сначала загрузить настройки из макета, затем установить значения параметров.

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

Компоновщик = Новый КомпоновщикНастроекКомпоновкиДанных;
Компоновщик.УстановитьНастройки(Объект.Макеты.ОсновнойМакет);
Настройки = Компоновщик.Настройки;
Настройки.ЭтоНастройкиПоУмолчанию;

Критически важным этапом является заполнение параметров. Объект Параметры внутри компоновщика должен быть заполнен значениями, актуальными на момент формирования. Если параметр обязателен в запросе, но не передан в коде, система выдаст ошибку выполнения. Используйте метод Параметры.ЗаполнитьПараметры или присваивайте значения напрямую через индексацию.

Работа с параметрами и отборами

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

Если в макете определен параметр типа Строка, а вы пытаетесь передать Число, возникнет ошибка приведения типов. Для сложных типов, таких как СписокЗначений или Структура, необходимо создавать соответствующие объекты в коде перед присваиванием. Это особенно актуально при передаче списка конкретных документов для анализа.

Тип параметра в СКД	Особенности передачи в коде	Пример значения
Дата	Требуется точное совпадение типа, время учитывается	НачалоДня(ТекущаяДата)
СписокЗначений	Нужно создать объект и заполнить его	Новый СписокЗначений
ПолеКомпоновкиДанных	Используется для динамических полей сортировки	Новое ПолеКомпоновкиДанных("Сумма")
Булево	Строгое соответствие Истина/Ложь	Истина

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

Формирование и вывод результата на форму

После того как компоновщик настроен и параметры заполнены, наступает этап генерации результата. Метод СкомпоноватьРезультат выполняет запрос к базе данных, применяет настройки группировки и возвращает объект результата. Этот объект нельзя редактировать напрямую, он предназначен только для чтения и отображения.

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

⚠️ Внимание: Объект РезультатКомпоновкиДанных является тяжелым объектом. Не храните его в глобальных переменных длительное время и не передавайте между клиентом и сервером без необходимости, так как это может привести к существенному потреблению оперативной памяти.

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

Оптимизация производительности и отладка

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

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

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

ТекстЗапроса = Компоновщик.ПолучитьМакет.ОбластьЗапрос.Текст;
// Анализ текста запроса для отладки

⚠️ Внимание: Интерфейс и методы объекта КомпоновщикНастроек могут незначительно меняться в новых версиях платформы. Всегда проверяйте синтакс-помощник актуальной версии 1С:Предприятие, если переносите код со старых релизов.

Часто задаваемые вопросы (FAQ)

Как передать список значений в параметр СКД из обработки?

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

Почему СКД выдает ошибку"Неверный тип значения" при запуске?

Чаще всего это происходит из-за несоответствия типа передаваемой переменной типу параметра в макете. Проверьте, не передаете ли вы Неопределено вместо пустой строки или даты, и убедитесь, что типы справочников совпадают (виды ссылок).

Можно ли динамически менять текст запроса в макете СКД?

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

Как сохранить пользовательские настройки отчета в обработке?

Используйте объект ХранилищеНастройкиКомпоновкиДанных. Сохраняйте структуру настроек (Компоновщик.Настройки) в хранилище с уникальным именем после того, как пользователь внес изменения, и загружайте их при следующем запуске обработки.

В чем разница между отчетом и обработкой с использованием СКД?

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