外部程式站點
一、何謂「外部程式站點」¶
在介紹「外部程式站點」之前,讓我們先回顧一下 外部資料來源 的用途;外部資料來源應用於將外部系統的資料與UOF X進行整合或數據交換,以達到不同系統之間的資料交流。可以將資料寫入外部系統中或是透過表單欄位串接外部系統資料,將取得的資料顯示於表單欄位中。
外部程式站點 應用於串接外部系統,以達到不同系統之間的資料傳遞,例如:當員工提請假申請單後,外部程式站點可以將申請資料傳送到HR系統,以同步更新員工的請假紀錄。
二、外部程式站點設定程序¶
若你的組織需要使用外部程式站點時,這些步驟將幫助你逐步理解Plugin管理的設定程序:
- 購買異質串接服務授權:如果你的組織需要使用外部程式站點功能,可以額外購買異質串接服務授權,即可實現外部程式站點所需的相關功能和權限。
- 建立外部連線設定:工作流程管理員可以設定想要串接的外部資料庫管理系統或API管理系統,透過這些設定UOF X系統就能夠與外部系統建立連線。
- 設定外部資料來源:工作流程管理員可以根據組織要串接的商業邏輯設定在外部資料來源主檔中。
- 在表單流程中設定外部程式站點:表單設計者可以在流程設計中,根據組織的商業邏輯,在流程中加入外部程式站點。
三、如何套用外部程式站點¶
當設定好 外部資料來源 後,表單設計者 可以在流程設計中,根據組織的商業邏輯,在流程中加入 外部程式站點,並且依序填完成以下設定:
Step1:選擇資料來源¶
選擇要套用的外部資料來源主檔,在設定時,你可以清楚識別SQL資料來源或API資料來源,也可以點按
按鈕,來檢視此資料來源的主檔設定值。

Step2:將參數傳至外部系統¶
支援在 結案前/結案後流程 設定外部程式站點,將{表單資料}傳出至外部。
- 支援[一般欄位]、[自訂欄位]:包含單行文字、多行文字、數值、日期、日期時間、單選清單、下拉選單、複選清單、欄位計算、上傳檔案、明細欄位、選擇人員、選擇部門。
- 支援文件檢視器、外掛欄位、表單變數。

Step3:將回傳值寫回¶
- 不設定:你不需要將回傳值寫入表單中的情境下,可以選擇 不設定 任何值,如此一來,從外部系統取得的資料將不會寫入表單中。
-
回傳值寫回方式:需根據不同類型的資料來源(SQL、API),需填寫對應所需要的資料
- 寫回 表單變數 :你可以在 結案前/結案後流程 將外部系統回傳的資料儲存在表單變數中,這樣可以在後續的流程中,將使用表單變數的資料進行相關操作寫回至表單內。

結案前流程 - 允許回寫多筆表單變數 
結案後流程 - 允許回寫多筆表單變數 - 寫回 [一般欄位]、[自訂欄位]:你可以在 結案前流程 設定外部程式站點,將{外部資料}寫回表單中的[一般欄位]、[自訂欄位]。
- 包含單行文字、多行文字、數值欄位、日期、日期時間、複選清單、單選清單、下拉清單、選擇人員、選擇部門、備註說明(可當lable使用)
- 支援{單選/複選}選項啟用[文字填答]、{其他}選項的後方文字填答內容

允許回寫表單欄位 - API 設定畫面 
允許回寫表單欄位 - SQL 設定畫面 - 寫回 [外掛欄位]:你可以在 結案前流程 設定外部程式站點,將{外部資料}寫回表單中的[外掛欄位]。

允許回寫外掛欄位 - API 設定畫面 -
完成回傳值寫回的設定後,你可以在畫面檢視所設定的資料

提醒
當流程加入外部程式站點,按下儲存後,就立即脫離此外部資料來源主檔,這意味著在此流程站點不再受到外部資料來源主檔變更或修改的影響,而是獨立存在於該表單流程的站點中,該外部程式站點將按照當下所儲存的外部資料來源設定來進行作業。

