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

# Partner Mailbox 端口

> 知行之橋 Partner Mailbox 端口的設定和使用指南。

Partner Mailbox 端口為交易夥伴提供一個私人的、基於瀏覽器的信箱，用於自助檔案交換。交易夥伴登入後可下載為其暫存的檔案，也可上傳要傳送的檔案。

## 核心功能

* 每個交易夥伴一個信箱，每個信箱都有各自的憑證、URL 和資料夾樹
* 為不具備一般 MFT 能力的交易夥伴提供自助檔案交換
* 結構清楚的傳送和接收資料夾樹，支援拖放管理
* 針對已下載檔案的檔案保留控制，支援重新下載
* 副檔名篩選，用於控制交易夥伴可以上傳的檔案
* 可為面向交易夥伴的信箱頁面自訂頁面標題和 Logo 品牌
* 使用標準 `SubFolder` 訊息頭依資料夾路由，與其他 MFT 端口保持一致

## 概觀

每個 Partner Mailbox 端口代表一個交易夥伴的信箱。交易夥伴開啟專用網頁，使用使用者名稱和密碼進行身分驗證，然後即可下載為其暫存的檔案並上傳要傳送的檔案。多個交易夥伴需要多個端口執行個體。

[交易夥伴的信箱頁面](#交易夥伴信箱檢視)分為兩個部分：暫存供交易夥伴下載的檔案（傳送資料夾），以及交易夥伴可以上傳檔案的資料夾（接收資料夾）。每個部分都使用一棵獨立的資料夾樹，由管理員在端口設定中進行管理。

交易夥伴上傳的檔案會像來自任何其他端口的檔案一樣，以訊息的形式進入知行之橋工作流程。工作流程中的路由由 `SubFolder` 訊息頭處理，詳見[路由的運作方式](#路由的運作方式)。

> [!NOTE]
>
> 目前，網頁是唯一的存取方式。透過 SFTP 和 FTP 存取同一信箱的功能計劃在未來版本中提供。

## 端口配置

### 信箱設定索引標籤

此索引標籤頂部顯示的 **交易夥伴信箱 URL** 是交易夥伴存取其信箱所使用的位址。該 URL 的格式為 `.../connector/<workspace>/<connectorId>/mailbox.rst`。完成設定後，請將此 URL 分享給交易夥伴。

#### 信箱身分驗證

*交易夥伴登入信箱頁面時使用的憑證。*

| 設定 | 描述 |
| - | - |
| **使用者** | 交易夥伴信箱帳戶的使用者名稱。每個信箱只有一個帳戶。 |
| **密碼** | 交易夥伴信箱帳戶的密碼。 |

#### 檔案管理 - 交易夥伴下載

*控制為交易夥伴暫存的檔案在下載後如何管理的設定。*

| 設定 | 描述 |
| - | - |
| **當交易夥伴下載檔案時** | 是保留檔案以供重新下載，還是在首次下載後將其移除。**保留檔案直到保留期結束** 允許在檔案到期之前重複下載，而 **下載後刪除** 會在首次下載後移除檔案。將 **已下載檔案的保留期** 設定為 0 與 **下載後刪除** 的效果相同。 |
| **已下載檔案的保留期** | 已下載檔案可供重新下載的天數。預設值為 7 天。保留期從首次下載之日起計算，而不是從檔案暫存之時起計算，並且重新下載不會重設計時。僅當 **當交易夥伴下載檔案時** 設定為 **保留檔案直到保留期結束** 時適用。 |

#### 檔案管理 - 交易夥伴上傳

*控制允許交易夥伴上傳哪些檔案的設定。*

| 設定 | 描述 |
| - | - |
| **副檔名** | 在接受檔案之前對其套用的萬用字元模式篩選器。例如，`*.txt` 僅接受 .txt 檔案，`-*.pdf` 會封鎖 .pdf 檔案。多個檔案類型之間以逗號分隔。留空則接受所有檔案類型。 |

#### 交易夥伴信箱頁面

*面向交易夥伴的信箱頁面外觀設定。*

| 設定 | 描述 |
| - | - |
| **頁面標題** | 顯示在交易夥伴信箱頁面頂部的標題。 |
| **交易夥伴信箱 Logo** | 在信箱頁面上作為 Logo 顯示的圖片，以及 Logo 區域的背景顏色。 |

#### 交易夥伴信箱資料夾

資料夾設定分為兩個索引標籤：**傳送資料夾** 用於存放暫存供交易夥伴下載的檔案，**接收資料夾** 是交易夥伴上傳檔案的資料夾。每個索引標籤都有一棵獨立的資料夾樹，從一個根資料夾開始。**區段標題** 欄位用於設定交易夥伴頁面上該部分上方顯示的標題。

您可以在根資料夾下新增、重新命名、移動和刪除任意層級的子資料夾。資料夾名稱只能包含字母、數字和底線，並且在同一父資料夾中必須唯一（比較時不區分大小寫）。根資料夾無法刪除。

將滑鼠懸停在資料夾上，必要時可使用寫字板和鉛筆圖示將其重新命名。使用帶加號的資料夾圖示可向樹中新增子資料夾。頂層資料夾無法刪除，但可以點選垃圾桶圖示刪除子資料夾。如需詳細資訊，請參閱[管理資料夾樹](#管理資料夾樹)。

##### 傳送資料夾

| 設定 | 描述 |
| - | - |
| **區段標題** | 交易夥伴信箱頁面上下載部分上方顯示的標題。預設為 **Files For You**。 |

##### 接收資料夾

| 設定 | 描述 |
| - | - |
| **區段標題** | 交易夥伴信箱頁面上上傳部分上方顯示的標題。預設為 **Your submissions**。 |

### 設定索引標籤

#### 端口資訊

*用於識別和描述端口的一般設定。*

| 設定 | 描述 |
| - | - |
| **端口 Id** | 端口的靜態唯一識別碼。 |
| **端口類型** | 顯示端口名稱及其功能說明。 |
| **端口描述** | 選填欄位，用於以自由文字形式描述端口及其在工作流程中的角色。 |

### 進階索引標籤

#### 進階設定

| 設定 | 描述 |
| - | - |
| **上傳歷史保留期** | 交易夥伴上傳的檔案在其信箱頁面的提交歷史中保持可見的天數。預設值為 30 天。檔案本身在被接受時就會立即傳遞給工作流程；此設定僅控制交易夥伴可以在多長時間內看到自己已提交該檔案。 |

#### 日誌

*用於管理日誌建立和儲存的設定。*

<table><thead><tr><th>設定</th>
<th>描述</th></tr></thead>
<tbody><tr><td>**日誌級別**</td>
<td>指定要記錄在端口日誌目錄中的資訊型別：
<ul><li>**None** - 不建立任何日誌。</li>
<li>**Error** - 僅當端口遇到錯誤時才建立日誌。</li>
<li>**Warning** - 僅當端口發出警告時才建立日誌。</li>
<li>**Info** - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。</li>
<li>**Debug** - 記錄成功和失敗工作流程的詳細偵錯資訊。</li>
<li>**Trace** - 記錄成功和失敗工作流程的詳細跟蹤資訊。</li></ul>
\*\*請注意：\*\***Debug** 和 **Trace** 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。</td></tr>
<tr><td>**日誌資料夾結構**</td>
<td>指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，**Weekly** 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。</td></tr>
<tr><td>**保留訊息副本**</td>
<td>指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。</td></tr></tbody></table>

#### 其它

*特殊設定適用於特定用例。*

<table><thead><tr><th>設定</th>
<th>描述</th></tr></thead>
<tbody><tr><td>**其他設定**</td>
<td>允許在以分號分隔的清單中配置隱藏的端口設定，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用這些設定。</td></tr></tbody></table>

### 通知索引標籤

*與配置通知相關的設定。*

在執行服務級別協議 (SLA) 之前，需要設定電子郵件通知以接收通知。預設情況下，知行之桥 使用 [通知](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/alerts.md) 索引標籤上的全域設定。要為此端口使用其他設定，請啟用 **覆蓋全域設定**。

預設情況下，錯誤通知處於啟用狀態，這意味著每當出現錯誤時都會傳送電子郵件。要關閉錯誤通知，請取消選中 **啟用** 核取方塊。

輸入 **主題**（必填）。勾選**允許在主題中使用 ArcScript**，即可在**主題**欄位中使用 ArcScript。選中後會顯示 **ArcScript 編輯器**按鈕（![ArcScript 編輯器按鈕](https://docs.kasoftware.com/26.4/images/rest_arcscript_editor.png)）。

（可選）輸入以逗號分隔的**收件人**電子郵件地址清單。

### SLA 索引標籤

*與配置服務級別協議 (SLA) 相關的設定。*

SLA 允許配置預期流程中端口傳送或接收的資料量，並設定預期達到該資料量的時間範圍。當 SLA 未達到時，知行之桥 會傳送電子郵件警告使用者，並將 SLA 標記為 *存在風險*，這意味著如果 SLA 未能儘快達到，則會被標記為 *已違反*。這讓使用者有機會介入並確定 SLA 未達到的原因，並採取適當的措施。如果在風險時間段結束時仍未達到 SLA，則會將 SLA 標記為已違反，並再次通知使用者。

SLA 轉換為 *存在風險* 或 *已違反* 狀態時，也會寫入[應用程式日誌](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#应用程序日志)，這意味著應用程式效能監控 (APM) 和日誌擷取工具也可以針對這些狀態發出警示。

要定義 SLA，請啟用 **預期資料量**，然後點選 **設定** 索引標籤。

![SLA Empty](https://docs.kasoftware.com/26.4/images/sla_empty.png)
<ul><li>如果端口具有單獨的傳送和接收操作，請使用選項按鈕指定 SLA 適用的方向。</li>
<li>在視窗的 **預計至少** 部分中：
<ul><li>設定預計處理的最小交易數量（交易量）</li>
<li>使用 **每個** 欄位指定時間範圍</li>
<li>指示 SLA 生效的時間。如果選擇 **開始於**，請填寫日期和時間欄位。</li>
<li>勾選希望 SLA 生效的星期幾對應的核取方塊。如有必要，請使用下拉功能表選擇 **每天**。</li></ul></li>
<li>在視窗的 **將狀態設定為“有風險”** 部分中，指定應將 SLA 標記為有風險的時間。
<ul><li>預設情況下，只有在違反 SLA 的情況下才會傳送通知。要更改此設定，請勾選 **傳送“有風險”通知**。</li></ul></li></ul>

以下範例顯示了為端口配置的 SLA，該端口預計在週一至週五每天接收 1000 個檔案。如果尚未收到 1000 個檔案，則會在時間段結束前 1 小時傳送風險通知。

![SLA Configuration Example](https://docs.kasoftware.com/26.4/images/sla_defined.png)

> [!NOTE]
>
> 如果有必要，可以關閉 SLA 通知。這在維護視窗期間非常有用。點選導覽列上的 **設定**，然後跳轉到 **通知 > 通用通知**。點選平板和鉛筆圖示進行編輯，並取消勾選 **SLA 通知** 設定。

## 路由的運作方式

Partner Mailbox 端口中的路由使用其他 MFT 端口所採用的標準 `SubFolder` 訊息頭機制。

**交易夥伴上傳（接收資料夾）**

當交易夥伴上傳檔案時，檔案會被寫入交易夥伴在信箱頁面上選擇的接收子資料夾。產生的訊息帶有一個 `SubFolder` 訊息頭，其值為該資料夾的路徑。隨後，[Branch](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/branch.md) 等下游端口可以根據該訊息頭的值對訊息進行路由。這正是定義多個接收子資料夾的主要原因：交易夥伴可以透過選擇相應的資料夾來表明所傳送檔案的類型，工作流程則據此進行分支處理。

**為交易夥伴暫存檔案（傳送資料夾）**

若要將檔案投遞到交易夥伴頁面上的特定傳送子資料夾，上游端口或指令碼必須在訊息到達 Partner Mailbox 端口\_之前\_將 `SubFolder` 訊息頭設定為目標子資料夾路徑。端口本身沒有路由 UI。您必須在工作流程的前段設定該訊息頭，通常使用 [Script](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/script.md) 端口。

> [!NOTE]
>
> 在上游端口中設定 `SubFolder` 訊息頭時請格外注意。如果該訊息頭缺失或設定為不存在的路徑，檔案將被回報為無法投遞，並新增到出錯訊息檢視中。如需詳細資訊，請參閱[管理資料夾樹](#管理資料夾樹)。

## 管理資料夾樹

重新命名、移動或刪除傳送或接收資料夾，可能會影響已暫存或正在傳輸中的檔案。在確認此類變更之前，知行之橋會顯示受影響資料夾中目前的檔案數量。請在繼續作業之前確認不會有檔案被滯留。

重新命名或移動資料夾後，已暫存在舊路徑下的檔案不會自動更新。任何將 `SubFolder` 訊息頭設定為舊路徑的上游端口或指令碼，也必須更新為使用新路徑。

被回報為無法投遞的檔案會顯示在出錯訊息檢視中。新增缺失的資料夾或更正上游指令碼後，可以將這些檔案重新排入佇列。

## 保留期與檔案生命週期

以下規則決定了傳送資料夾中的檔案在暫存後如何管理：

* **下載後刪除**：檔案在首次下載後會從交易夥伴的信箱頁面中移除。將 **已下載檔案的保留期** 設定為 0 具有相同的效果。
* **保留檔案直到保留期結束**：在保留期到期之前，交易夥伴可以重新下載該檔案。每次下載都會在端口的交易日誌中記錄為一次成功傳送。
* **保留期從首次下載開始計算**，而不是從檔案暫存之時開始計算。重新下載不會重設保留期。
* **從未被下載的檔案永遠不會**因保留期設定而**被清除**。這些檔案會一直可用，直到被手動移除。
* **應用程式層級和工作區層級的傳送資料夾[清理設定](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/getting-started/administration/settings/cleanup-settings.md)不會影響 Partner Mailbox 的傳送資料夾。** Partner Mailbox 端口會獨立管理其保留期。

## 交易夥伴信箱檢視

交易夥伴透過存取 **信箱設定** 索引標籤上顯示的 **交易夥伴信箱 URL** 並輸入其憑證來存取信箱。身分驗證使用瀏覽器原生的基本驗證。

信箱頁面包含兩個部分，如下圖所示：

![交易夥伴信箱頁面，並排顯示「給您的檔案」和「您提交的檔案」兩個部分](https://mintcdn.com/qiao/HyyOl9gYIsxaiGgh/26.4/images/partner-mailbox-page.png?fit=max\&auto=format\&n=HyyOl9gYIsxaiGgh\&q=85\&s=68ca47a2c20191b0bc8cf44d239d2f28)

### 給您的檔案（傳送資料夾）

列出暫存供交易夥伴下載的檔案。每一列顯示檔名、檔案大小、檔案暫存日期和狀態。對於交易夥伴尚未下載的檔案，狀態為 **Available**；對於已下載的檔案，狀態為 **Downloaded** 並附帶首次下載的日期。下載按鈕僅顯示在可用的列上。下載整個資料夾時，會傳回一個以該資料夾命名的 zip 檔案。保留期已過的檔案會從清單中無聲消失。

### 您提交的檔案（接收資料夾）

列出交易夥伴已上傳的檔案。每一列顯示檔名、檔案大小、提交日期和時間以及狀態。若要上傳檔案，交易夥伴可以將檔案拖放到上傳區域，或使用檔案選擇器，檔案將上傳到目前選取的接收子資料夾。上傳成功和失敗均以 Toast 通知的形式顯示；因副檔名篩選器而被封鎖的上傳會附帶一則說明拒絕原因的通知。


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