1.概述
1.1 版本
| 報表伺服器版本 | 功能變動 |
|---|---|
| 11.0.2 | 【允許自訂值】校驗項邏輯優化， Excel 匯入、值通過公式計算所得等場景下也能觸發校驗。 |
| 11.0.9 | 文字元件校驗國際化插件版本內建，之前版本仍需下載插件，詳情見1.3及2。 |
1.2 應用場景
填報元件是可以設定校驗規則的，使用者在元件中錄入的內容如果不滿足規則，會彈出校驗出錯的提示資訊。
如下圖是正文元件設定了手機號校驗，如果填寫的內容不滿足手機號格式，那麼校驗不予通過，如下圖所示。
對於滿足手機號格式的內容，在確認後校驗予以通過。
1.3 功能入口
不是所有元件都能設定校驗，只有部分元件在屬性面板下會有校驗設定項，如下圖所示。
11.0.9之前（未安裝文字元件校驗國際化插件）
11.0.9（及11.0.9之前安裝了文字元件校驗國際化插件）
2.校驗規則
| 校驗規則 | 規則說明 | 圖示 | 支援的元件 |
|---|---|---|---|
| 允許爲空 | 是否允許元件內容為空 支援自訂錯誤提示 | | 文字元件 文字域元件 數字元件 密碼元件 單選按鈕組元件 複選按鈕組元件 下拉框元件 下拉複選框元件 日期元件 檔案元件 列儲存格件 下拉樹元件 檢視表樹元件 |
| 長度 | 可以限制正文的字數 可以設定最小和最大字數 支援自訂錯誤提示 |
| 文字元件 文字域元件 密碼元件 |
| 郵件 | 填寫內容必須是郵件格式 支援自訂錯誤提示 |
| 文字元件 |
| 身分證 | 填寫內容必須是身分證格式 支援自訂錯誤提示 |
| 文字元件 |
| 郵派區號 | 填寫內容必須是郵派區號格式 支援自訂錯誤提示 |
| 文字元件 |
| 電話 | 填寫內容必須是電話格式 可以選擇電話的資料型別 支援自訂錯誤提 |
| 文字元件 |
| 手機 | 填寫內容必須是手機格式 支援自訂錯誤提示 |
| 文字元件 |
| 自訂 | 使用正則表式自訂規則 詳細介紹參見：正則表式定義規則 支援自訂錯誤提示 |
| 文字域元件 密碼元件 |
| 允許小數 | 是否允許數字帶小數 可以設定最多的小數位數 |
| 數字元件 |
| 允許負數 | 是否允許數字為負數 |
| 數字元件 |
需要最大值 需要最小值 | 將數字限定在某個範圍內 可以設定最大數和最小數 支援自訂錯誤提示 |
| 數字元件 |
| 允許直接編輯 | 下拉框內能否直接填寫內容 | | 下拉框元件 下拉複選框元件 日期元件 下拉樹元件 |
| 允許自訂值 | 元件儲存格中能否輸入不在下拉選單選項中的值。不能輸入時，若直接在元件所在的儲存格中填寫內容，當填入值不包含在下拉選單選項中，下拉框會自動清除輸入值，並會彈出提示框【值不在下拉欄表內】；
11.0.2 及之後不通過直接填寫，如 Excel 匯入、值通過公式計算所得、從Excel 中複制貼補、值通過JS 給儲存格指派所得也會觸發校驗，【提交】和【資料校驗】時若不滿 足則彈窗提醒【不允許自訂值】。
| | 下拉框元件 下拉複選框元件 下拉樹元件 |
特殊 （文字元件校驗國際化插件） | 11.0.9之前版本若需使用此功能，請安裝正文元件校驗國際化插件。 點選下載：文字元件校驗國際化插件 11.0.9版本此功能已內建，可直接使用。 注：此功能支援的區域有中國大陸、中國台灣、美國、日本、南韓，不同區域支援驗證的資料型別可能不同，中國大陸、中國台灣和南韓支援驗證手機、身分證、郵遞區號；美國支援驗證手機、郵遞區號、社會安全碼；日本支援驗證手機、郵遞區號。 以往的文字元件的內建校驗規則僅支援中國大陸的郵遞區號、身分證、手機等，而臺灣在地的特有資料校驗則需要寫正則運算式來實現。 文字元件校驗規則增強插件可以支援校驗臺灣在地的身分證、手機、郵遞區號，無需再設定正則運算式。 | | 文字元件 |
3. 行動端
3.1 單個元件校驗
當設定了元件填寫規則，如下圖所示：
在填報時，元件會進行失焦校驗。當不符合規則則元件標紅，出現錯誤提示。如下圖所示：
3.2 整體校驗
行動端元件在校驗設定不允許為空時。
報錯會提示有「校驗失敗」且校驗失敗的元件標紅，預設報錯提示為「錯誤的輸入值」。如下圖所示：
如果設定了錯誤提示。
效果如下圖所示：
4.注意事項
1）填寫不符合校驗條件的資料後，元件會自動傳回上一次填寫的內容。
2）填報提交時，也會根據元件的校驗條件來檢查提交資料。
3）Excel 匯入時不會觸發元件自身設定的校驗，11.0.2 及之後會觸發【允許自訂值】的校驗。
4）行動端也是支援元件校驗的，效果如下圖所示。
