Универсальный отчёт в 1С 8.3: где найти, как настроить на СКД и когда нужен свой .erf

Где найти Универсальный отчёт в типовых конфигурациях 1С 8.3

Расположение команды открытия зависит от редакции БСП и структуры разделов конкретной конфигурации. Если команда скрыта из интерфейса раздела, её можно добавить через «Настройку навигации» (шестерёнка в правом верхнем углу раздела) или открыть напрямую через Функции для технического специалиста (бывшее меню «Все функции»).

Для работы с отчётом пользователю необходима роль ИспользованиеУниверсальногоОтчета (или полные права) и право Просмотр на выбранную таблицу метаданных.

Выбор источника данных в шапке: тип объекта, имя и таблица

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

• Период — задаёт границы стандартного параметра &Период (СтандартныйПериод). Отображается и применяется для документов, журналов и периодических регистров.
• Тип объекта — вид метаданных: Справочник, Документ, ЖурналДокументов, ПланВидовХарактеристик, ПланСчетов, ПланВидовРасчета, БизнесПроцесс, Задача, РегистрСведений, РегистрНакопления, РегистрБухгалтерии, РегистрРасчета.
• Имя объекта — конкретный объект из дерева метаданных конфигурации (например, РеализацияТоваровУслуг или ТоварыНаСкладах).
• Имя таблицы — основная, подчинённая или виртуальная таблица выбранного объекта.

Настройка на СКД: расширенный режим и вкладки компоновки

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

• Отборы (Настройки.Отбор) — фильтрация выборки. Здесь же настраиваются Параметры данных (например, параметры виртуальной таблицы СрезПоследних или условие по субконто регистра бухгалтерии). Разыменование полей ссылочных измерений через точку (например, Номенклатура.ВидНоменклатуры) позволяет фильтровать по реквизитам связанных справочников.
• Поля и сортировки (Настройки.Выбор и Настройки.Порядок) — состав выводимых колонок и порядок строк. Для табличных частей документов реквизиты шапки достаются из поля Ссылка (Ссылка.Номер, Ссылка.Организация).
• Структура (Настройки.Структура) — дерево группировок отчёта. Поддерживаются обычная ГруппировкаКомпоновкиДанных, кросс-таблица (ТаблицаКомпоновкиДанных) и диаграмма. Чтобы увидеть отдельные строки документов или записей регистра, добавляется группировка <Детальные записи> (без поля группировки).
• Условное оформление (Настройки.УсловноеОформление) — подсветка отрицательных остатков, выделение шрифтом или установка формата чисел и дат.

Пользовательские поля в Универсальном отчёте

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

• Новое поле выражение... (ПользовательскоеПолеВыражениеКомпоновкиДанных) — содержит два поля: Выражение детальных записей и Выражение итоговых записей. В итоговом выражении обязательно используют агрегатные функции СКД (Сумма(...), Среднее(...), Количество(Различные ...)), иначе в строках группировок и в общем итоге ячейки останутся пустыми.
• Новое поле выбора... (ПользовательскоеПолеВыборКомпоновкиДанных) — визуальный конструктор условий, заменяющий конструкцию ВЫБОР КОГДА ... ТОГДА ... КОНЕЦ для категоризации строк по условиям отбора.

// Поле-выражение «Средняя цена реализации»:
// 1. Выражение детальных записей:
ВЫБОР
    КОГДА Количество = 0 ТОГДА 0
    ИНАЧЕ Сумма / Количество
КОНЕЦ

// 2. Выражение итоговых записей (обязательно с агрегатами СКД):
ВЫБОР
    КОГДА Сумма(Количество) = 0 ТОГДА 0
    ИНАЧЕ Сумма(Сумма) / Сумма(Количество)
КОНЕЦ

Как устроен Универсальный отчёт внутри: динамическая сборка СКД

В Конфигураторе макет ОсновнаяСхемаКомпоновкиДанных у Универсального отчёта практически пуст. Когда пользователь выбирает объект и таблицу в шапке, модуль отчёта на сервере программно конструирует СхемаКомпоновкиДанных по метаданным (Метаданные.Документы, Метаданные.РегистрыНакопления и т. д.).

Ключевой приём платформы 1С 8.3 при динамической генерации схемы — создание набора НаборДанныхЗапросСхемыКомпоновкиДанных со свойством АвтоЗаполнениеДоступныхПолей = Истина. При включённом автозаполнении платформа сама разбирает текст запроса, создаёт доступные поля, проставляет измерениям и счетам РольКомпоновкиДанных, а числовые показатели таблиц остатков и оборотов можно одним циклом зарегистрировать в Схема.ПоляИтога (тип элемента — ПолеИтогаСхемыКомпоновкиДанных).

&НаСервере
Функция СобратьУниверсальнуюСхемуПоТаблице(ИмяТаблицыЗапроса, МассивРесурсов)
    Схема = Новый СхемаКомпоновкиДанных;

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

    Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
    Набор.Имя = "НаборДанных1";
    Набор.ИсточникДанных = "ИсточникДанных1";
    Набор.АвтоЗаполнениеДоступныхПолей = Истина;
    Набор.Запрос = "ВЫБРАТЬ * ИЗ " + ИмяТаблицыЗапроса;

    Для Каждого ИмяПоля Из МассивРесурсов Цикл
        Ресурс = Схема.ПоляИтога.Добавить();
        Ресурс.ПутьКДанным = ИмяПоля;
        Ресурс.Выражение = "Сумма(" + ИмяПоля + ")";
    КонецЦикла;

    Возврат Схема;
КонецФункции

После того как динамическая схема собрана, её загружают в КомпоновщикНастроекКомпоновкиДанных методом Инициализировать(Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема)) и формируют настройки по умолчанию (группировка детальных записей ГруппировкаКомпоновкиДанных и автополе АвтоВыбранноеПолеКомпоновкиДанных):

&НаСервере
Процедура ПрименитьДинамическуюСхемуКОтчету(КомпоновщикНастроек, Схема)
    ИсточникНастроек = Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема);
    КомпоновщикНастроек.Инициализировать(ИсточникНастроек);
    КомпоновщикНастроек.ЗагрузитьНастройки(Схема.НастройкиПоУмолчанию);

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

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

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

Ограничения Универсального отчёта и когда нужен свой отчёт .erf

Универсальный отчёт проектировался как диагностический инструмент по одной выбранной таблице метаданных. Как только бизнес-задача выходит за рамки одного объекта, настройка в пользовательском режиме упирается в архитектурные ограничения:

Частые ошибки при работе с Универсальным отчётом

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

Частые вопросы по Универсальному отчёту в 1С 8.3