スプリットプラグイン
元の文字列フィールドの値を、指定した記号・文字(複数指定可)または正規表現で分割し、保存時(submit時)に 複数の出力先フィールドへ先頭から順番に格納します。分割結果が出力先フィールドより少ない場合は余った フィールドを空にし、多い場合ははみ出した分を切り捨てます。
ユースケース
「東京都〇〇区△△1-2-3」のような住所文字列を「-」や全角スペースなど複数の記号で分割し、町名・番地・号を別々のフィールドに格納できます。区切り文字は複数登録できるので、表記ゆれ(全角/半角ハイフンなど)にもまとめて対応できます。
区切りモードを「正規表現」に切り替えると、[-/\s]+のようなパターンで「ハイフン・スラッシュ・空白のいずれか1文字以上」をまとめて区切り文字として扱えます。記号・文字モードで1つずつ列挙するより設定が簡潔になります。
全角スペース区切りで入力された氏名フィールドを、姓・名の2フィールドに分割します。出力先フィールドを2つだけ設定すれば、3つ目以降の分割結果(ミドルネーム等)は自動的に切り捨てられます。
セットアップ手順
- アプリのフォームに、分割結果を格納する出力先フィールド(必要な個数分の文字列フィールド)を配置する。
- プラグインをアプリに追加し、設定画面を開く。
- 「+ 設定行を追加」で、元フィールド・区切りモード(記号/正規表現)・区切り指定・出力先フィールドの並びを設定して保存する。
- 保存すると、追加・編集画面で出力先フィールドが編集不可(disabled)になり、レコード一覧のインライン編集では元フィールドが編集不可になる。
分割処理は保存(submit)時にのみ実行されます。入力中のリアルタイムプレビューはありません。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- 区切り文字を正規表現に変換する際は特殊文字を必ずエスケープしており、「.」や「*」を区切り文字に指定しても意図しない誤マッチが起きません。
- 正規表現パターンはアプリ管理者(設定画面を操作できる権限者)のみが入力するため、一般利用者からの入力による正規表現インジェクションのリスクはありません。
- フィールド一覧・エラーメッセージの描画はすべて
textContentまたはcreateElementで行っており、innerHTMLへの外部由来文字列の差し込みはありません。 - REST API・外部サーバー通信は一切行わず、外部ライブラリも使用していません。
- 出力先フィールドの編集禁止(disabled化)はUI上の制約であり、REST API等を直接使った書き換えまでは防げない点を明記しています。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
このプラグインはREST APIを一切実行しません。フィールド情報の取得はkintone.app.getFormFields()のみで行い、
分割処理はsubmitイベント内のローカルな文字列処理のみで完結します。API実行数制限に影響することはありません。