Script 端口

Script 端口提供了執行內建端口中不可用的函式或操作的能力。

核心功能

使用 ArcScript 或 Python 實現自定義業務邏輯
存取完整的訊息上下文，包括訊息標頭和檔案內容
整合外部庫和系統命令 (Python)
支援複雜的資料轉換和業務規則處理

概觀

Script 端口使用強大的 ArcScript 指令碼語言來完成各種自定義行為。每當文件被放入端口的交易索引標籤時，端口中配置的指令碼就會執行。指令碼可以讀取和修改輸入文件，也可以讓輸入文件僅觸發端口中配置的外部函式。Script 端口也可以透過自動化索引標籤上的接收自動化按計劃執行。以下是可配置 Script 端口執行的一些任務：

使用自定義 SQL 查詢傳回的資料替換輸入文件中的值
呼叫自定義 Web 服務以觸發專用工作流程
透過 sysExecute 操作執行外部指令碼或執行檔

為 Script 端口確定合適的任務後，請閱讀指令碼文件，瞭解如何使用 ArcScript 呼叫各種操作。

端口配置

本節包含所有可配置的端口屬性。

Script 索引標籤

與編寫和測試指令碼相關的選項。

設定	說明
操作下拉功能表	選擇端口的操作。（有關這三個選項的詳細資訊，請參閱操作。）
ArcScript 編輯器	使用編輯器編寫指令碼。工具列包含撤消、重做、刪除、複製和格式化等標準編輯選項。它還包含一個用於隱藏右側窗格中“插入選項”的選項。
插入選項	右側窗格中的面板可讓您透過單擊輕鬆將程式碼插入指令碼。下拉功能表包含輸入和輸出（例如 ConnectorId 或 Encoding，可用選項取決於配置的操作）、程式碼片段、關鍵字、運算子和格式化程式。找到要插入的程式碼，然後單擊即可新增。
測試索引標籤	指定是否以訊息正文或標頭形式檢視指令碼輸入和/或輸出。此索引標籤上的選項會因指令碼的操作型別而異（例如，觸發器指令碼沒有輸入）。單擊測試以測試指令碼。
日誌索引標籤	顯示測試日誌。
上次更新時間	顯示指令碼上次修改和儲存的日期時間。
自動更新	使用切換開關在每次修改後自動測試指令碼。

操作

設定索引標籤

配置

與端口核心操作相關的設定。

進階設定

設定	說明
本地檔案方案	用於為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏來包含識別碼和時間戳等資訊。有關更多資訊，請參閱宏。

進階選項卡

訊息

日誌

其他設定

設定	說明
處理延遲	放入交易索引標籤的檔案延遲處理的時間（以秒為單位）。這是一箇舊版設定。最佳實踐是使用 File 端口管理本地檔案系統，而不是使用此設定。

雜項

自動化索引標籤

自動化設定

與端口自動處理檔案相關的設定。

設定	說明
傳送	到達端口的訊息是否會自動處理。
重試間隔	端口在重試失敗的指令碼執行之前等待的分鐘數。
最大重試次數	端口在引發錯誤之前重試失敗指令碼執行的次數。
接收	端口是否應按配置的計劃自動執行指令碼。
接收執行間隔	接收自動化計劃所用的時間單位（如分鐘、小時或天）。
經過整點的分鐘數	小時計劃的分鐘偏移量。僅當上述間隔設定為_每小時_時適用。
時間	嘗試發生的具體時間。僅當上述間隔設定為_每天_、_每週_或_每月_時適用。
日期	嘗試發生的日期。僅當上述間隔設定為_每週_或_每月_時適用。
分鐘	嘗試下載前等待的分鐘數。僅當上述間隔設定為_分鐘_時適用。
Cron 運算式	表示 Cron 運算式的五段字串，用於確定嘗試發生的時間。僅當上述間隔設定為_高階_時適用。

效能

警示索引標籤

SLA 索引標籤

交易索引標籤

此索引標籤列出了與端口關聯的所有訊息。使用搜尋欄查詢特定訊息，或單擊漏斗圖示應用過濾器。您可以按時間、訊息方向和/或狀態進行過濾。此索引標籤上的選項會因端口的操作型別而異：

如果端口是觸發器，請使用接收按鈕啟動工作流程。
如果端口是轉換或終結，請使用上傳檔案按鈕將檔案上傳到工作流程。

使用 arc:push 關鍵字

arc:push 關鍵字通常用於 Script 端口，以將專案傳遞到指令碼的輸出 Feed。此外，當從“插入選項”功能表中選擇 Output 屬性時，如果指令碼中尚未包含 arc:push 關鍵字，會自動注入該關鍵字，以確保指令碼正常執行。以下是三個常見用例。 1 建立並輸出檔案：

<arc:set attr="output.filename" value="results.txt" />
<arc:set attr="output.data" value="This is my result" />
<arc:push item="output" />

2 將輸入檔案作為輸出傳遞：

<arc:set attr="output.filepath" value="[filepath]" />
<arc:push item="output" />

3 向 Script 端口日誌檔案寫入項目：

<arc:set attr="logger.log#" value="Custom Log entry line 1" />
<arc:set attr="logger.log#" value="Custom Log entry line 2" />
<arc:push item="logger" />

入門指南

工作流

EDI 交易夥伴管理控制台

端口

對映

系統 API

操作指南

腳本編寫

軟體許可和第三方版權

核心功能

概觀

端口配置

Script 索引標籤

操作

設定索引標籤

配置

進階設定

進階選項卡

訊息

日誌

其他設定

雜項

自動化索引標籤

自動化設定

效能

警示索引標籤

SLA 索引標籤

交易索引標籤

使用 arc:push 關鍵字

宏

範例

​核心功能

​概觀

​端口配置

​Script 索引標籤

​操作

​設定索引標籤

​配置

​進階設定

​進階選項卡

​訊息

​日誌

​其他設定

​雜項

​自動化索引標籤

​自動化設定

​效能

​警示索引標籤

​SLA 索引標籤

​交易索引標籤

​使用 arc:push 關鍵字

​宏

​範例

核心功能

概觀

端口配置

Script 索引標籤

操作

設定索引標籤

配置

進階設定

進階選項卡

訊息

日誌

其他設定

雜項

自動化索引標籤

自動化設定

效能

警示索引標籤

SLA 索引標籤

交易索引標籤

使用 arc:push 關鍵字

宏

範例