按鈕欄位介紹¶
一、何謂「按鈕」欄位¶
按鈕欄位可用於從外部系統取得相關欄位資料，也可搭配條件設定來決定按鈕的效果。當使用者在填寫表單時，點按該按鈕即可觸發對應的動作。
組織可以依照需求來設定資料取得的邏輯，以下列舉幾個常見的應用情境：
- 取得客戶資料：根據使用者填寫的[客戶代號]取得客戶名稱來更新聯絡人的相關資料。若未輸入客戶代號，系統會提醒使用者需要先填寫代號才能進行查詢。
- 取得庫存資料：輸入[商品料號]，透過按鈕設定互動，系統會自動顯示該品項名稱、單價和庫存量。
- 取得外部資料：根據使用者填寫的[請假日期起迄]自動取的外部資料來計算剩餘可休假時數。若可休假餘額小於請假時數，則無法申請表單。
二、前置作業¶
如下圖所示，在設定 按鈕欄位 前，需要先 建立外部連線設定 與 建立外部資料來源 設定。
- STEP1 建立外部連線設定： 依照組織需要串接的需求，首先需要請 BPM管理員 協助於外部連線設定新增外部連線設定。
- STEP2 建立外部資料來源： BPM管理員 於外部資料來源將欄位所需要的外部資料來源完成設定並上架。
三、欄位介紹¶
可決定按鈕樣式¶
- 自訂按鈕名稱與顯示位置
可決定按鈕規則¶
可依照表單需求來設定按鈕規則，透過 新增動作 來設定點按後的效果或需要取得的外部資料，也可以透過 新增條件 來控管是否允許執行按鈕，以下將詳細介紹設定方式。
-
新增動作：設計按鈕點按後的效果，可透過按鈕從外部系統獲取資料並回傳到對應的欄位。
-
取值：可綁定外部資料來源至外部系統取值，並將取得的值存成 規則變數，後續即可運用在 給值 或 按鈕條件判斷 中。
-
給值：可將取值的 規則變數，回傳到指定的表單欄位，當使用者在UOF X系統填寫表單時，表單欄位的內容可以自動從外部資訊中取得。
當規則變數資料來源為 SQL外部資料 時，可指定要回傳的資料庫欄位名稱；當規則變數資料來源為 API外部資料 時，則可以指定JSONPath。
-
更新：可以指定要更新的[串外部資料]欄位(包含下拉選單/單選清單/複選清單)。
-
跳窗提示：可設定當不符合按鈕條件或填寫規則時，要提示的字詞。
-
-
新增條件：根據特定條件決定是否允許執行按鈕動作，可以選擇 表單欄位 、單據資訊、表單變數 或來自於取值的 規則變數 作為條件判斷依據來源。
取值動作中所支援表單欄位的參數來源為
1.支援[一般欄位]、[自訂欄位]：包含單行文字、多行文字、數值、日期、日期時間、單選清單、下拉選單、複選清單、欄位計算、上傳檔案、明細欄位、選擇人員、選擇部門。
2.支援[一般欄位]的文件檢視器、外掛欄位、表單變數。
給值動作中所支援表單欄位的參數來源為
1.支援[一般欄位]、[自訂欄位]：包含單行文字、多行文字、數值、日期、日期時間、單選清單、下拉選單、複選清單、欄位計算、上傳檔案、明細欄位、選擇人員、選擇部門、備註說明。
2.支援[一般欄位]的文件檢視器、外掛欄位、表單變數。
四、開始設定按鈕欄位¶
你可以根據表單需求來設計 按鈕欄位 ，以下透過一些使用情境來說明設計方式。
- 情境1：取得客戶資料
根據使用者填寫的 客戶代號 來查詢 客戶名稱 ，並更新聯絡人資料 。若未輸入客戶代號就點按查詢時，會提醒使用者需要先填寫才能進行查詢。
- 情境2：取得ERP報價單資料
依據使用者輸入的 商品料號 取得該品項的 名稱 、 單價 及 庫存量 ，並且可進一步搭配表單驗證器驗證 本次出貨量 數量足夠才允許申請表單。
- 情境3：取得可休假時數
根據使用者填寫的 請假時間起迄 自動計算 剩餘可休假時數。並且可進一步搭配表單驗證器驗證當可休假時數不足時，則無法申請表單。
五、異常處理¶
當使用者發生錯誤時，你可以根據表單的提示，找到按鈕的規則第幾項錯誤來進行修正，或者再發佈版本之前先進行 預覽 功能檢視規則是否正確。
