Как программно выгрузить результат отчета СКД в таблицу значений

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

Основные объекты и этапы работы с СКД

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

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

Проанализируем ситуацию: почему нельзя просто выполнить запрос? СКД удобна тем, что она автоматически обрабатывает иерархию, вычисляемые поля, пользовательские настройки и права доступа. Если мы хотим сохранить эту гибкость при программном вызове, использование стандартных процессоров вывода — единственный верный путь.

Программная реализация выгрузки в Таблицу Значений

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

// 1. Получаем схему из макета отчета
Схема = Отчеты.МойОтчет.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных");

// 2. Получаем текущие настройки (можно взять настройки по умолчанию или из компоновщика)
Настройки = Схема.НастройкиПоУмолчанию;

// 3. Создаем компоновщик макета
КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;

// 4. Формируем макет компоновки
// Передаем схему, настройки и данные расшифровки (если нужны)
МакетКомпоновки = КомпоновщикМакета.Выполнить(Схема, Настройки);

// 5. Инициализируем процессор компоновки
ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
ПроцессорКомпоновки.Инициализировать(МакетКомпоновки);

// 6. Подготавливаем таблицу значений для результата
РезультатТаблица = Новый ТаблицаЗначений;

// 7. Создаем процессор вывода в коллекцию и связываем его с таблицей
ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВКоллекциюЗначений;
ПроцессорВывода.УстановитьОбъект(РезультатТаблица);

// 8. Выполняем вывод
ПроцессорВывода.Вывести(ПроцессорКомпоновки);

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

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

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

Посмотрим на пример установки параметра:

// Установка значения параметра "Период"
ИмяПараметра = "Период";
ЗначениеПараметра = Новый СтандартныйПериод(НачалоМесяца(ТекущаяДата()), КонецМесяца(ТекущаяДата()));

ПараметрСКД = Настройки.ПараметрыДанных.Элементы.Найти(ИмяПараметра);
Если ПараметрСКД <> Неопределено Тогда
    ПараметрСКД.Значение = ЗначениеПараметра;
    ПараметрСКД.Использование = Истина;
КонецЕсли;

Если же требуется программно добавить отбор, мы работаем с коллекцией Настройки.Отбор.Элементы. Рассмотрим подробнее этот процесс:

// Добавление отбора по конкретной организации
НовыйОтбор = Настройки.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
НовыйОтбор.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Организация");
НовыйОтбор.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
НовыйОтбор.ПравоеЗначение = СсылкаНаОрганизацию;
НовыйОтбор.Использование = Истина;

Особенности использования внешних наборов данных

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

// Предположим, в схеме есть внешний набор данных с именем "ВнешниеДанные"
ВнешниеНаборыДанных = Новый Структура;
ВнешниеНаборыДанных.Вставить("ВнешниеДанные", МояИсходнаяТаблица);

// При инициализации процессора передаем эту структуру
ПроцессорКомпоновки.Инициализировать(МакетКомпоновки, ВнешниеНаборыДанных);

Типичные ошибки и рекомендации

При работе с программным выводом СКД в 1С 8.3 следует учитывать несколько важных моментов, чтобы избежать ошибок производительности и некорректного отображения данных:

• Типы данных в Таблице Значений: Если в СКД настроена иерархия, то при выводе в таблицу значений иерархическая структура будет «развернута» в плоский список. Если вам нужно сохранить древовидную структуру, используйте ПроцессорВыводаРезультатаКомпоновкиДанныхВКоллекциюЗначений с объектом ДеревоЗначений.
• Очистка ресурсов: Несмотря на то что сборщик мусора 1С работает эффективно, при очень больших объемах данных в циклах рекомендуется явно очищать временные таблицы, если они использовались в схеме.
• Проверка использования: Всегда проверяйте свойство Использование у параметров и элементов отбора. Если оно установлено в Ложь, настройка не будет применена, что может привести к получению избыточных данных.
• Поля группировок: Помните, что в таблицу значений попадут только те поля, которые выбраны в детальных записях или группировках текущих настроек.

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