Email Validation 用於檢查使用者輸入的內容是否符合電子郵件格式,例如 name@example.com。可搭配 BeforeSave 事件,在資料不符合規則時中止存檔,避免將錯誤的電子郵件格式寫入系統。

此章節包含的主題:
Email Validation 為「輸入格式檢查」類型的驗證元件,可針對指定欄位檢查是否符合電子郵件格式。當輸入內容不符合規則時,可搭配 Assign Variables 將錯誤訊息寫入 Output.abortMessage,並於存檔前中止流程。
常見用途包含:
檢查會員、員工或聯絡人資料中的電子郵件欄位格式。
避免使用者輸入缺少 @ 或網域格式錯誤的電子郵件地址。
在使用者按下存檔前先執行格式驗證。
搭配 Output.abortMessage 顯示明確的驗證失敗提示訊息。
適用於表單中需輸入電子郵件的欄位,例如註冊、報名、員工資料或客戶聯絡資料維護畫面。
當系統需在使用者按下存檔前先確認欄位格式正確時,可搭配 BeforeSave 事件使用。
若希望驗證失敗時直接顯示提示視窗,建議搭配 Assign Variables 將訊息指定至 Output.abortMessage。
以下以「員工資料中的電子郵件欄位需符合 Email 格式」為例,示範如何在資料規格的 BeforeSave 事件中設定 Email Validation。
在「資料規格 > 資料來源 > Oltp1 > 員工 > 事件」上按右鍵,選擇 新增BeforeSave。

切換至右側的流程頁籤,在左側展開「輸入格式檢查」,將 Email Validation 拖曳至流程圖中。
開啟設定視窗後,將欄位指定為 {{$Oltp1.員工.電子郵件$}}。
規則類型請選擇 Email;系統會自動帶入對應的規則運算式,通常不需另外修改,最後按下確定。
接著在左側展開「指定參數與控制項」,將 Assign Variables 拖曳至 Email Validation 後方。
在 Assign Variables 設定視窗中新增一筆資料,將目的設為 Output.abortMessage。
再從右側展開 變數 > Email Validation,選取 Result (Value),並將值帶入為 $action.Email_Validation.Result$。
設定完成後按下確定,即可在驗證失敗時顯示對應的錯誤提示訊息。
完成後,流程順序應為:開始 → Email Validation → Assign Variables → 結束。
回到設計畫面後,按下左上角的存檔,再點選預覽進行測試。

執行時,當欄位輸入內容不符合 Email Validation 規則時,系統將會中止存檔並顯示提示訊息;若格式正確,則可正常完成存檔。