循環報告
透過循環，您可以產生按維度 (例如年份或區域) 細分的多個報告版本。會在設定報告任務時新增循環。
循環的運作方式是篩選每個報告版本中包含的資料。循環和報告篩選條件之間的差異在於，透過新增循環，報告任務的單次執行可以為單一收件者產生多個唯一報告。將循環新增至報告任務時，將針對您選取作為循環的維度中的每個唯一值產生唯一報告。如果您有多個循環欄位，您將取得與所有循環欄位組合一樣多的報告。
循環會與可在報告產生期間套用的其他篩選類型互動。評估順序如下：
-
區段存取 (如果存在)
-
任務層級報告篩選 (如果存在)
-
收件者層級報告篩選 (如果存在)
-
循環 (如果存在)
範例
例如，您有一個傳送銷售報告的報告任務。報告任務透過下列設定進行設定：
-
檔案名稱： SalesData
-
國家和年份欄位上的循環
-
時間戳記格式：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
建立後，輸出檔案將像平常一樣傳送到目的地。報告篩選和區段存取篩選仍然像平常一樣套用。
將循環新增至報告任務
如需更多關於建立報告任務的資訊，請參閱 建立報告任務。
請執行下列動作：
-
建立報告任務並像平常一樣開始設定流程。
-
完成對話方塊的範本區段後，您將來到輸出。
-
在循環之下，使用下拉式功能表從應用程式中選取最多三個維度。
輸出檔案名稱
新增循環時，循環中套用的維度值名稱將包含在報告檔案名稱中。如果循環中套用的維度值包含任何特殊字元，將替換為檔案名稱中的底線字元 (_)。
特殊字元包括：
-
\ / < > : " ' ? *
-
ASCII 控制字元
處理錯誤
如果循環中的一個或多個報告發生錯誤，則會為每個失敗的報告產生一個空的檔案。其中每個檔案的名稱都有一個「FAILED_」前置詞，反映了以錯誤結尾之值的組合。
最佳做法和限制
最佳做法
如果您的報告維度包含許多值或唯一值組合，則不應啟動報告任務的報告循環。例如，如果您的資料涵蓋 10 年、196 個國家和 50 種產品，則報告循環可能會產生多達 98,000 個檔案 (請參閱下面護欄以瞭解目前的獨特任務限制)。這可能需要數小時或數天的時間才能產生，並且可能會取用您 Qlik Cloud 訂閱的大量報告產生。
限制
-
您最多可以選取三個欄位以循環進行報告任務。
-
若套用一個或多個循環，報告任務最多可以產生 500 個唯一報告。若沒有套用任何循環，報告任務最多可以產生 100 個唯一報告。
-
套用循環的報告任務的執行時間上限為四小時。
有關適用於應用程式內報告的其他限制，請參閱 應用程式內報告設定的限制。