ルックアップの動的絞り込み表示ができるプラグイン

フォーム内のフィールド値でルックアップの一覧表示を絞り込み表示します

ルックアップ利用者のよくあるお悩み

kintoneのルックアップは便利な機能ですが、「ルックアップの一覧表から目的のデータを探すのが大変だ」と感じたことはありませんか？
標準機能のルックアップは「フォーム上の他のフィールドで”東京都”を指定したら、ルックアップ元のデータを“東京都”で絞り込んで表示して欲しい」という動的な制御には対応していません。

この課題を解決するために当社が開発したのが、Lookup Filter（ルックアップ・フィルター）プラグインです。
この記事では、このプラグインがどのように業務を効率化し、kintoneの操作性を向上させるのか、その内容をご紹介します。

デモ画面

---

このプラグインで解決できること

kintoneが導入されているる多くの企業で、データ量が増えるにつれて「ルックアップの不便さ」が浮き彫りになってきます。具体的には、以下のような課題です。

膨大なデータの検索ストレス

マスタアプリに大量のデータがある場合、標準のルックアップ画面から目的の1行を探し出すのはストレスが発生します。
例えば、商品マスタを「分類記号で絞り込んでルックアップで表示したい」場合でも、標準機能では、ルックアップ画面から手動でフィルター検索の操作を行う必要があるので手間と時間がかかります。

入力ミスの発生

例えば、「会社名」を選択した後に「案件名」をルックアップする場合、その会社に関係のない案件まで表示されてしまうと、誤って別の会社の案件を紐付けてしまうリスクがあります。データの正確性が損なわれると、後の集計や分析に悪影響を及ぼします。

業務スピードの低下

「一度マスタを確認してから、その情報を元にルックアップする」といった二度手間が発生していませんか？
動的な絞り込みができないことで、ユーザーは常に「正しいデータはどれか」を確認する手間を強いられ、本来の業務に集中できなくなります。

本プラグイン（Lookup Filtering）は、これらの「探す手間」「選ぶミス」「確認の無駄」をすべて解消します。

---

本プラグインの特徴（利用者向け）

利用者（現場の入力担当者）にとって、本プラグインは「直感的で迷わない」操作環境を提供します。

① 他フィールドの値でルックアップを絞り込み表示

ルックアップ参照元のフィールドと自アプリのフィールドを条件比較して絞り込み表示できます。
例えばルックアップ参照元の「担当者名」フィールドを絞り込み条件に設定すれば、レコード新規登録や編集画面で「担当者」を選んでからルックアップすると、担当者名で絞り込まれた一覧のダイアログが表示されます。

② 見やすいカスタムモーダルウィンドウ

標準のルックアップ画面よりもスリムで、視認性の高いテーブル形式のダイアログが開きます。

• 設定されたフィールドを一覧表示: ルックアップの設定でコピー元の「表示項目」として設定されているフィールドを列に表示するので、担当者や電話番号などの付随情報を確認しながら選択できます。
• ストライプ行表示: 表（テーブル）の行を1行おきに背景色を変えて表示して視認性を向上させ、大量のデータでも視線がずれず、各行の情報を読み取りやすくしています。
• 絞り込み件数の表示: 絞り込み検索結果のヒット件数をヘッダーに表示しますので、検索対象データの件数把握が容易です。

③ リアルタイムな連動性

「顧客ランクでAを選んだら、Aランクの顧客だけ表示」「分類記号を選んだらその商品だけが表示される」といった様に、入力作業に必要な情報だけに絞り込んでルックアップ元のデータを参照できるので、流れるような入力体験を実現します。

---

本プラグインの機能（技術者向け）

本プラグイン（Lookup Filtering）の機能で、管理者が注目すべき技術的ポイントは以下の通りです。

機能項目	内容
APIクエリ自動生成	現在のレコードの値を取得し、関連アプリに対して実行するクエリ（Query）を自動的に生成します。
演算子の自動最適化	フィールドタイプ（ドロップダウン、複数選択など）に応じて、=、in、like などの演算子を自動で使い分けて最適化しています。
ES6（ECMAScript 2015）言語仕様に準拠	ES6言語仕様で、変数やモジュールのスコープを限定し、グローバル汚染を防ぐことでメモリ競合を回避した設計になっています。
サブテーブルに対応（※Ver1.5より対応）	サブテーブル内のルックアップフィールドにも対応しており、行ごとの文脈に応じた絞り込みが可能です。

具体的な活用事例

このプラグインをどのように現場で活かすか、活用シナリオをご紹介します。

【営業日報】顧客マスタを担当者で絞り込み表示

• 課題: 営業日報で顧客マスタをルックアップで利用しているが、担当者で絞り込みが簡単にできないので、ルックアップ元の顧客マスタからデータ選択するのに毎回無駄な時間が発生している。
• 解決: 顧客マスタの「担当者」フィールドを検索対象にして日報フォームの担当者（ログインユーザー）を絞り込み条件に指定すれば、ルックアップ取得で担当者（ログインユーザー）だけの顧客リストが表示されるようになるので、日報入力作業が効率化。

【製造・在庫管理】部品選定の効率化

• 課題: カテゴリ（例：ネジ）を選んでも、サイズや材質がバラバラで部品特定に時間がかかる。
• 解決: 「大分類」「中分類」を選択すると、それらに合致するスペックの部品だけがルックアップ候補に出るように連動。

【人事・労務】所属部署に応じた社員選択

• 課題: 全社社員名簿から特定の課のメンバーを探すのが大変。
• 解決: 申請フォームで「部署」を選んだ時点で、その部署に所属する社員のみをルックアップで抽出。

---

プラグインの設定項目の説明

プラグイン設定画面は、IT専門家でなくても直感的に操作できるデザインを採用しています。

ステップ1：対象ルックアップの選択

プラグイン設定画面の「対象ルックアップ」の列にルックアップ型フィールドがリストアップされます。
ここで絞り込み検索の対象にしたいルックアップ型フィールドを選択します。

ステップ2：絞り込み条件設定

「どのフィールドの値を使って、どの様に絞り込むか」を設定します。

• ルックアップ参照元: ルックアップ参照元（マスタ側）の検索キーを選びます。
• 比較条件: 「一致する」「含む」「以上・以下」などから選択します。
• 条件フィールド: 参照元の検索キーと条件比較する自アプリのフィールドを指定します。

設定例：下記のプラグイン設定画面の設定例を参考にしてください

「保存する」をクリックし、アプリの設定を更新して完了です。

---

試用版プラグインのお申込み

本プラグインの試用版（60日間）をご希望の方は、以下のフォームからお申し込みください。
お申込み者のＥメール宛に「試用版ダウンロードのご案内」をＥメールでご送付します。
★★ kintoneの「ドメイン名」は正確にご記入ください。★★

お問い合わせ・料金体系

本プラグインは、下記の料金プランで販売しています。
各プランの「お問い合わせ／お申込み」欄のボタンからお申込み、又はお問い合わせください。

年間契約は、1年間の利用権の購入です（継続して利用される場合は、毎年購入が必要です）
簡易サポート契約では、アプリテンプレートとプラグインを合わせて6種類までご利用できます。
会員サポート契約では、アプリテンプレートとプラグインの無制限利用＋運用ヘルプデスク対応付きです。

リリースノート

【名称】ルックアップ絞り込み表示プラグイン

【概要】フォーム内の他フィールドの値を検索条件として、ルックアップの選択肢を絞り込みます。

このプラグインで利用しているOSSのライセンスは以下の通りです。

参考記事

以下の記事は、疑似ルックアップ機能でルックアップ先を動的に絞り込み表示するカスタマイズ事例の紹介です。
記事内で紹介しているカスタマイズコードは、無料で利用できるので是非挑戦してみて下さい。

「note:アプリ活用研究会（キン活）」は、当サイトのメンバーが執筆しています。

ルックアップ風の動的条件検索ができるカスタマイズ｜アプリ活用研究会（キン活）

やりたいこと アプリ連携でルックアップの様な機能で「動的な条件検索」をしたい。 kintoneでアプリ間のデータを紐付けるのに便利なルックアップ機能ですが、標準のルックアップ機能では、参照元に大量のレコードがある場合に柔軟な絞り込み検索をするための操作性があまり良くありません。 標準ルックアップ機能の制約 kintoneの標準ルックアップには、技術的な「制約」がいくつか存在します。 静的なフィルター条件: ルックアップの設定画面で指定できる「絞り込み条件」は、設定時に決めた固...

note.com

---

#kintone #plugin #ルックアップ #ルックアップの動的絞り込み