Отчет на базе шаблона Excel

Отчет на основе Excel - мощный инструмент для создания различных типов отчетов.

Основная идея этого отчета заключается в следующем:

Используя выражения источника данных, необходимые данные извлекаются из регистров и каталогов, и выполняется первичная обработка этих данных: группировка, сортировка, вычисления и т. д.
Затем данные, полученные на первом этапе, переносятся в шаблон отчета на основе файла Excel. Инструменты Excel выполняют дополнительные вычисления и обработку данных.
Результат отображается для просмотра в виде HTML-страницы прямо в сервисе Hubcloud. Также можно напрямую загрузить полученный файл Excel.

Создать шаблон отчета

Выберите Меню> Конструктор> Отчеты. Подменю «Конструкторы» доступно только при наличии прав «Дизайнер».

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

Чтобы создать новый шаблон отчета, нажмите кнопку «Добавить» и выберите вариант на основе Excel.

Во всплывающей форме нового отчета необходимо ввести заголовок шаблона нового отчета, имя будет сгенерировано автоматически. При необходимости Имя можно изменить вручную. Максимальная длина имени составляет 20 символов. Имя не должно содержать пробелов, специальных символов, кроме символа подчеркивания «_», и должно начинаться с буквы. Имя вводится строчными буквами (строчными символами).

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

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

Настройки в шаблоне отчета сгруппированы по следующим вкладкам:

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

Источники данных отчета

Щелкните вкладку Источники данных, чтобы изменить выражения источника данных.

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

Рисунок 1. Настройки источника данных отчета.

У каждого источника должно быть уникальное имя. Результаты источников данных будут перенесены в файл Excel по именам источников данных.

Нажмите кнопку «X», чтобы удалить неиспользуемый источник данных.

Синтаксис источников данных описан в разделе «Функции Источников данных. Мы рекомендуем использовать консоль и конструктор источников данных для отладки источников данных.

Настройка динамических отчетов

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

по периоду
по дате
по справочнику
по числовому значению

Щелкните вкладку Параметры, чтобы настроить фильтры.

Если вам нужно отфильтровать данные отчета по периоду или дате, выберите режим фильтрации по периоду. Вы можете выбрать следующие варианты:

Не используется
Период - пользователь может выбрать разные периоды
Дата - пользователь может выбрать дату

Если вам нужно отфильтровать данные отчета по специальным параметрам, выберите «Настройки отборов». Нажмите кнопку «+», чтобы добавить новый фильтр.

У каждого фильтра есть следующие настройки:

Имя - введите имя переменной, используемой фильтром, в выражении источника данных.
Заголовок - введите название фильтра, отображаемого в отчете.
Тип - выберите тип поля, элементы которого будут использоваться для выбора в фильтре.
Пустые– проверяет, должно ли это значение фильтра быть пустым по умолчанию.
Мультивыбор - отбор по нескольким элементам
Обновить - обновляет содержимое отчета при изменении фильтра

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

Имена переменных фильтра по периоду предопределены системой, всегда используйте их:

&dateStart - Дата начала периода
&dateFinish - Дата окончания периода
&dateStartPreviousDayEnd — Конец дня, предшествующий дате начала периода
&dateFinishPreviousDayEnd — Конец дня, предшествующего периоду даты окончания

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

Пример:

Деньги | Period (&dateStart, &dateFinish) | СompanyAccount (&счет) | GroupBy (CompanyAccount, Сумма) | GetTitle ()

Фильтры по справочнику, полю дата или числовому полю используют имена переменных с начальным символом - &

Пример:

Деньги | Период (&dateStart, &dateFinish) | СompanyAccount (&счет) | GroupBy (CompanyAccount, Сумма) | GetTitle ()

Пример:

Деньги | Period (&dateStart, &dateFinish) | СompanyAccount (&счет) | GroupBy (CompanyAccount, Сумма) | GetTitle ()

Фильтры по полю дата или числовому полю используют функцию Having в источниках данных.

Пример:

Настройка шаблона файла Excel

Щелкните вкладку «Параметры», чтобы изменить параметры шаблона файла Excel.

Создать шаблон отчета в файле Excel.

Для просмотра в формате HTML отображается только первый лист шаблона Excel. Служебные данные и промежуточные расчеты следует выполнять на других листах шаблона Excel.

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

{{data_source_name}} - для источников данных, возвращающих значение. Например: Продажи | Period (ThisMonth) | Sum (сумма)
{{data_source_name.row_name}} - для источников данных, возвращающих таблицу. Например, Продажи | Период (ThisMonth) | GroupBy (продукт, количество, количество) | GetTitle (). См. Рисунок 2.

Если в отчете необходимо отображать заголовки элементов каталогов, следует использовать постфикс _title. Например, если у нас есть столбец продукта, вы должны использовать столбец product_title с заголовками.

Сохраните файл и загрузите его, нажмите Выбрать файл> нажмите кнопку Загрузить.

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

Другие настройки

На вкладке других настроек доступны следующие параметры:

Имя - введите или измените название отчета;
Заголовок - введите или измените заголовок отчета;
Движок Excel - выберите движок, который будет использоваться для создания макета HTML-отчета
Комментарий - вводить или редактировать комментарии для пользователей отчета;
Выполнить с полными правами - этот отчет доступен только пользователям с полными правами (см. Дополнительные права доступа пользователей);
Опубликован - этот отчет доступен на панели управления;
Название иконки - введите или измените название иконки отчета. Вы можете выбрать более 1 500 иконок из бесплатной библиотеки fontawesome.com. Используйте такие названия, как «выровнять по центру», «угол вниз» и так далее.
Icon name - введите имя иконки для отчета (см. список имен исконок) в формате - tasks
Icon color - введите или отредактируйте отчет Цвет значка. Используйте шестнадцатеричные цветовые коды, например (# E6E4E4), подробнее htmlcolorcodes.com

Для настройки некоторых типов отчетов используйте следующие ссылки: