Cellphone Validation 用於檢查使用者輸入的內容是否符合手機號碼格式。可搭配 BeforeSave 事件,在資料不符合規則時中止存檔,避免將格式錯誤的手機號碼寫入系統。

此章節包含的主題:
Cellphone Validation 為「輸入格式檢查」類型的驗證元件,可針對指定欄位檢查是否符合手機號碼格式。當輸入內容不符合規則時,可搭配 Assign Variables 將錯誤訊息寫入 Output.abortMessage,並在存檔前中止流程。
依最新畫面所示,規則類型可選擇台灣手機格式,規則為需以 09 開頭,後續再接 8 碼數字,例如:0912345678。
選擇對應規則後,系統會自動帶入規則運算式,本範例為 ^09[0-9]{8}$。
適用於表單中需檢查手機號碼格式的欄位。
適用於會員註冊、報名、員工資料維護、聯絡資訊建檔等需輸入手機號碼的畫面。
當系統需在使用者按下存檔前先確認手機格式正確時,可搭配 BeforeSave 事件使用。
若希望驗證失敗時直接顯示提示視窗,建議搭配 Assign Variables 將訊息指定至 Output.abortMessage。
以下畫面示範,透過資料規格的 BeforeSave 事件設定 Cellphone Validation。範例畫面中,檢查欄位設定為 {{$Oltp1.員工.電話號碼$}}。
在「資料規格 > 資料來源 > Oltp1 > 員工 > 事件」上按右鍵,選擇 新增BeforeSave。

切換至右側的流程頁籤,在左側展開「輸入格式檢查」,將 Cellphone Validation 拖曳至流程圖中。
開啟設定視窗後,將欄位指定為 {{$Oltp1.員工.電話號碼$}}。
在規則類型中選擇台灣手機格式(09xxxxxxxx,需以 09 開頭並接續 8 碼數字),系統會自動帶入對應的規則運算式 ^09[0-9]{8}$,完成後按下確定。
接著在左側展開「指定參數與控制項」,將 Assign Variables 拖曳至 Cellphone Validation 後方。
在 Assign Variables 設定視窗中新增一筆資料,將目的設為 Output.abortMessage。
再從右側展開 變數 > Cellphone Validation,選取 Result (Value),並將值帶入為 $action.Cellphone_Validation.Result$。
設定完成後按下確定,即可在驗證失敗時顯示對應的錯誤提示訊息。
完成後,流程順序應為:開始 → Cellphone Validation → Assign Variables → 結束。
回到設計畫面後,按下左上角的存檔,再點選預覽進行測試。

當欄位輸入內容不符合 Cellphone Validation 規則時,系統將會中止存檔並顯示提示訊息;若符合設定條件,則可正常完成存檔。