RIGHT・LEFT・MID関数プラグイン
Excel等の表計算ソフトにあるLEFT・RIGHT・MID関数のような文字列の
部分取得を、kintoneの基本機能にない形で行います。元の文字列フィールドから指定した位置・文字数の
部分文字列を取り出し、保存時(submit時)に出力先フィールドへ格納します。
文字列処理
#文字列抽出
#自動入力
ダウンロード(v0.1.0)
ユースケース
「品番の先頭3文字が事業部コード」「社員番号の末尾2桁が拠点コード」のように、固定長コードの一部だけを別フィールドに取り出したい場合に使えます。LEFTで先頭n文字、RIGHTで末尾n文字を取得できます。
MID関数を使うと、「4文字目から3文字」のように途中の位置から部分文字列を取得できます。開始位置・文字数はExcelと同じく1文字目を1とする数え方です。
同じ元フィールドに対して複数のルールを設定できるため、1つのコード文字列から「先頭2文字」「3〜5文字目」「末尾1文字」のようにそれぞれ別のフィールドへ分解して格納することもできます。
セットアップ手順
- アプリのフォームに、取り出した部分文字列を格納する出力先フィールドを配置する。
- プラグインをアプリに追加し、設定画面を開く。
- 「+ ルールを追加」で、元フィールド・関数(LEFT/RIGHT/MID)・パラメータ(文字数、MIDの場合は開始位置も)・出力先フィールドを設定して保存する。
- 保存すると、追加・編集画面で出力先フィールドが編集不可(disabled)になり、レコード一覧のインライン編集では元フィールドが編集不可になる。
指定した文字数が元の文字列より長い場合はエラーにならず、存在する分だけを返します(Excelと同じ挙動)。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- フィールド一覧・エラーメッセージの描画はすべて
textContentまたはcreateElementで行っており、innerHTMLへの外部由来文字列の差し込みはありません。 - REST API・外部サーバー通信は一切行わず、外部ライブラリも使用していません(標準の
String.prototype.slice()のみ使用)。 - 保存前のバリデーションで、開始位置・文字数が1以上の整数でない、出力先フィールド未選択・重複、元フィールドと出力先フィールドの重複などを検出し、不正な設定は保存させません。
- 出力先フィールドの編集禁止(disabled化)はUI上の制約であり、REST API等を直接使った書き換えまでは防げない点を明記しています。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
このプラグインはREST APIを一切実行しません。フィールド情報の取得はkintone.app.getFormFields()のみで行い、
切り出し処理はsubmitイベント内のローカルな文字列処理のみで完結します。API実行数制限に影響することはありません。