Skip to main content
資料庫端口(Database connector)允許連線到多種不同的資料庫型別,並可以從這些資料庫中推送或拉取資料。

核心功能

  • 通用資料庫連線:支援主流資料庫平臺。
  • 驅動程式支援:同時支援 ADO.NET 和 JDBC 驅動程式。
  • 全面的交易管理:具備提交 (Commit) 和復原 (Rollback) 功能。
  • 標準資料庫操作:提供查詢 (Select)、查詢 (Lookup)、更新/插入 (Upsert) 和預存程序 (Stored Procedure) 用於資料操作。
  • 高階查詢自定義:支援查詢自定義和參數繫結。
按照以下步驟將知行之橋連線到 Database。

建立資料庫連線

在將 Database 端口新增到工作流程之前,必須在本地計算機上配置與資料庫的連線。
Database 端口中引用且需要許可的資料來源,應在知行之橋外部的計算機上完成許可授權。

ADO.NET

知行之橋的 .NET 版本主要使用 ADO.NET 驅動程式。為了讓 ADO.NET 提供程式對知行之橋可見,它必須在 machine.config 檔案中定義,並在全域程式集快取 (GAC) 中註冊。熟悉相關操作的使用者可以手動完成此過程,但 知行軟體建議在託管知行之橋的計算機上安裝資料庫用戶端,因為資料庫特定的安裝嚮導會處理提供程式的定義和註冊。

JDBC

為了讓 JDBC 驅動程式對知行之橋可見,它必須作為 Java 類路徑的一部分包含在內。知行之橋包含 H2、MySQL、PostgreSQL 和 SQL Server 的驅動程式;如需將其他驅動程式新增到類路徑,請參閱 Java Web servlet 的文件。
除了預設選項之外,Database 端口還支援其他資料庫的 JDBC 驅動程式。但是,自定義驅動程式可能需要覆蓋端口發出的查詢,以符合資料庫預期的語法。可以使用 Input Mapping 或 Output Mapping 的 Write custom query 部分覆蓋查詢。

配置 Database 端口

配置資料庫連線後,可以將 Database 端口新增到知行之橋工作流程中。必須在 Database 端口的每個例項中輸入資料庫連線憑據。 按照以下步驟建立連線:
  1. 將 Database 端口拖入知行之橋工作流程,併為其命名。
  2. 在 Settings 索引標籤的 Database Connection 部分,從清單中選擇 Driver Name。Driver Class 會自動填充。
  3. 選擇 Settings Format。
    1. 如果選擇 Property List,請填寫驅動程式特定的屬性。這些屬性因驅動程式而異。
    2. 如果選擇 Connection String 或 DatabaseURL,請向資料庫提供完整的連接字串。
  4. 單擊 Test Connection,確保知行之橋可以連線到 Database。如果發生錯誤,請檢查所有欄位並重試。
  5. 單擊 Save Changes。

其他資料庫連線

Database Connection 下拉功能表包含一個 Other 選項。選擇 Other 時,會出現 Connection Type 選項,要求選擇 ADO.NET 或 ODBC。
  • 如果選擇 ADO.NET,請輸入 Driver Class、Data Source、User 和 Password 詳細資訊。
  • 如果選擇 ODBC,請確保已按照以下說明建立系統 DSN,然後在 Data Source Name 中選擇它。填寫 Driver、User 和 Password 詳細資訊。

ODBC

透過 ODBC 驅動程式連線資料庫需要資料來源名稱 (DSN)。可以使用 Microsoft ODBC 管理器建立 DSN。CData 必須為 ODBC 驅動程式使用系統 DSN 連線。建立 DSN 後,在端口的 Data Source Name 下拉式清單中選擇它。 Database 端口支援預設選項之外的其他資料庫 ODBC 驅動程式。但是,自定義驅動程式可能需要覆蓋端口發出的查詢,以符合資料庫預期的語法。有關更多資訊,請參閱預處理和後處理查詢。也可以在 Select 操作中使用 Write custom queries 選項。

選擇一個操作

與 Database 建立連線後,必須選擇 Database 端口將執行的操作。下表概觀了每個操作及其在知行之橋工作流程中的位置。

進階選項卡

高階索引標籤上的許多設定都是從正在使用的資料來源動態載入的,因此本文件中未介紹這些設定。可以在我們網站的線上幫助檔案頁面上找到資料來源的詳細資訊。 下面描述的選項適用於所有資料來源。

訊息

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

進階設定

進階設定 是依賴任意資料庫驅動程式(例如 Database、CData 和 API 端口)以連線到各種資料來源的端口的通用設定。

其它

其它設定 適用於特定用例。

自動化索引標籤

自動化設定

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

效能

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

通知索引標籤

與配置通知相關的設定。 在執行服務等級協議 (SLA) 之前,需要設定電子郵件通知。預設情況下,知行之橋使用通知索引標籤上的全域設定。要為此端口使用其他設定,請啟用 覆蓋全域設定。 預設情況下,錯誤通知已啟用,這意味著每當發生錯誤時都會傳送電子郵件。要關閉它們,請取消選中 啟用 核取方塊。 輸入 主題(必填),然後可選地輸入以逗號分隔的 收件人 電子郵件清單。

SLA 索引標籤

與配置服務等級協議 (SLA) 相關的設定。 SLA 允許配置期望工作流程中的端口傳送或接收的資料量,並設定期望達到該資料量的時間範圍。當 SLA 未滿足時,知行之橋會傳送電子郵件警告使用者,並將 SLA 標記為 有風險,這意味著如果 SLA 很快仍未滿足,則會被標記為 已違反。這使使用者有機會介入並確定 SLA 未滿足的原因,並採取適當措施。如果在風險時間段結束時仍未滿足 SLA,SLA 會被標記為已違反,並再次通知使用者。 要定義 SLA,請啟用 預期資料量,然後單擊 設定 索引標籤。 空 SLA 配置
  • 如果端口具有單獨的傳送和接收操作,請使用選項按鈕指定 SLA 適用的方向。
  • 在視窗的 預計至少 部分:
    • 設定期望處理的最小交易數(數量)
    • 使用 每 欄位指定時間範圍
    • 指定 SLA 應何時生效。如果選擇 開始於,請填寫日期和時間欄位。
    • 勾選希望 SLA 生效的星期幾。如有需要,使用下拉功能表選擇 每天。
  • 在視窗的 將狀態設定為“有風險” 部分,指定何時應將 SLA 標記為有風險。
    • 預設情況下,只有違反 SLA 後才會傳送通知。若要更改此設定,請選中 傳送“有風險”通知。
以下範例顯示了為預計週一至週五每天接收 1000 個檔案的端口配置的 SLA。如果尚未收到 1000 個檔案,則會在時間段結束前 1 小時傳送風險通知。 SLA 配置範例
如有必要,可以關閉 SLA 通知。這在維護視窗期間非常有用。單擊導覽列上的 Settings,然後導航到 Alerts > General Alerts。單擊平板和鉛筆圖示進行編輯,並取消選中 SLA Alerts 設定。

宏

在檔案命名策略中使用宏可以提高組織效率和對資料的上下文理解。透過將宏合併到檔名中,可以動態包含識別碼、時間戳和訊息頭資訊等相關資訊,為每個檔案提供有價值的上下文。這有助於確保檔名反映對組織重要的詳細資訊。 知行之橋支援這些宏,它們都使用以下語法:%Macro%。

範例

某些宏(例如 %Ext% 和 %ShortDate%)不需要參數,但其他宏需要。所有帶參數的宏都使用以下語法:%Macro:argument% 以下是一些帶參數宏的範例:
  • %Header:headername%:其中 headername 是訊息上訊息頭的名稱。
  • %Header:mycustomheader% 替換為輸入訊息上設定的 mycustomheader 訊息頭的值。
  • %Header:ponum% 替換為輸入訊息上設定的 ponum 訊息頭的值。
  • %RegexFilename:pattern%:其中 pattern 是規則運算式模式。例如,%RegexFilename:^([\w][A-Za-z]+)% 會匹配並替換為檔名中的第一個單詞,且不區分大小寫(test_file.xml 替換為 test)。
  • %Vault:vaultitem%:其中 vaultitem 是保管庫中專案的名稱。例如,%Vault:companyname% 替換為保管庫中儲存的 companyname 項的值。
  • %DateFormat:format%:其中 format 是可接受的日期格式(詳見範例日期格式)。例如,%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% 替換為檔案上的日期和時間戳。
還可以建立更復雜的宏,如以下範例所示:
  • 在一個檔名中組合多個宏:%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
  • 包含宏之外的文字:MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
  • 在宏中包含文字:%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%