跳轉到主要內容
Python 連接器可在工作流程中執行自定義 Python 程式碼,用於補充 知行之橋 內建功能。

主要功能

  • 對流經連接器的每條訊息執行 Python 指令碼
  • 讀取和修改當前訊息的檔名、內容與上下文
  • 使用外部 Python 庫並呼叫系統命令
  • 實現自定義轉換、驗證和自動化邏輯

概觀

連接器會針對 Transactions 索引標籤中的每個文件執行所配置的指令碼。也可以透過排程工作觸發 Receive 操作。有關指令碼環境和可用物件的詳細資訊,請參閱編寫 Python 指令碼。

Python 索引標籤

設定

配置

設定描述
端口 Id端口的靜態、唯一識別碼。
端口型別顯示端口型別及其用途的描述。
端口描述一個可選欄位,用於提供端口及其在流中的角色的自由格式描述。
  • Local File Scheme:連接器在本地檔名中使用的方案。

進階設定

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。

設定描述
儲存到已傳送資料夾(已棄用)將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案(已棄用)按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

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

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

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

設定描述
其他設定允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。

自動化

自動化狀態

與端口資源分配相關的設定。

設定描述
最大工作執行緒數此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。
最大檔案數分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。

Transactions 索引標籤

Python 連接器可以作為:
  • Trigger:透過計劃的 Receive 操作建立訊息。
  • Transform:處理輸入訊息並將輸出傳送到後續連接器。
  • Terminal:處理訊息但不產生後續輸出。

生成輸出與日誌

使用 output 物件建立或更新輸出訊息:
也可以讓輸出訊息繼續使用當前輸入檔案:
print(...) 的輸出會寫入當前訊息的日誌。若要寫入應用程式日誌,請使用:
支援的日誌級別包括 DEBUG、INFO、WARNING 和 ERROR。

宏

範例