kintone 標準の検索機能を使用する場合、以下の手順が必要です。
- フィルターアイコンをクリック
- 検索条件を 1 つ 1 つ設定
- 「適用」ボタンをクリック
- 画面がリロードされ、結果が出力
また、kintone の検索機能を補完するようなプラグインはいくつか存在しますが、その多くは以下のような手順になるかと思います。
- ヘッダーなどに予め表示されている入力フィールドに文字を入力
- 「検索」ボタンをクリック
- 画面がリロードされ、結果が出力
今回ご紹介するプラグインは、文字を入力するという 1 アクションのみで、画面リロードも不要となるプラグインです。
つまり、以下の手順だけで求めているデータを取得することができます。
- 文字を入力すると、即座に結果が出力
また、kintone のフィールド検索には制約があり、日本語であれば 2 文字以上、アルファベットと数字は単語単位でしか検索ができません。
当プラグインを使用することで、各フィールドを 1 文字単位で検索も可能です。
ソースコードは全て GitHub に公開しており、無料で利用できます。
まずはデモからどうぞ。
デモ
レコード一覧の操作
記事トップでもお見せしましたが、プラグインを有効にすると一覧と共に検索フィールドが追加されます。検索フィールドに文字列を打ち込むことで、即座に結果が反映されます。
検索ボタンをクリックする必要すらありません。
設定画面の操作
設定画面です。
既存の一覧からフィールド情報をインポートすることもできるため、検証のため一時的に使用する場合も簡単に設定できます。
プラグインが提供する機能
- 高速な表示と検索
- 1 文字単位での検索が可能
- AND 検索
- 特定のフィールドに限定した検索
- 年、月、日単位での日付フィールドの検索
カード形式の表示
プラグインには、表示形式として「一覧形式」と「カード形式」があります。
カード形式を選択することで、一覧の各レコードをカードとして表示することができます。
画像フィールドを持つレコードの場合、カード形式で表示することで、画像を一覧で確認することができ、よりユーザーが見やすい一覧を作成することができます。
また、表示形式を一覧から変更可能にするオプションも用意しています。
プラグインが活きるシーン
- 頻繁に絞り込みを行う必要がある一覧
- 複数の検索条件を組み合わせて検索する必要がある一覧
- スマートフォンからの利用を想定している一覧
設定手順
プラグイン用の空の一覧を作成する
当プラグインでは1つの一覧を丸ごと使用します。
アプリの設定画面 → 「一覧」から一覧を追加し、以下の設定を行います。
一覧名 | 任意の名前を設定してください |
レコード一覧の表示形式 | 必ず「カスタマイズ」を選択してください |
ページネーションを表示する | チェックを外してください |
絞り込み | 初期表示する一覧の条件 |
以上の設定が完了したら、一度アプリを更新してください。
プラグインは更新済みの一覧のみ参照できます。
プラグインの設定
前述した方法で作成した一覧を、「テーブルを表示する一覧の設定」で選択します。
「テーブルに表示するフィールドの設定」に実際に一覧で表示するフィールドを選択し、設定は完了です。
API の使用回数は大丈夫?
デモをご覧になって、この疑問をお持ちになった方は、非常に kintone を熟知されているベテランであるとお見受けします。ただ、ご安心ください。
当プラグインでは、 一覧表示時に最小の API 使用回数でレコードを一括取得し、データをキャッシュしています。
事前に非同期でデータを取得しておくことで、検索パフォーマンスを向上させています。
ですので検索フォームに文字を打つたびに API 使用回数を消費することはなく、最大でも
アプリの総レコード数 / 500
の使用回数しか消費しません。
当プラグインは、数十万、数百万レコードが蓄積されているような大規模なアプリで使用することを想定していません。
レコードの件数が多い場合、目的の検索結果が表示されるまでに時間がかかる可能性があります。
お問い合わせ
プラグインの不具合や、機能追加のご要望などがあれば、画面上部のナビバーからお問い合わせください。
プラグインのソースコード
当プラグインはオープンソースです。 プラグインがどういったファイルで構成されているのか、どのように実装されているのか、全てのプログラムを Github から確認することが可能です。
プラグインのソースコードを確認されたい方は、当ページトップの「ソースコードを確認する」ボタンからプラグインのリポジトリにアクセスすることができます。