Циклические отчеты
С помощью циклов можно создать несколько версий отчета с разбивкой по измерениям, например, по годам или регионам. Циклы добавляются при настройке задачи отчета.
Циклы работают путем фильтрации данных, включенных в каждую версию отчета. Разница между циклом и фильтром отчетов заключается в том, что при добавлении цикла одно выполнение задачи отчета может генерировать несколько уникальных отчетов для одного получателя. Когда в задачу отчета добавляется цикл, для каждого уникального значения в измерении, выбранном в качестве цикла, создается уникальный отчет. Если циклических полей несколько, то количество созданных отчетов будет соответствовать количеству комбинаций всех циклических полей.
Циклы взаимодействуют с другими типами фильтрации, которые могут быть применены во время создания отчета. Оценка происходит следующим образом.
-
Section Access, если есть
-
Фильтр отчетов на уровне задач, если есть
-
Фильтр отчетов на уровне получателя, если есть
-
Циклы, если есть
Пример
Например, имеется задача отчета для рассылки отчетов о продажах. Задача отчета настраивается со следующими параметрами:
-
Имя файла: SalesData
-
Цикл в полях Country (Страна) и Year (Год)
-
Формат метки времени: yyyy-MM-dd_HH-mm
Данные охватывают три страны и два года, поэтому будет создано и отправлено шесть отчетов:
-
SalesData_ Country1 _Year1 _2024-11-08_10-30.xlsx
-
SalesData_ Country1 _Year2 _2024-11-08_10-30.xlsx
-
SalesData_ Country2 _Year1 _2024-11-08_10-30.xlsx
-
SalesData_ Country2 _Year2 _11-08_10-30.xlsx
-
SalesData_ Country3 _Year1 _11-08_10-30.xlsx
-
SalesData_ Country3 _Year2 _11-08_10-30.xlsx
После создания выходные файлы отправляются получателям в обычном порядке. Фильтры отчета и фильтрация Section Access применяются в обычном порядке.
Добавление циклов в задачу отчета
Для получения дополнительной информации о создании задачи отчета см. раздел Создание задачи отчета.
Выполните следующие действия.
-
Создайте задачу отчета и начните процесс настройки в обычном порядке.
-
После настройки параметров в разделе Шаблон диалогового окна открывается раздел Выходные данные.
-
В раскрывающемся меню Цикл выберите максимум три измерения из приложения.
Имена выходных файлов
Когда добавляется цикл, имя значения измерения, примененного в цикле, включается в имена файлов отчетов. Если имя значения измерения, примененного в цикле, содержит специальные символы, они заменяются символом подчеркивания (_) в имени файла.
Специальные символы включают:
-
\ / < > : " ' ? *
-
Управляющие символы ASCII
Обработка ошибок
Если ошибка произошла для одного или нескольких отчетов в цикле, для каждого неудачного отчета создается пустой файл. Имя каждого из этих файлов имеет префикс FAILED_ и отражает комбинацию значений, которая привела к ошибке.
Рекомендации и ограничения
Оптимальные методы работы
Не следует запускать цикл отчета в задаче отчета, если измерения отчета содержат много значений или уникальных комбинаций значений. Например, если данные охватывают 10 лет, 196 стран и 50 продуктов, в ходе циклического создания отчетов потенциально может быть создано до 98 000 файлов (см. ограничение ниже для текущего уникального ограничивающего условия задачи). Это может занять несколько часов или дней и израсходовать большой объем лицензии на генерацию отчетов в подписке Qlik Cloud.
Ограничения
-
Можно выбрать не более трех полей для циклического выбора в задаче отчета.
-
При применении одного или нескольких циклов задача отчета может генерировать максимум 500 уникальных отчетов. Когда циклы не применены, задача отчета может генерировать максимум 100 уникальных отчетов.
-
Максимальное время выполнения задачи отчета с примененным циклом составляет четыре часа.
Для получения сведений о других ограничениях, которые распространяются на отчетность в приложении, см. раздел Пределы и ограничения для конфигурации отчетов в приложении.