核心功能
- 通用 TCP/IP 伺服器端點,支援 TLS/SSL 和明文傳輸,適用於任意資料流
- 可配置的訊息分隔,支援使用靜態分隔符號或基於長度的解析
- 具備雙向通訊能力,支援基於連線 ID 的路由和連線事件訊息
概觀
每個 TCP Server 端口都會在指定的端口上監聽傳入的 TCP 流量,可以是 TLS/SSL 加密,也可以是純文字。該端口適用於 知行之橋 需要接收不一定符合其它標準協議提供的約束的任意資料時的情況。 由於 TCP 流量是一個恆定的流,本質上沒有”開始”或”結束”點,因此必須對端口進行配置,以確定一個訊息的結束點和下一個訊息的開始點。端口支援兩種方法:- 一個靜態的字串/字元分隔符號,用於結束當前訊息或開始下一個訊息。
- 讀取傳入的 TCP 資料中的一個值,以確定資訊的長度。
端口配置
設定索引標籤
配置
與端口關鍵配置有關的設定。訊息解碼
與區分 TCP 流中的單個訊息有關的設定。TLS 設定
與 TLS/SSL 傳輸安全相關的設定。進階設定索引標籤
保持活動
與伺服器傳送 keep-alive 資料包以保持空閒連線有關的設定。進階設定
先前目錄中未包含的設定。訊息
訊息設定確定端口如何搜尋訊息並在處理後管理它們。
注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。
| 設定 | 描述 |
|---|---|
| 儲存到已傳送資料夾(已棄用) | 將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| 已傳送資料夾方案(已棄用) | 按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。 |
日誌
用於管理日誌建立和儲存的設定。
| 設定 | 描述 |
|---|---|
| 日誌級別 | 指定要記錄在端口日誌目錄中的資訊型別:
|
| 日誌資料夾結構 | 指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。 |
| 保留訊息副本 | 指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。 |
雜項設定
特殊設定適用於特定用例。
| 設定 | 描述 |
|---|---|
| 其他設定 | 允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。 |
伺服器索引標籤
受信任的 IP 地址
自動化索引標籤
自動化
與端口自動處理檔案相關的設定。效能
與端口資源分配相關的設定。
| 設定 | 描述 |
|---|---|
| 最大工作執行緒數 | 此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
| 最大檔案數 | 分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
告警索引標籤
SLA 索引標籤
日誌索引標籤
日誌索引標籤列出該端口生成的服務日誌。每一行代表一個日誌檔案,並顯示修改日期、檔名、大小和狀態。可以使用搜尋欄或狀態篩選器查詢特定日誌,點選檔名進行預覽或下載,或點選下載全部日誌將所有日誌下載為一個 zip 檔案。
連線和斷開訊息
預設情況下,TCP Server 端口僅在用戶端傳輸資料時生成 知行之橋 訊息,以便端口識別完整的訊息(根據訊息解碼部分的設定)。當用戶端連線到伺服器(如果在進階設定索引標籤中啟用了連線訊息)或斷開與伺服器的連線(如果在進階設定索引標籤中啟用了斷開訊息)時,端口也可以生成 知行之橋 訊息。 當這些特殊訊息生成後,知行之橋 訊息中會新增一個特殊的標頭:x-tcpserver-event
用戶端連線時,此標頭設定為值 connected,而用戶端斷開連線時,此標頭設定為 disconnected。
該標頭必須由工作流程中之後的端口檢查,以檢測寫入 TCP Server 端口輸出資料夾的訊息是否屬於這些特殊訊息。
傳送訊息
TCP Server 端口還使用一個特殊的標頭值來向連線的用戶端傳送訊息:x-tcpserver-connectionid
該標頭被新增到端口生成的任何輸出訊息中,設定為 “Connection ID” 值,以唯一標識所連線的用戶端之一。為了確保訊息被傳送到正確的用戶端,被傳送回此用戶端的訊息 必須 將此相同的標頭設定為相同的值。
由於該標頭已經存在於端口寫出的任何訊息中,因此如果訊息透過 知行之橋 工作流程並傳回 TCP Server 端口的交易索引標籤,它仍將具有相同的 “Connection ID” 值,並將傳回給傳送原始訊息的同一個用戶端。如果訊息不能直接路由回 TCP Server 端口,那麼必須儲存 “Connection ID” 值,並將其作為一個標頭(與上面列出的名稱相同)應用到任何傳回給用戶端的新訊息中。