Как передать таблицу значений во внешний набор данных СКД?

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

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

Шаг 1. Подготовка схемы компоновки данных (СКД)

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

1. Откройте конструктор схемы компоновки данных.
2. Вместо «Набора данных - запрос» добавьте «Набор данных - объект».
3. В поле «Имя объекта содержащего данные» впишите идентификатор, по которому мы будем обращаться к таблице из кода (например, ТЗ_Данные).
4. Вручную добавьте поля, которые будут присутствовать в вашей таблице значений. Важно: Имена полей в схеме должны строго совпадать с именами колонок в программно создаваемой ТЗ.
5. Настройте роли полей, типы данных и оформление, как в обычном отчете.

Шаг 2. Программная реализация передачи данных

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

Посмотрим на пример кода, который инициализирует процесс компоновки с использованием внешней таблицы значений:

Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
    
    // 1. Отключаем стандартный вывод отчета
    СтандартнаяОбработка = Ложь;
    
    // 2. Формируем таблицу значений (логика формирования может быть любой)
    МояТаблица = СформироватьВнешнююТаблицуДанных(); 
    
    // 3. Создаем структуру для передачи внешних наборов данных
    // Ключ структуры должен совпадать с "Именем объекта" в СКД
    ВнешниеНаборыДанных = Новый Структура;
    ВнешниеНаборыДанных.Вставить("ТЗ_Данные", МояТаблица);
    
    // 4. Инициализируем макет компоновки
    КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
    МакетКомпоновки = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных, КомпоновщикНастроек.ПолучитьНастройки(), ДанныеРасшифровки);
    
    // 5. Запускаем процессор компоновки
    ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
    
    // Обратите внимание на четвертый параметр "Истина" - он позволяет использовать 
    // функции общих модулей в выражениях СКД
    ПроцессорКомпоновки.Инициализировать(МакетКомпоновки, ВнешниеНаборыДанных, ДанныеРасшифровки, Истина);
    
    // 6. Выводим результат в табличный документ
    ДокументРезультат.Очистить();
    ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
    ПроцессорВывода.УстановитьДокумент(ДокументРезультат);
    ПроцессорВывода.Вывести(ПроцессорКомпоновки);
    
КонецПроцедуры

Шаг 3. Анализ критически важных нюансов

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

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

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

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

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

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

Типичные ошибки при работе с ТЗ в СКД

Рассмотрим, с какими сложностями сталкиваются разработчики чаще всего:

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

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