Как программно свернуть группировки в отчете на СКД до первого уровня?

← На главную

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

Разбираемся с нумерацией уровней

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

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


// Установка сворачивания до нулевого уровня (самый верхний)
Результат.ПоказатьУровеньГруппировокСтрок(0);

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

Проверяем контекст выполнения

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

Рекомендуем придерживаться следующего алгоритма при программном выводе:

Инициализируйте ПроцессорКомпоновкиДанных и ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент.
Выведите данные в табличный документ.
Примените метод ПоказатьУровеньГруппировокСтрок только после того, как документ был полностью сформирован и заполнен данными.

Альтернативный подход через настройки СКД

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

Рассмотрим шаги для настройки начального состояния:

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

Почему метод может не срабатывать?

Если после всех исправлений отчет всё еще развернут, проанализируйте следующие возможные причины:

Отсутствие группировок: Убедитесь, что в настройках вашего отчета действительно созданы иерархические структуры. Если отчет выводит плоский список данных, метод сворачивания уровней работать не будет, так как группировок попросту нет.
Перерисовка формы: Если код выполняется в модуле объекта, проверьте, не перерисовывает ли форма табличный документ принудительно после получения данных с сервера.
Очистка документа: Убедитесь, что вы не вызываете метод Очистить() у табличного документа после того, как применили сворачивание уровней.

Чтобы отладить ситуацию, выведите в журнал регистрации или отладчик количество строк в табличном документе после вывода:


ПроцессорВывода.Вывести(ПроцессорКомпоновки);
// Проверка наличия данных в документе
Сообщить("Количество строк: " + Результат.КоличествоСтрок());
Результат.ПоказатьУровеньГруппировокСтрок(0);

Если КоличествоСтрок() возвращает 0, значит, проблема кроется в самой компоновке макета, а не в визуальном сворачивании. Проанализируйте настройки макета и параметры, передаваемые в КомпоновщикМакетаКомпоновкиДанных.