> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 報表

> 如何在知行之橋中建立、計劃和管理資料趨勢報表。

export const siteNameShort = "知行之橋";

export const siteName = "知行之橋";

**報表** 頁面允許建立關於 {siteName} 中資料趨勢的報表。例如，可以生成關於檔案處理時間的報表，以檢視工作流程中哪些步驟完成時間最長；或者透過報表發現工作流程中哪些端口產生的錯誤最多。

## 可用性

報表功能僅在 {siteNameShort} 企業版套餐中提供。有關 {siteNameShort} 套餐和許可的資訊，請參閱 <a href="https://www.kasoftware.com/purchase.html" target="_blank">價格與套餐頁面</a>。

只有管理員使用者可以建立、執行和刪除報表。標準使用者和支援使用者可以檢視已執行報表的結果，但不能建立新報表或執行現有報表以生成新結果。有關使用者角色的更多資訊，請參見[使用者角色](./settings/user-roles)。

## 建立與管理報表

如果尚未建立過報表，**報表** 頁面將顯示歡迎資訊和 **新增報表** 按鈕。如果已建立至少一個報表，該頁面將列出所有報表。

### 建立報表

請按照以下步驟建立報表：

1. 點選 **新增報表**。

   <img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/reports_create.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=18a080b19ddfc73ae06cef5bc18c7944" alt="Add report button" width="450" data-path="public/images/reports_create.png" />

2. 輸入 **報表名稱**。

3. 選擇報表 **型別**。報表建立後，無法更改此值。

   * **Transactions（交易）**：提供有關端口的資料，包括端口 Id、ISA Id、交易以及已處理檔案的資訊。

   * **Application Usage（應用使用情況）**：提供有關 {siteNameShort} 許可使用情況的資料。

4. 從 **預設** 清單中選擇一個選項作為報表範本。範本為構建報表提供了功能基礎，可以根據需要修改報表內容。

   <Note>**按 ISA Id 統計交易** 和 **按交易集統計交易** 預設報表依賴於標頭追蹤，只有在工作流程中相應的端口啟用了標頭追蹤時，才會產生結果。有關這些標頭的更多資訊，請參見 [X12](../../connectors/x12#advanced-settings) 和 [EDIFACT](../../connectors/edifact#advanced-settings)。</Note>

5. 點選 **新增報表** 以開啟[報表檢視](#報表檢視)，在此處可以構建並執行報表。

### 存取生成的報表

如果已建立至少一個報表，**報表** 頁面將顯示一個可搜尋、可排序的所有報表清單。

<img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/reports_list.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=c5f5a028c7d129872930ce0f7aa39f96" alt="Reports list" width="800" data-path="public/images/reports_list.png" />

* 點選清單中的報表以開啟該報表的[報表檢視](#報表檢視)。在此處可以修改並執行報表。
* 要刪除報表，請勾選每個報表旁邊的核取方塊，點選 **移除**，然後確認是否刪除所選報表。要刪除單個報表，請點選省略號並選擇 **移除**。

## 報表檢視

開啟報表時，報表檢視由兩個部分組成：

* 左側的[主報表檢視](#主報表檢視)顯示最近一次報表執行的結果，幷包含 **匯出** 按鈕。
* 右側的設定面板包含 [構建器](#構建器頁面) 和 [排程器](#排程器頁面) 頁面。透過這些頁面可以構建、執行和排程報表。

### 構建器頁面

**構建器** 頁面允許設定報表參數並執行。參數包括：

| 類別   | 描述                                                                              |
| ---- | ------------------------------------------------------------------------------- |
| 時間段  | 報表覆蓋的時間範圍。選擇 **自定義日期範圍** 會增加報表開始日期和結束日期的兩個欄位。預設為 *全部時間*。                        |
| 列    | 報表生成的資訊。可以根據需要包含任意數量的列。可用選項清單請參見[列](#列)。                                        |
| 分組依據 | 在報表中對結果進行分組時使用的欄位。每個選定的選項在報表中都有自己的列。可用選項清單請參見[分組依據](#分組依據)。                     |
| 篩選器  | 縮小報表結果範圍的選項。可用選項清單請參見[篩選器](#篩選器)。                                               |
| 資料摘要 | 彙總每列數值的選項。啟用至少一個選項會為每個報表部分建立 **小計** 行，並在報表底部建立 **總計** 行。可用選項清單請參見[資料摘要](#資料摘要)。 |

<Note>交易報表均包含在 {siteNameShort} 中定義的任何[追蹤標頭](./activity#tracked-headers)。它們會出現在可用列、分組依據和篩選器選項清單中，可以像任何其他專案一樣選擇它們。</Note>

#### 列

**列** 有以下選項可用：

| 列          | 描述                         | 交易報表 | 應用使用情況報表 |
| ---------- | -------------------------- | :--: | :------: |
| 工作區        | 工作區（如 *Default*）           |   ✓  |     ✓    |
| 端口類別       | 類別（如 *Core*、*EDI* 或 *MFT*） |      |     ✓    |
| 端口 Id      | 端口 Id（如 *XMLMap1*）         |   ✓  |     ✓    |
| 端口型別       | 型別（如 *XML Map*）            |   ✓  |     ✓    |
| 年份         | 交易年份                       |   ✓  |          |
| 季度         | 交易季度                       |   ✓  |          |
| 月份         | 交易月份                       |   ✓  |          |
| 周          | 交易周                        |   ✓  |          |
| 傳送方 ISA Id | EDI 文件傳送方的 ISA Id          |   ✓  |          |
| 接收方 ISA Id | EDI 文件接收方的 ISA Id          |   ✓  |          |
| 交易集        | 傳輸文件型別的標準識別程式碼             |   ✓  |          |
| 所有交易       | 傳送和接收的交易總數                 |   ✓  |          |
| 已傳送交易      | 已傳送的交易數量                   |   ✓  |          |
| 已接收交易      | 已接收的交易數量                   |   ✓  |          |
| 總處理時間      | 所有交易的處理時間（以毫秒為單位）          |   ✓  |          |
| 總檔案大小      | 所有傳送和接收檔案的大小               |   ✓  |          |
| 成功         | 成功交易的數量                    |   ✓  |          |
| 錯誤         | 交易錯誤數量                     |   ✓  |          |
| 警告         | 交易警告數量                     |   ✓  |          |

#### 分組依據

**分組依據** 有以下選項可用：

| 分組依據       | 交易報表 | 應用使用情況報表 |
| ---------- | :--: | :------: |
| 工作區        |   ✓  |     ✓    |
| 端口類別       |      |     ✓    |
| 端口 Id      |   ✓  |          |
| 端口型別       |   ✓  |     ✓    |
| 年份         |   ✓  |          |
| 季度         |   ✓  |          |
| 月份         |   ✓  |          |
| 周          |   ✓  |          |
| 傳送方 ISA Id |   ✓  |          |
| 接收方 ISA Id |   ✓  |          |
| 交易集        |   ✓  |          |

#### 篩選器

**篩選器** 有以下選項可用：

| 篩選器        | 交易報表 | 應用使用情況報表 |
| ---------- | :--: | :------: |
| 工作區        |   ✓  |     ✓    |
| 端口類別       |      |     ✓    |
| 端口 Id      |   ✓  |     ✓    |
| 端口型別       |   ✓  |     ✓    |
| 狀態         |   ✓  |          |
| 傳送方 ISA Id |   ✓  |          |
| 接收方 ISA Id |   ✓  |          |
| 交易集        |   ✓  |          |

#### 資料摘要

**資料摘要** 有以下選項可用：

| 摘要  | 交易報表 | 應用使用情況報表 |
| --- | :--: | :------: |
| 總計  |   ✓  |     ✓    |
| 平均值 |   ✓  |          |
| 最小值 |   ✓  |          |
| 最大值 |   ✓  |          |

### 排程器頁面

**排程器** 頁面允許為執行當前報表設定自動排程。如果希望定期檢視報表，而無需登入應用程式取得資料，此功能非常有用。

預設情況下，**頻率** 設定為 *無*，這意味著除非手動執行，否則報表不會執行。要設定報表自動執行，請將 **頻率** 設定為 *每月*、*每週* 或 *每日*，並根據需要進行配置。配置排程後，點選 **排程器** 頁面底部的 **儲存** 或 **應用** 以儲存更改。也可以點選 **放棄更改** 圖示將所有更改恢復為上次儲存的排程值。

<Note>如果設定了排程，仍可以隨時透過點選 **構建器** 頁面上的 **執行** 來手動執行報表。</Note>

#### 郵件傳送報表

如果配置了排程並選擇了 **郵件傳送報表**，應用程式會在排程執行時自動傳送包含報表結果的電子郵件。啟用此功能後，會出現兩個欄位：

* **主題**：指定自動化報表郵件的主題。
* **收件人**：接受以逗號分隔的報表收件人電子郵件地址清單。

電子郵件功能使用與 [通知](./settings/settings-page#alerts) 頁面中指定的相同電子郵件伺服器配置。

### 主報表檢視

主報表檢視顯示上次執行當前報表時生成的結果。可以按升序或降序對報表的每一列進行排序。

<img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/reports_mainview.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=0284227439f88f4f790d7a55d41b08e2" alt="Main report view" width="1100" data-path="public/images/reports_mainview.png" />

<Note>當在報表中設定了 [分組](#分組依據) 列時，報表結果會自動按照該列 **降序** 排序，如下圖所示。如果嘗試按表格中的其他列進行排序，將不會產生任何效果，因為分組的排序優先順序始終最高。</Note>

<img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/reports_groupby.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=5cba681e862b8357d6ec48b9c5c937bf" alt="Report grouped by column" width="500" data-path="public/images/reports_groupby.png" />

在報表結果上方，可以透過點選報表名稱旁邊的編輯 <img src="https://mintcdn.com/qiao/BoZrJ8_ctEN6h_9z/public/images/xmlmap_expressioneditor_icon.png?fit=max&auto=format&n=BoZrJ8_ctEN6h_9z&q=85&s=7ead9906fb7ee170d403e2536c8a545f" alt="tablet and pencil" noZoom style={{ display: "inline-block", verticalAlign: "middle", height: "0.9em", margin: 0 }} width="28" height="26" data-path="public/images/xmlmap_expressioneditor_icon.png" /> 圖示來重新命名報表。

* 點選 **匯出** 將最近的報表結果匯出為 CSV 檔案。
* 點選 **儲存** 儲存對當前報表的所有更改。

### 執行、儲存與放棄

在右側面板的底部，始終有三個選項：

* 點選 **放棄更改** <img src="https://mintcdn.com/qiao/3lMD3uYuGJqErRlJ/public/images/reports_revert_icon.png?fit=max&auto=format&n=3lMD3uYuGJqErRlJ&q=85&s=35f0a4f1b96a25ea0e831331ac3b963c" alt="revert changes" noZoom style={{ display: "inline-block", verticalAlign: "middle", height: "0.9em", margin: 0 }} width="24" height="24" data-path="public/images/reports_revert_icon.png" /> 圖示將所有更改恢復到報表的上次儲存版本。
* 點選 **儲存** 以 **儲存更改** 到現有報表，或 **另存新檔新報表**。
* 點選 **執行** 以使用當前設定執行報表，並在主報表檢視區域顯示結果。
