> ## 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 = "知行之橋";

端口是用於透過 {siteNameShort} 建立資料處理流程的構建塊。每個端口可執行以下任務之一：

* 使用標準網路協議（AS2、AS4、FTP、SFTP、OFTP 等）與外部目標之間傳輸檔案
* 與資料庫或雲應用程式等後端系統整合
* 使用或公開 RESTful Web API
* 將資料從一種格式轉換為另一種格式
* 壓縮/解壓縮或加密/解密資料
* 修改檔案內容或訊息頭
* 使用條件邏輯路由檔案，以建立複雜的資料流

端口連線在一起可建立自動化資料處理流程。每個端口執行其特定任務後，所有接收或處理的檔案都會傳遞到流程中的下一個端口。

這種模組化方法使 {siteNameShort} 能夠處理各種複雜度的業務任務。下圖顯示了一組 {siteNameShort} 端口如何使用從後端資料來源檢索到的 XML 資料生成出站 EDI 文件：

<img src="https://mintcdn.com/qiao/Pa-LScG1ebkabWPi/public/images/connectors.png?fit=max&auto=format&n=Pa-LScG1ebkabWPi&q=85&s=13fd0d0c9582bced7db94eb502731305" alt="端口" width="559" height="341" data-path="public/images/connectors.png" />

### 配置

每個端口都有一系列索引標籤，可用於配置端口執行任務所需的設定。這些索引標籤包括：

* **設定**，用於管理連線和身分驗證參數
* **高階**，用於其他端口特定設定以及訊息和日誌資訊
* **自動化**，用於指定端口應如何自動處理檔案、輪詢要下載的檔案、重試失敗訊息等
* **通知**，用於在需要時覆蓋全域[通知設定](../getting-started/administration/settings/alerts)
* **SLA**，用於配置期望流程中的端口傳送或接收的數量，並設定期望達成該數量的時間範圍
* **交易**，用於管理端口與本地檔案系統的介面
* **事件**指令碼，用於在端口處理期間的特定時間點執行自定義邏輯

某些端口（如 AS2 和 AS4）還要求配置本地個人設定以接收入站連線。

### 日誌

端口傳送、接收或處理檔案時，會將此操作記錄為交易。可以在端口的**交易**索引標籤中檢視特定端口的交易，也可以在活動頁面的**交易**索引標籤上檢視\_所有\_端口的交易。

有關每個交易項目會捕獲哪些資訊的詳細資訊，請參閱活動文件。

<Note>日期/時間項目始終根據瀏覽器的本地時區和日期格式設定進行本地化顯示，因此即使瀏覽託管在不同時區的伺服器，顯示的時間戳也會反映本地時間。</Note>

### 訊息

端口處理檔案時，可以選擇向檔案新增中繼資料。此資訊會作為訊息捕獲，並以特殊的 <var>.eml</var> 副檔名儲存在應用程式資料庫中。有關每條訊息會捕獲哪些資訊的詳細資訊，請參閱[訊息索引標籤](../getting-started/administration/activity#messages-tab)文件。

### 端口型別

端口分為基礎（Core）、可控檔案傳輸（MFT）、電子資料交換（EDI）、資料庫（Database）和其他（Other）類別。每個端口都屬於這些類別之一。

* [基礎（Core）端口](./core-connectors)提供構建資料工作流程的基礎功能。
* [可控檔案傳輸（MFT）端口](./mft-connectors)擴充套件了 {siteNameShort} 使用安全檔案傳輸協議傳送和接收檔案的能力。
* [電子資料交換（EDI）端口](./edi-connectors)支援轉換和操作 EDI 文件，以將這些文件與後端系統或 {siteNameShort} 流程的其他方面整合。
* [資料庫（Database）端口](./database-connectors)提供連線各種資料庫的能力。
* [其他（Other）端口](./other-connectors)包括不屬於其他類別的各種端口。它們與應用程式的其餘部分分開授權。

除了上述類別之外，流程中的每個端口還會分配以下三種行為類別之一：觸發、轉換和終結。端口操作的配置及其在流程中的位置決定了其類別。

* 觸發端口透過**接收自動化**拉取或建立檔案來啟動流程；對於支援被動接收的端口，則在端口從外部用戶端接收到檔案時啟動流程。範例包括 [AS2](./as2)、[Email Receive](./email-receive) 或 [SFTP](./sftp)。
* 轉換端口位於流程中間，負責對訊息執行處理（以某種方式修改訊息）。範例包括 [X12](./x12)、[XML Map](./xml-map/xml-map) 或 [CSV](./csv)。
* 終結端口是流程的末端，{siteNameShort} 在此將訊息傳遞到底層磁碟，或者端口在傳送操作期間消耗訊息且不生成任何輸出。範例包括 [File](./file)、[MySQL](./mysql/mysql) 或任何配置為 Upsert 的資料庫端口。

<Note>
  - 許多端口，例如 [File](./file)、[FTP](./ftp) 和 [SOAP](./soap)，可以用作觸發端口或終結端口，具體取決於配置的[操作](../flows/designing-a-flow#specifying-actions)以及它們在流程中出現的位置。
  - [Script](./script)、[REST](./rest) 和任何 [Database](./database-connectors) 端口都可以充當這三類端口中的任何一種，同樣取決於配置的操作以及它們在流程中出現的位置。
</Note>

### 批次編輯端口

點選導覽列上的**工作流程 (Flows)**，然後選擇右上角的**端口檢視 (Connector View)** 即可存取該檢視。它會顯示應用程式中所有端口的清單，使使用者能夠在大規模場景下高效定位和管理端口。如果您擁有端口管理權限，可以使用此檢視對端口執行批次編輯。詳情請參閱[端口檢視與批次編輯端口](./bulk-edit-connectors)。

### 端口退避

當端口反覆傳送檔案失敗時，{siteNameShort} 會自動進入退避狀態，暫時暫停自動化，以防止資源耗盡和產生過多日誌。處於退避狀態時，端口會顯示狀態指示器，其中包含退避原因以及計劃恢復自動化的時間。有關詳細資訊，請參閱[端口退避](./connector-backoff)。