> ## 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.

# 報表

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

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

## 可用性

報表功能僅在 知行之橋 企業版套餐中提供。有關 知行之橋 套餐和許可的資訊，請參閱 [價格與套餐頁面](https://www.kasoftware.com/purchase.html)。

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

## 建立與管理報表

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

### 建立報表

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

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

   ![Add report button](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/reports_create.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=9789a04c8e989c2f07e28da9d2f13173)

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

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

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

   * **Application Usage（應用使用情況）**：提供有關 知行之橋 許可使用情況的資料。

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

   > [!NOTE]
   >
   > **按 ISA Id 統計交易** 和 **按交易集統計交易** 預設報表依賴於標頭追蹤，只有在工作流程中相應的端口啟用了標頭追蹤時，才會產生結果。有關這些標頭的更多資訊，請參見 [X12](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/x12.md#進階設定) 和 [EDIFACT](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/edifact.md#進階設定)。

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

### 存取生成的報表

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

![Reports list](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/reports_list.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=7bcb997886a337265d25c3703030053b)

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

## 報表檢視

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

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

### 構建器頁面

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

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

> [!NOTE]
>
> 交易報表均包含在 知行之橋 中定義的任何[追蹤標頭](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/getting-started/administration/activity.md#跟蹤訊息頭)。它們會出現在可用列、分組依據和篩選器選項清單中，可以像任何其他專案一樣選擇它們。

#### 列

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

| 列 | 描述 | 交易報表 | 應用使用情況報表 |
| - | - | :-: | :-: |
| 工作區 | 工作區（如 *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]
>
> 如果設定了排程，仍可以隨時透過點選 **構建器** 頁面上的 **執行** 來手動執行報表。

#### 郵件傳送報表

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

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

電子郵件功能使用與 [通知](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/getting-started/administration/settings/settings-page.md#通知) 頁面中指定的相同電子郵件伺服器配置。

### 主報表檢視

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

![Main report view](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/reports_mainview.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=a60664736c652790cbc087e38a255dc9)

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

![Report grouped by column](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/reports_groupby.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=9b1431e39e265679842ce836518ace77)

在報表結果上方，可以透過點選報表名稱旁邊的編輯 ![tablet and pencil](https://mintcdn.com/qiao/cAp6sdkg0SyWJqZM/26.4/images/xmlmap_expressioneditor_icon.png?fit=max\&auto=format\&n=cAp6sdkg0SyWJqZM\&q=85\&s=5edbaa9aed1ae34dc4d8833361d3cf40) 圖示來重新命名報表。

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

### 執行、儲存與放棄

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

* 點選 **放棄更改** ![revert changes](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/reports_revert_icon.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=8c2f5ab00d465d8bf590677de14dffb1) 圖示將所有更改恢復到報表的上次儲存版本。
* 點選 **儲存** 以 **儲存更改** 到現有報表，或 **另存新檔新報表**。
* 點選 **執行** 以使用當前設定執行報表，並在主報表檢視區域顯示結果。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.