跳轉到主要內容
Kintone 端口可透過推送或拉取 Kintone 資料,將 Kintone 整合到您的資料流中。

核心功能

  • 整合雲端業務應用平臺,用於自定義應用程式資料管理
  • 靈活的身分驗證選項,包括密碼、API 權杖(Token)或 OAuth
  • 標準資料庫操作(Select、Lookup、Upsert 和預存程序),用於資料操作
請按照以下步驟將 知行之橋 連線至 Kintone。

建立連線

要建立與 Kintone 的連線,請使用以下兩種方法之一:
  • 將 Kintone 端口新增到流中。然後,在設定索引標籤上,單擊連線下拉式清單旁邊的新增。
  • 開啟 知行之橋 設定頁面,然後開啟連線索引標籤。單擊新增,選擇 Kintone,然後單擊下一步。
  • 登入流程僅在首次建立連線時需要。
  • 與 Kintone 的連線可在多個 Kintone 端口中重複使用。

輸入連線設定

  1. 輸入連線資訊:
    • 名稱:連線的靜態名稱,可根據需要設定。
    • 型別:始終設定為 Kintone。
    • 連線:用於連線的身分驗證方案。選項為密碼、API 權杖和 OAuth。
    • URL:您要連線的 Kintone 站點的 URL。
  2. 輸入所選身分驗證方案的連線資訊:
  3. 在端口配置面板的連線下拉式清單中選擇新增的連線。

密碼

  1. 在使用者名稱欄位中,輸入用於登入的使用者名稱。
  2. 在密碼欄位中,輸入該使用者的密碼。
  3. 如有需要,單擊進階開啟進階連線設定功能表。大多數情況下無需使用。
  4. 單擊測試連線,確認 知行之橋 可使用提供的資訊連線至 Kintone。如果發生錯誤,請檢查所有欄位並重試。
  5. 單擊新增連線完成連線設定。

API 權杖

  1. 在 ApiToken 欄位中,提供用於身分驗證的 API 權杖。
  2. 如有需要,單擊進階開啟進階連線設定功能表。大多數情況下無需使用。
  3. 單擊測試連線,確認 知行之橋 可使用提供的資訊連線至 Kintone。如果發生錯誤,請檢查所有欄位並重試。
  4. 單擊新增連線完成連線設定。

OAuth

  1. 在 OAuth Client Id 欄位中,輸入您帳戶的用戶端 ID。
  2. 在 OAuth Client Secret 欄位中,輸入您帳戶的用戶端金鑰。
  3. 如有需要,單擊進階開啟進階連線設定功能表。大多數情況下無需使用。
  4. 單擊連線。
  5. 在開啟的新標籤頁中,登入您的 Kintone 帳戶。如有提示,請授予存取權限。
  6. 傳回 知行之橋。
    • 若連線成功,單擊新增連線。
    • 若連線失敗,請檢查您的 URL 和登入憑據,然後重試。
進階索引標籤上還有特定於資料來源的身分驗證和配置選項。本文件未完整記錄這些選項,但您可以在 我們網站的 線上幫助檔案 頁面上找到資料來源的詳細資訊。

選擇操作

建立與 Kintone 的連線後,您必須選擇 Kintone 端口要執行的操作。下表列出了每種操作及其在 知行之橋 流中的位置。

進階選項卡

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

訊息

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

AI

進階設定

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

雜項

_雜項設定_用於特定使用場景。

自動化索引標籤

自動化設定

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

自動化狀態

效能

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

警示索引標籤

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

SLA 索引標籤

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

宏

在檔案命名策略中使用宏可以提高組織效率和對資料的上下文理解。透過在檔名中加入宏,您可以動態地包含識別碼、時間戳和標頭資訊等相關資訊,為每個檔案提供有價值的上下文。這有助於確保檔名反映對您的組織重要的詳情。 知行之橋 支援以下宏,所有宏均使用以下語法:%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%