核心功能
- 使用 ArcScript 或 Python 實現自定義業務邏輯
- 存取完整的訊息上下文,包括訊息標頭和檔案內容
- 整合外部庫和系統命令 (Python)
- 支援複雜的資料轉換和業務規則處理
- 使用 connectorBatchGroupRead 知行之橋Script 操作處理批次處理組訊息
概觀
Script 端口使用強大的 ArcScript 指令碼語言來完成各種自定義行為。每當文件被放入端口的交易索引標籤時,端口中配置的指令碼就會執行。指令碼可以讀取和修改輸入文件,也可以讓輸入文件僅觸發端口中配置的外部函式。Script 端口也可以透過自動化索引標籤上的接收自動化按計劃執行。 以下是可配置 Script 端口執行的一些任務:- 使用自定義 SQL 查詢傳回的資料替換輸入文件中的值
- 呼叫自定義 Web 服務以觸發專用工作流程
- 透過 sysExecute 操作執行外部指令碼或執行檔
端口配置
本節包含所有可配置的端口屬性。Script 索引標籤
與編寫和測試指令碼相關的選項。
操作
設定索引標籤
配置
與端口核心操作相關的設定。| 設定 | 描述 |
|---|---|
| 端口 Id | 端口的靜態、唯一識別碼。 |
| 端口型別 | 顯示端口型別及其用途的描述。 |
| 端口描述 | 一個可選欄位,用於提供端口及其在流中的角色的自由格式描述。 |
進階設定
進階選項卡
訊息
訊息設定確定端口如何搜尋訊息並在處理後管理它們。
注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。
| 設定 | 描述 |
|---|---|
| 儲存到已傳送資料夾(已棄用) | 將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| 已傳送資料夾方案(已棄用) | 按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。 |
日誌
用於管理日誌建立和儲存的設定。
| 設定 | 描述 |
|---|---|
| 日誌級別 | 指定要記錄在端口日誌目錄中的資訊型別:
|
| 日誌資料夾結構 | 指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。 |
| 保留訊息副本 | 指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。 |
其他設定
雜項
特殊設定適用於特定用例。
| 設定 | 描述 |
|---|---|
| 其他設定 | 允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。 |
自動化索引標籤
自動化設定
與端口自動處理檔案相關的設定。自動化狀態
效能
與端口資源分配相關的設定。
| 設定 | 描述 |
|---|---|
| 最大工作執行緒數 | 此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
| 最大檔案數 | 分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
警示索引標籤
SLA 索引標籤
交易索引標籤
此索引標籤列出了與端口關聯的所有訊息。使用搜尋欄查詢特定訊息,或單擊漏斗圖示應用過濾器。您可以按時間、訊息方向和/或狀態進行過濾。 此索引標籤上的選項會因端口的操作型別而異:- 如果端口是觸發器,請使用接收按鈕啟動工作流程。
- 如果端口是轉換或終結,請使用上傳檔案按鈕將檔案上傳到工作流程。
使用 arc:push 關鍵字
arc:push 關鍵字通常用於 Script 端口,以將專案傳遞到指令碼的輸出 Feed。此外,當從“插入選項”功能表中選擇 Output 屬性時,如果指令碼中尚未包含arc:push 關鍵字,知行之橋 會自動注入該關鍵字,以確保指令碼正常執行。以下是三個常見用例。
1 建立並輸出檔案: