サブテーブルルックアッププラグイン
サブテーブルの中から条件に一致する1行を探し、その行の複数フィールド(列)の値を、テーブル外の フィールドへ保存時(submit時)に自動入力します。点検履歴などをサブテーブルで管理し、「最新の点検結果」 「最終点検日」「特定条件に合う行の値」をテーブル外のフィールドへ反映する用途を想定しています。
ユースケース
設備の点検履歴をサブテーブルで管理しているアプリで、検索モードを「最新」にして点検日列を指定すると、点検日が最も新しい行の結果・点検日をテーブル外のフィールドへ自動反映できます。一覧画面やカスタマイズビューで「現在の状態」をひと目で確認できるようになります。
点検日が同値の行が複数ある場合は、検索方向(上から/下から)で採用する行を決められます。「下から」を選べば、同日内で最後に入力された行が採用されます。
「区分」列が「異常」と完全一致する行を探し、その対応内容を別フィールドへ転記する、といった使い方ができます。一致する行がない場合、出力先フィールドは常に空文字列でクリアされるため、古い値が残ったままになる事故を防げます。
セットアップ手順
- アプリのフォームに、ルックアップ結果を格納する出力先フィールド(テーブル外)を配置する。
- プラグインをアプリに追加し、設定画面を開く。
- 「+ 設定行を追加」で対象サブテーブル・検索モード(部分一致/完全一致/最新/最古/一番上の行/一番下の行)を選択する。モードに応じて検索対象列・一致させる値・検索方向の入力欄が切り替わる。
- 「+ マッピングを追加」で、サブテーブル列 → 出力先フィールドの対応を必要な数だけ追加して保存する。
出力先フィールドはプラグインが常に上書きします(一致行がない場合は空文字列でクリア)。手入力欄としては使えません。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- フィールド一覧・エラーメッセージの描画はすべて
textContentまたはcreateElementで行っており、innerHTMLへの外部由来文字列の差し込みはありません。 - 「一致させる値」は設定画面でアプリ管理者が入力する文字列で、比較処理(
String#includes/===)にのみ使われ、DOMへ描画されることはありません。 - REST API・外部サーバー通信は一切行わず、外部ライブラリも使用していません。
- 保存前のバリデーションで、対象サブテーブル未選択、モードに応じて必須の項目の未入力、フィールドマッピング0件、出力先フィールドの重複などを検出し、不正な設定は保存させません。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
このプラグインはREST APIを一切実行しません。フィールド情報の取得はkintone.app.getFormFields()のみで行い、
検索・転記処理はsubmitイベント内のローカルな処理のみで完結します。API実行数制限に影響することはありません。