輸入檢查外掛

前言

kintone 是一個能輕鬆建構商用應用程式的優秀平台，但也有一些情況是標準功能無法完全因應的。 其中**輸入資料的驗證（輸入檢查）**對於維持資料品質格外重要，然而 kintone 標準功能所能設定的規則相當有限。

因此，我們開發了能實現更細緻驗證的**「輸入檢查外掛」**。 使用本外掛，即可大幅強化 kintone 的輸入檢查功能，收集到更準確的資料。

kintone 標準輸入檢查的課題

kintone 標準功能所能設定的輸入檢查，有以下限制：

• 只能設定「必填」，無法指定更詳細的條件
• 無法檢查電話號碼或郵遞區號等格式
• 無法限制字元種類，例如僅限平假名或片假名
• 無法使用正規表示式進行進階的模式比對

使用「輸入檢查外掛」，即可解決這些課題，事先預防資料輸入的錯誤。

🎯 外掛可以做到的事

1. 豐富的驗證規則

20 種以上的驗證規則皆可免寫程式進行設定。

📝 基本檢查

• 必填檢查 － 設定必須輸入的欄位

📏 字數檢查

• 最小字數 － 指定「5 個字以上」等最低字數
• 最大字數 － 設定「100 個字以內」等上限
• 精確字數 － 指定「剛好 7 位數」等固定長度

🔢 數值檢查

• 最小值、最大值 － 限制數值範圍
• 數值範圍檢查 － 指定「介於 0～100 之間」等範圍

📧 格式檢查

• 電子郵件格式 － 檢查是否為正確的郵件格式
• URL 格式 － 檢查是否為有效的 URL 格式
• 電話號碼格式（日本） － 支援日本的電話號碼格式
• 郵遞區號格式（日本） － 檢查「123-4567」格式

🔤 字元種類檢查

• 僅限英數字 － 只允許半形英數字
• 僅限數字 － 只允許半形數字
• 僅限英文字母 － 只允許半形英文字母
• 僅限平假名 － 只允許平假名（最適合用於假名讀音輸入）
• 僅限片假名 － 只允許片假名

🔍 字串檢查

• 包含／不包含特定字串 － 檢查必要關鍵字或禁用詞
• 以特定字串開頭／結尾 － 檢查前綴與後綴

🛠 自訂檢查

• 正規表示式模式 － 以自訂模式進行進階檢查

2. 彈性的套用設定

依畫面分別設定

可選擇要套用驗證的畫面：

• 僅記錄新增畫面 － 只在新建時檢查
• 僅記錄編輯畫面 － 只在編輯時檢查
• 兩者皆是 － 在所有畫面都進行檢查

錯誤顯示時機

• 欄位變更後立即顯示 － 即時顯示錯誤
• 僅在儲存時 － 按下送出按鈕時一併檢查

3. 組合多項規則

您可以為同一個欄位設定多項驗證規則。

例如針對「電話號碼」欄位：

1. 必填
2. 電話號碼格式檢查

像這樣組合多項條件，即可進行更嚴謹的資料品質管理。

4. 條件式驗證

本外掛搭載了**「條件式驗證」**功能，只有當特定欄位的值滿足條件時，才會對另一個欄位套用驗證。

什麼情況下派得上用場？

例如可以因應以下情境：

• 只有當「付款方式」為「信用卡」時，才將「卡號」欄位設為必填
• 只有當「國籍」為「日本」時，才以日本格式檢查「郵遞區號」
• 只有當「合約類型」為「法人」時，才檢查「法人編號」的格式

條件的運作方式

只要指定條件欄位的值即可完成設定。

• 條件欄位 － 要以哪個欄位作為判斷依據
• 條件的值 － 在哪個值的情況下生效
• 目標欄位 － 條件成立時要檢查的欄位
• 驗證規則 － 與一般規則相同，可從 20 種以上的規則中選擇

若未設定條件，則與過去一樣永遠套用驗證。條件式驗證與一般驗證也可以搭配使用。

✨ 好用的設定畫面

外掛的設定畫面採用對 kintone 管理者也十分友善的直覺式 UI設計。

簡單的 3 步驟設定

1. 選擇目標欄位 － 只需從下拉式選單挑選欄位
2. 選擇套用畫面 － 用核取方塊輕鬆設定
3. 新增規則 － 透過「＋新增規則」按鈕加入規則

視覺化的規則管理

• 每項規則皆以卡片形式顯示，一眼就能確認設定內容
• 規則的新增、刪除與編輯只需一次點擊即可完成
• 已備有預設的錯誤訊息，可立即開始使用
• 當然也可以自訂錯誤訊息

多組條件的管理

針對多個欄位的設定，可透過側邊欄一覽管理。設定的新增、切換與刪除也都能直覺地操作。

🔒 開源，安全令人安心

本外掛以開源方式公開。

開源的優點

1. 透明性 － 由於原始碼公開，可自行確認外掛的運作內容
2. 可自訂 － 可依需求修改原始碼後使用
3. 持續性 － 不依賴特定廠商

可安心使用的理由

• 遵循 kintone 官方的外掛開發指南
• 採用 TypeScript 進行型別安全的實作
• 定期更新與維護

💡 應用情境

客戶管理應用程式

• 電話號碼與電子郵件的格式檢查
• 郵遞區號的格式檢查
• 客戶姓名的假名讀音（平假名）檢查

商品管理應用程式

• 商品代碼的字數與格式檢查
• 價格的範圍檢查
• 防止必填項目漏填

申請與工作流程應用程式

• 統一申請編號的格式
• 檢查必要的附件
• 檢查金額上限

條件式驗證的應用範例

• 訂單管理應用程式 － 只有選擇「海外配送」時，才檢查「國際郵遞區號」的格式
• 招募管理應用程式 － 只有「應屆畢業招募」時，才將「畢業年度」設為必填
• 合約管理應用程式 － 只有「法人」合約時，才檢查「法人編號（13 位數）」的位數

總結

「輸入檢查外掛」能大幅擴充 kintone 的輸入檢查功能，協助您收集到更準確的資料。

✅ 20 種以上豐富的驗證規則
✅ 透過條件式驗證，實現因情境而異的彈性輸入檢查
✅ 直覺好用的設定畫面
✅ 開源，安全令人安心
✅ 免費使用

提升資料品質，是業務效率化的第一步。歡迎導入「輸入檢查外掛」，讓您的 kintone 更加便利！