# 循環報告

透過循環，您可以產生按維度 (例如年份或區域) 細分的多個報告版本。會在設定報告任務時新增循環。

[Cycling reports - Qlik Cloud](https://play.vidyard.com/CJ2DnPdWruxccMLr7TZCZS)

循環的運作方式是篩選每個報告版本中包含的資料。循環和報告篩選條件之間的差異在於，透過新增循環，報告任務的單次執行可以為單一收件者產生多個唯一報告。將循環新增至報告任務時，將針對您選取作為循環的維度中的每個唯一值產生唯一報告。如果您有多個循環欄位，您將取得與所有循環欄位組合一樣多的報告。

循環會與可在報告產生期間套用的其他篩選類型互動。評估順序如下：

1. 區段存取 (如果存在)

2. 任務層級報告篩選 (如果存在)

3. 收件者層級報告篩選 (如果存在)

4. 循環 (如果存在)

## 範例

例如，您有一個傳送銷售報告的報告任務。報告任務透過下列設定進行設定：

* 檔案名稱： SalesData

* 國家和年份欄位上的循環

* 時間戳記格式：yyyy-MM-dd\_HH-mm

您的資料涵蓋三個國家和兩年，因此會產生並傳送六份報告：

* SalesData\_ 國家1 \_年份1 \_2024-11-08\_10-30.xlsx

* SalesData\_ 國家1 \_年份2 \_2024-11-08\_10-30.xlsx

* SalesData\_ 國家2 \_年份1 \_2024-11-08\_10-30.xlsx

* SalesData\_ 國家2 \_年份2 \_11-08\_10-30.xlsx

* SalesData\_ 國家3 \_年份1 \_11-08\_10-30.xlsx

* SalesData\_ Country3 \_Year2 \_11-08\_10-30.xlsx

建立後，輸出檔案將像平常一樣傳送到目的地。報告篩選和區段存取篩選仍然像平常一樣套用。

## 將循環新增至報告任務

如需更多關於建立報告任務的資訊，請參閱 [建立報告工作](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-tasks.htm#Creating)。

請執行下列動作：

1. 建立報告任務並像平常一樣開始設定流程。

2. 完成對話方塊的範本區段後，您將來到輸出。

3. 在循環之下，使用下拉式功能表從應用程式中選取最多三個維度。

## 輸出檔案名稱

新增循環時，循環中套用的維度值名稱將包含在報告檔案名稱中。如果循環中套用的維度值包含任何特殊字元，將替換為檔案名稱中的底線字元 (\_)。

特殊字元包括：

* \ / < > : " ' ? \*

* ASCII 控制字元

## 處理錯誤

如果循環中的一個或多個報告發生錯誤，則會為每個失敗的報告產生一個空的檔案。其中每個檔案的名稱都有一個「FAILED\_」前置詞，反映了以錯誤結尾之值的組合。

## 最佳做法和限制

### 最佳做法

如果您的報告維度包含許多值或唯一值組合，則不應啟動報告任務的報告循環。例如，如果您的資料涵蓋 10 年、196 個國家和 50 種產品，則報告循環可能會產生多達 98,000 個檔案 (請參閱[下面](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/reports-cycles.htm#Limitations)護欄以瞭解目前的獨特任務限制)。這可能需要數小時或數天的時間才能產生，並且可能會取用您 Qlik Cloud 訂閱的大量報告產生。

### 限制

* 您最多可以選取三個欄位以循環進行報告任務。

* 報告任務最多可以產生 500 個唯一報告。此限制是針對已新增至任務的所有範本進行評估，而非任務中的每個範本。此限制也適用於所有報告任務，無論是否套用了一個或多個週期。

* 

  如果已將週期套用至報告任務，則無法設定 HTML 報告範本以產生內嵌電子郵件訊息。

有關適用於應用程式內報告的其他限制，請參閱 [Qlik 報告服務 規格和限制](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm#Limits2)。