自動ルックアッププラグイン（無料）
レコード追加画面・編集画面を開いたとき、設定画面で選んだルックアップフィールドを自動的に再取得 (再ルックアップ)します。発動タイミング(追加画面表示時/編集画面表示時)は、フィールド (またはサブテーブル)ごとに個別に選べます。サブテーブルを対象に選ぶと、そのサブテーブル内の ルックアップ列すべてについて、全行分を自動ルックアップします。参照先の情報が更新された後も、 レコードを開き直すだけで最新の値に揃えられます。
こんな方におすすめ
- kintoneでルックアップ先の情報が更新されたら自動で反映したい
- 「kintone ルックアップ 自動更新」を探している
- 編集のたびに手動で再ルックアップするのが面倒
- サブテーブル内のルックアップも自動更新したい
紹介動画
ユースケース
取引先マスタの住所や単価が更新された後、既存のレコードのルックアップフィールドはそのままでは古い値のままです。本プラグインを設定しておけば、レコード編集画面を開くだけで自動的に再ルックアップが実行され、最新の値に更新されます。
明細サブテーブルの各行に商品マスタへのルックアップ列がある場合、対象にサブテーブルを選択しておけば、行数に関わらず全行分のルックアップ列がまとめて再取得されます。行ごとに手動で再ルックアップを操作する手間がありません。
セットアップ手順
- 対象のアプリに、あらかじめルックアップフィールド(またはルックアップ列を含むサブテーブル)を設定しておく。
- プラグインをアプリに追加し、設定画面を開く。
- 自動的に再取得したいルックアップフィールド、またはルックアップ列を含むサブテーブルごとに、発動タイミング(追加画面表示時/編集画面表示時、両方選択も可)にチェックを付けて保存する。どちらも選ばなかったフィールドは対象外になる。
- 保存後、アプリを更新する(kintoneのアプリ設定は保存しただけでは反映されず、更新〈デプロイ〉して初めてレコード画面に反映されます)。
kintone標準の仕様上、レコードを保存するとき(submit)には自動取得が発動できないため、発動タイミングは「表示したとき」のみ選べます。また、参照先で一致するレコードが複数件ある場合は、kintone標準の仕様により自動実行されません(その場合はユーザーが手動で選択してください)。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- 再ルックアップの実行はkintone標準のJavaScript API(イベントオブジェクトのフィールドの
lookupプロパティにtrueをセットしてreturnする仕組み)のみで行っており、本プラグイン自身が参照先アプリへの通信を組み立てることはありません。外部サーバーへの通信・外部ライブラリも一切使用していません。 - 本プラグインはDOMへの描画を伴わない(フィールドの
lookupプロパティを設定するのみ)ため、XSSのリスクとなる文字列描画箇所がありません。設定画面のエラーメッセージ等の描画はtextContentのみを使用しています。 - 設定に含まれる対象フィールドが実際のフォームに存在しない場合(フィールド削除・設定の食い違い等)は該当フィールドをスキップし、画面をクラッシュさせません。
- ルックアップフィールドの再取得は、ログインユーザーが参照先アプリのレコードを閲覧できる権限を持っている場合のみ正しく動作します(kintone標準のルックアップフィールドの権限モデルに準拠、本プラグインが独自の権限チェックを行うわけではありません)。
- 参照先で複数件が一致する場合は自動実行されません(kintone標準の制約)。本プラグインがこの制約を回避したり、任意のレコードを推測で選択したりすることは一切ありません。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
このプラグインはREST APIを一切実行しません。フィールド一覧の取得は
kintone.app.getFormFields()、再ルックアップの指示はイベントオブジェクトの
lookupプロパティ経由のJavaScript APIのみで完結し、API実行数制限に影響することは
ありません(再ルックアップ自体の実行はkintone本体が内部的に行います)。