> ## 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} 如何簡化錯誤處理。

<iframe width="560" height="315" src="//player.bilibili.com/player.html?aid=403522324&bvid=BV11V411N7ix&cid=1201012415&page=1" scrolling="no" border="0" frameBorder="no" framespacing="0" allowFullScreen />

## 重試和重發

許多端口可以在端口的 **自動化** 索引標籤上配置重試和重發設定。這些設定決定端口在向遠端目標傳送或上傳檔案失敗時如何回應。

### 重試

當 {siteNameShort} 端口嘗試向遠端伺服器傳送或上傳檔案，而伺服器未指示已成功接收檔案時，將觸發重試。這包括各種潛在問題，例如基本連線問題（例如，防火牆阻止與伺服器連線）、權限問題（例如，伺服器不允許存取目標資源）以及應用程式級處理錯誤（例如，AS2 夥伴的系統無法將傳入請求與已配置的 AS2 配置檔案匹配）。

支援重試邏輯的端口具有 **重試間隔** 和 **最大嘗試次數** 配置欄位。觸發重試後，端口會等待 **重試間隔** 經過，然後再次嘗試傳送或上傳檔案。該過程會持續到 **最大嘗試次數** 用盡。只有在重試次數用盡後，端口才會擲回錯誤。

**最大嘗試次數**值包括原始的傳送或上傳嘗試次數，因此將此值設定為 1 可確保失敗的傳送不會重試。將此欄位設定為非正值會指示端口無限期重試，而不是擲回錯誤。

利用重試邏輯有助於 {siteNameShort} 容忍干擾資料傳輸的臨時網路狀況。如果合作伙伴的伺服器暫時關閉，或者網路狀況暫時不穩定，除非這些錯誤持續到整個重試過程結束，否則應用程式會“吞併”這些錯誤。這樣可以最大程度減少非關鍵故障的停機時間，並防止不必要的錯誤提醒。

### 重發

只有實現了內建確認機制協議（例如 AS2 和 AS4）的端口才支援重發功能。當端口傳送應被確認的訊息，但在配置的 **重發間隔** 內未收到確認時，將觸發重發。

端口不會擲回錯誤，而是嘗試再次傳送訊息。此過程會重複，直到端口收到預期的確認，或直到 **最大嘗試次數** 用盡。重發嘗試用盡後，端口會擲回錯誤。

## 錯誤路由

當端口在傳送、上傳或處理檔案時遇到問題，並且所有可用的重試和重發次數均用盡時，端口會擲回錯誤。特定於檔案交易的錯誤記錄在[日誌頁面](../getting-started/administration/activity)中，而與更一般應用程式資源相關的錯誤記錄在[應用程式日誌](../getting-started/administration/activity#application-logs)中。

導致錯誤的檔案會根據 <var>錯誤路徑</var> 在工作流程中路由。錯誤路徑由紅色虛線表示，該虛線與藍色工作流程路徑分開。預設情況下，錯誤路徑是隱藏的，但可以透過右鍵單擊端口並選擇 **顯示錯誤路徑** 來檢視：

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/show_error_path.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=969dbc5e32abcd1d02456bcb1fdafbd0" alt="Show error path option in the connector context menu" width="400" data-path="public/images/show_error_path.png" />

一旦錯誤路徑可見，拖動紅點到另一個端口的左側（就像藍色工作流程路徑一樣）以配置錯誤路徑。導致錯誤的檔案將被路由到透過錯誤路徑連線的端口。沒有導致錯誤的檔案不受錯誤路徑影響。

### 路由至 Notify 端口

[Notify 端口](../connectors/notify)通常與錯誤路徑一起使用。如果某個端口無法傳送、上傳或處理檔案時需要通知系統管理員，此設定非常有用。使用系統管理員的目標郵箱配置 Notify 端口，然後使用錯誤路徑將發生錯誤的端口連線到 Notify 端口。

配置後，包含引發錯誤檔案相關資訊的郵件將自動傳送到指定收件人。

<Note>Notify 端口使用 **系統設定** 頁面[提醒](../getting-started/administration/settings/settings-page#alerts)索引標籤中配置的 SMTP 設定來傳送郵件。</Note>

## 全域提醒

除了使用錯誤路徑路由導致錯誤的特定檔案外，{siteNameShort} 還支援全域錯誤提醒系統。

**設定** 頁面上的[提醒](../getting-started/administration/settings/settings-page#alerts)索引標籤包含用於啟用全域提醒的設定。啟用全域提醒在功能上等同於透過上述錯誤路徑，將工作流程中的每個端口連線到共享的 Notify 端口。

啟用後，工作流程中的端口擲回的任何錯誤都會自動生成包含錯誤相關資訊的外發郵件（和/或 Windows 事件）。