Набор данных — Объект в СКД 1С: таблица значений как источник

1. Когда в СКД нужен «Набор данных — объект»

В 90% задач отчёты на системе компоновки данных строятся на НаборДанныхЗапросСхемыКомпоновкиДанных, когда все данные выбираются языком запросов из текущей информационной базы. Однако есть целый класс задач, где данные невозможно или нерационально получить одним запросом 1С:

• Внешние источники: загрузка прайс-листов и актов сверки из файлов XLSX/CSV, получение остатков или курсов из REST API / HTTP-сервисов, чтение данных через COM или ADO из сторонней СУБД.
• Сложные алгоритмы расчёта на встроенном языке: рекурсивный обход дерева спецификаций, пошаговое распределение партий по FIFO с нетиповой логикой, парсинг строк JSON/XML или вызов функций БСП, возвращающих готовую ТаблицаЗначений.
• Дообогащение данных базы: соединение выгруженной из файла таблицы с реальными справочниками и регистрами 1С в одном отчёте с пользовательскими группировками, отборами и расшифровкой.

Вместо того чтобы вручную рисовать макет табличного документа и программировать итоги в цикле, достаточно подать подготовленную ТаблицаЗначений в НаборДанныхОбъектСхемыКомпоновкиДанных — и пользователь получит все возможности стандартного отчёта СКД: отборы, сортировки, условное оформление, кросс-таблицы и диаграммы.

2. Настройка в конструкторе СКД: ИмяОбъекта и обязательный ТипЗначения

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

1. Имя набора данных (свойство Имя) — внутреннее имя набора внутри схемы (по умолчанию НаборДанных1), используется при настройке связей наборов данных.
2. Имя объекта, содержащего данные (свойство ИмяОбъекта) — строковый идентификатор ключа в структуре ВнешниеНаборыДанных, по которому процессор компоновки найдёт вашу таблицу значений при исполнении (например, ТаблицаДанных). Рекомендуется давать осмысленное имя без пробелов.
3. Таблица полей — добавьте каждую колонку будущей ТаблицаЗначений. Поле Путь к данным и Поле должны строго совпадать с программным именем колонки в ТаблицаЗначений.Колонки.
4. Тип значения (свойство ТипЗначения) — обязательная колонка для каждого поля. Укажите точный тип (СправочникСсылка.Номенклатура, Число(15, 2), Строка(100), Дата).

Почему нельзя оставлять колонку Тип значения пустой в конструкторе? Для набора-объекта у компоновщика макета нет метаданных запроса при формировании макета компоновки:

• без указания числового типа ОписаниеТипов("Число", ...) агрегатные функции ресурсов Сумма(...) и Среднее(...) не сработают либо выдадут пустые итоги;
• без ссылочного типа в пользовательских отборах нельзя будет выбрать элемент из справочника и обращаться к реквизитам через точку (например, Номенклатура.Артикул или Контрагент.ИНН);
• при типизации самой ТаблицаЗначений в коде также обязательно задавайте ОписаниеТипов при вызове ТЗ.Колонки.Добавить(...) — нетипизированная колонка в ряде режимов приводит к пустым строкам при выводе.

// Поля в конструкторе НаборДанныхОбъект (ИмяОбъекта = "ТаблицаДанных"):
// 1. Поле: Склад        | ТипЗначения: СправочникСсылка.Склады
// 2. Поле: Номенклатура | ТипЗначения: СправочникСсылка.Номенклатура
// 3. Поле: Количество   | ТипЗначения: Число(15, 3)
// 4. Поле: СуммаПродаж  | ТипЗначения: Число(15, 2)

// Ресурсы на вкладке "Ресурсы":
// Поле: Количество  | Выражение: Сумма(Количество)
// Поле: СуммаПродаж | Выражение: Сумма(СуммаПродаж)

3. Передача ТаблицаЗначений в ПриКомпоновкеРезультата

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

Поэтому в модуле объекта отчёта необходимо определить обработчик события ПриКомпоновкеРезультата, отключить стандартную обработку (СтандартнаяОбработка = Ложь) и самостоятельно выполнить конвейер компоновки, передав структуру ВнешниеНаборыДанных во второй параметр метода ПроцессорКомпоновкиДанных.Инициализировать(...).

Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)

    СтандартнаяОбработка = Ложь;

    // 1. Получаем актуальные настройки с учётом выбора пользователя на форме
    Настройки = КомпоновщикНастроек.ПолучитьНастройки();

    // 2. Собираем типизированную ТаблицуЗначений (из расчёта, файла или API)
    ТаблицаДанных = ПодготовитьТаблицуДанных(Настройки);

    // Ключ структуры строго совпадает со свойством ИмяОбъекта в схеме СКД!
    ВнешниеНаборыДанных = Новый Структура;
    ВнешниеНаборыДанных.Вставить("ТаблицаДанных", ТаблицаДанных);

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

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

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

КонецПроцедуры

Функция ПодготовитьТаблицуДанных(Настройки)

    ТЗ = Новый ТаблицаЗначений;
    ТЗ.Колонки.Добавить("Склад", Новый ОписаниеТипов("СправочникСсылка.Склады"));
    ТЗ.Колонки.Добавить("Номенклатура", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
    ТЗ.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 3)));
    ТЗ.Колонки.Добавить("СуммаПродаж", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 2)));

    // Заполнение строк ТЗ по данным расчёта или внешнего файла...
    Возврат ТЗ;

КонецФункции

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

4. Полностью программная сборка НаборДанныхОбъектСхемыКомпоновкиДанных

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

&НаСервере
Процедура СформироватьОтчетПоПроизвольнойТЗ(ТаблицаДанных, ДокументРезультат)

    Схема = Новый СхемаКомпоновкиДанных;

    // 1. Источник данных схемы
    Источник = Схема.ИсточникиДанных.Добавить();
    Источник.Имя = "ЛокальнаяБаза";
    Источник.ТипИсточникаДанных = "Local";

    // 2. Создаём НаборДанныхОбъектСхемыКомпоновкиДанных
    НаборОбъект = Схема.НаборыДанных.Добавить(Тип("НаборДанныхОбъектСхемыКомпоновкиДанных"));
    НаборОбъект.Имя = "НаборТаблица";
    НаборОбъект.ИсточникДанных = "ЛокальнаяБаза";
    НаборОбъект.ИмяОбъекта = "ТаблицаДанных";

    // 3. Автоматически переносим колонки и их типы из ТаблицаЗначений в поля набора
    Для Каждого КолонкаТЗ Из ТаблицаДанных.Колонки Цикл
        ПолеНабора = НаборОбъект.Поля.Добавить(Тип("ПолеНабораДанныхСхемыКомпоновкиДанных"));
        ПолеНабора.Поле = КолонкаТЗ.Имя;
        ПолеНабора.ПутьКДанным = КолонкаТЗ.Имя;
        ПолеНабора.Заголовок = ?(ЗначениеЗаполнено(КолонкаТЗ.Заголовок), КолонкаТЗ.Заголовок, КолонкаТЗ.Имя);
        ПолеНабора.ТипЗначения = КолонкаТЗ.ТипЗначения;

        // Числовые колонки автоматически регистрируем как суммовые ресурсы
        Если КолонкаТЗ.ТипЗначения.СодержитТип(Тип("Число")) Тогда
            ПолеИтога = Схема.ПоляИтога.Добавить();
            ПолеИтога.ПутьКДанным = КолонкаТЗ.Имя;
            ПолеИтога.Выражение = "Сумма(" + КолонкаТЗ.Имя + ")";
        КонецЕсли;
    КонецЦикла;

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

    Группировка = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
    Группировка.Использование = Истина;

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

    АвтоПоле = Группировка.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
    АвтоПоле.Использование = Истина;

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

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

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

КонецПроцедуры

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

5. Связь НаборДанныхОбъект с НаборДанныхЗапрос в одной схеме

Одно из главных преимуществ СКД — возможность соединить внешнюю ТаблицаЗначений с данными информационной базы без записи временных объектов в БД. В одной схеме вы создаёте два набора данных:

• НаборОбъект (тип НаборДанныхОбъектСхемыКомпоновкиДанных, например ИмяОбъекта = "ПланИзExcel") — содержит поля Номенклатура и ПланПродаж, прочитанные из файла.
• НаборЗапрос (тип НаборДанныхЗапросСхемыКомпоновкиДанных) — выбирает из регистра накопления Продажи.Обороты фактические продажи за период по полю Номенклатура.

На вкладке Связи наборов данных (коллекция Схема.СвязиНаборовДанных) добавляется связь: Источник связи — НаборОбъект, Приёмник связи — НаборЗапрос, Выражение источника и Выражение приёмника — Номенклатура. Процессор компоновки выполнит левое соединение в памяти.

Чтобы запрос не выбирал обороты по всей базе, а фильтровал только позиции из вашей таблицы значений, используйте в запросе условие ГДЕ ПродажиОбороты.Номенклатура В (&СписокНоменклатуры) и укажите в связи Параметр связи (свойство Параметр) = СписокНоменклатуры с включённым флагом Параметры связи (свойство РазрешенСписокПараметров = Истина). Платформа сама соберёт массив значений Номенклатура из НаборОбъект и подставит его в параметр запроса.

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

6. Набор данных — объект или временная таблица в запросе: что выбрать

Передать ТаблицаЗначений в отчёт можно двумя путями: как НаборДанныхОбъект в процессор компоновки либо как параметр в НаборДанныхЗапрос с помещением во временную таблицу (ВЫБРАТЬ * ПОМЕСТИТЬ ВТ_Данные ИЗ &ВнешняяТЗ КАК Данные). Выбор зависит от архитектуры отчёта:

Частые ошибки при работе с набором данных — объект

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

Частые вопросы по набору данных — объект в СКД