Как в СКД передать таблицу значений 1С

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

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

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

Подготовка структуры данных в коде 1С

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

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

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

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

⚠️ Внимание: Никогда не передавайте в СКД таблицу значений с колонкой типа Произвольный или Неопределено, если планируете использовать эту колонку в вычислениях или отборах. Это приведет к ошибкам выполнения.

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

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

Переходим к самой схеме компоновки данных. Откройте макет отчета в конфигураторе и найдите вкладку «Параметры». Здесь необходимо создать новый параметр, который будет принимать нашу таблицу. Имя параметра должно быть уникальным и понятным, например, ВнешниеДанные или ТаблицаРезультатов.

Самый критичный момент — это выбор типа параметра. В списке доступных типов нужно найти и выбрать Таблица значений. Не перепутайте его с типом «Список значений» или «Массив». Только тип «Таблица значений» позволит СКД корректно интерпретировать переданную структуру как реляционную таблицу с колонками и строками.

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

Имя поля в СКД	Тип данных	Соответствие в коде 1С
Номенклатура	СправочникСсылка.Номенклатура	ТЗ.Колонки["Номенклатура"]
Количество	Число(15,3)	ТЗ.Колонки["Количество"]
Сумма	Число(19,2)	ТЗ.Колонки["Сумма"]
Комментарий	Строка(100)	ТЗ.Колонки["Комментарий"]

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

Подключение источника данных в макете

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

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

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

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

Ограничения источников-параметров

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

Передача данных из модуля объекта или формы

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

В обработчике команды сформируйте таблицу значений, как было описано в первом разделе. Затем найдите в коллекции параметров элемент с нужным именем и присвойте ему значение таблицы. Важно делать это до вызова метода СкомпоноватьРезультат().

Параметры = Отчет.ПараметрыКомпоновкиДанных;
Параметры.Установить("ВнешниеДанные", ТЗ);

ДанныеОтчета = Отчет.СкомпоноватьРезультат(, Параметры);
Отчет.Результат = ДанныеОтчета;

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

• 🚀 Убедитесь, что имя параметра в коде совпадает с именем в схеме регистрозависимо.
• 📊 Передавайте таблицу значений по ссылке, не создавая лишних копий для экономии памяти.
• ⚙️ Очищайте таблицу значений перед заполнением, если используете один и тот же объект многократно.

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

Работа с вложенными таблицами и сложными типами

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

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

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

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

Также стоит упомянуть работу с типами ХранилищеЗначения. Иногда данные передаются в сериализованном виде. В этом случае тип параметра в СКД должен быть «Хранилище значения», а в коде вы должны использовать метод ЗаписатьВХранилищеЗначение. Однако для обычных задач это избыточно, и прямая передача ТаблицыЗначений предпочтительнее.

Типичные ошибки и методы их устранения

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

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

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

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

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

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

В таких случаях рассмотрите альтернативный вариант: запись данных во временную таблицу на сервере и передача в СКД имени этой временной таблицы через параметр типа «Таблица» (не значений, а ссылку). Это позволяет использовать оптимизацию СУБД при выборке.

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

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

Можно ли передать таблицу значений из внешней обработки?

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

Что делать, если СКД не видит колонки переданной таблицы?

Проверьте вкладку «Параметры» в макете компоновки. Убедитесь, что для параметра типа «Таблица значений» явно описана структура полей. Автоматическое определение структуры при передаче параметра не работает, её нужно задавать вручную в конфигураторе.

Поддерживает ли СКД передачу пустой таблицы значений?

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

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

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