Identity Validation

Identity Validation 用於檢查使用者輸入的內容是否符合指定的身分識別格式。可搭配 BeforeSave 事件，在資料不符合規則時中止存檔，避免將格式錯誤的資料寫入系統。

此章節包含的主題：

Identity Validation功能說明

Identity Validation 為「輸入格式檢查」類型的驗證元件，可針對指定欄位檢查是否符合系統設定的格式規則。當輸入內容不符合規則時，可搭配 Assign Variables 將錯誤訊息寫入 Output.abortMessage，並在存檔前中止流程。

規則類型除可選擇身分證外，亦支援統一編號與信用卡等格式驗證，適合用於需檢查特定識別碼格式的欄位。

若規則類型留白，則可於規則運算式欄位自行撰寫驗證條件。系統支援微軟 .NET 的正規表示式（Regular Expression）語法，例如：^[A-Z]{1}[1-2-8-9][0-9]{8}$。

如需查看更多語法說明，可參考微軟文件：正規表示式語言快速參考。

以台灣常見的身分證字號格式為例，通常為1 個大寫英文字母搭配9 個數字；實際驗證結果仍以系統規則與您設定的條件為準。

適用時機

• 適用於表單中需檢查身分證字號、統一編號、信用卡號或其他需套用格式規則的欄位。

• 當系統需在使用者按下存檔前先確認欄位格式正確時，可搭配 BeforeSave 事件使用。

• 若內建規則無法符合需求，也可透過自訂正規表示式建立專屬的驗證條件。

• 若希望驗證失敗時直接顯示提示視窗，建議搭配 Assign Variables 將訊息指定至 Output.abortMessage。

設定方式及結果

以下畫面示範，透過資料規格的 BeforeSave 事件設定 Identity Validation。範例畫面中，檢查欄位設定為 {{$Oltp1.員工.密碼$}}，實際使用時可改為您要檢查的欄位。

1. 在「資料規格 > 資料來源 > Oltp1 > 員工 > 事件」上按右鍵，選擇 新增BeforeSave。

2. 切換至右側的流程頁籤，在左側展開「輸入格式檢查」，將 Identity Validation 拖曳至流程圖中。

3. 開啟設定視窗後，將欄位指定為 {{$Oltp1.員工.密碼$}}。

4. 在規則類型中可選擇 身分證、統一編號 或 信用卡；若留白，則可於規則運算式中自行輸入 .NET 正規表示式。

5. 本範例將規則類型設為 身分證，完成後按下確定。

6. 接著在左側展開「指定參數與控制項」，將 Assign Variables 拖曳至 Identity Validation 後方。

7. 在 Assign Variables 設定視窗中新增一筆資料，將目的設為 Output.abortMessage。

8. 再從右側展開 變數 > Identity Validation，選取 Result (Value)，並將值帶入為 $action.Identity_Validation.Results$。

9. 設定完成後按下確定，即可在驗證失敗時顯示對應的錯誤提示訊息。

10. 完成後，流程順序應為：開始 → Identity Validation → Assign Variables → 結束。

11. 回到設計畫面後，按下左上角的存檔，再點選預覽進行測試。

12. 當欄位輸入內容不符合 Identity Validation 規則時，系統將會中止存檔並顯示提示訊息；若格式正確，則可正常完成存檔。