一覧画面にキーワードで検索する検索フォームを設置する

概要

一覧画面に主にキーワードで検索する検索フォームを設置します。

ただし、数値フィールドや計算フィールドはキーワードではなく「=(等しい)」で検索します。

使い方

「一覧画面にキーワードで検索する検索フォームを設置する」を実行すると一覧画面に検索フォームが表示されます。 ユーザーがこの検索フォームに検索条件を入力し、「検索」ボタンを押すと、一覧画面に表示されるレコードのリストがさらに絞り込まれます。

複数のフィールドを条件として設置し、それぞれに条件を入力して検索した場合、 それらの条件を「かつ(AND)」で結んだ条件で検索します。

ユーザーが現在選択している kintone の「一覧」に絞り込み条件が付いている場合、 「一覧」に絞り込み条件と、ユーザーが検索フォームで入力した条件を「かつ(AND)」で結んだ条件で検索します。つまり、もともとの「一覧」の条件からさらに絞り込む形になります。

一覧画面に簡易検索フォームを設置する」との主な違いは以下の通りです。

  • 条件となるフィールドが複数選択できます。
  • 「文字列(1行)」での検索条件が「=(等しい)」ではなくキーワード検索になります。
  • フォームの表示位置が、メニューの下になります。

メニューの下

設定するパラメーター

「検索条件フィールド」を設定します。

検索条件フィールド

検索条件として検索フォームに表示したいフィールドを選択します。

選択可能なフィールドタイプと、それが検索フォーム上でどのような入力タイプになるか、どのような検索条件になるか、は以下の表の通りです。

フィールドタイプ 検索条件入力フォーム 検索条件タイプ
文字列(1行) 文字列入力 (検索条件として入力したキーワードを)含む
ルックアップ(文字列) 文字列入力 (検索条件として入力したキーワードを)含む
ルックアップ(数値) 文字列入力 =(等しい)
リンク 文字列入力 (検索条件として入力したキーワードを)含む
数値 文字列入力 =(等しい)
計算 文字列入力 =(等しい)
レコード番号 文字列入力 =(等しい)
文字列(複数行) 文字列入力 (検索条件として入力したキーワードを)含む
リッチエディター 文字列入力 (検索条件として入力したキーワードを)含む
チェックボックス 複数選択 (検索条件として選択した項目を)含む
ラジオボタン 複数選択 (検索条件として選択した項目を)含む
ドロップダウン 複数選択 (検索条件として選択した項目を)含む
複数選択 複数選択 (検索条件として選択した項目を)含む
日付 文字列入力2つ (下記参照)

日付の検索条件は、以下のようになります。

  • 左側のみ入力した場合の条件は「日付 >= 左の入力条件」
  • 右側のみ入力した場合の条件は「日付 <= 右の入力条件」
  • 両方入力した場合の条件は「日付 >= 左の入力条件 かつ 日付 <= 右の入力条件」

アプリに関連レコード一覧のフィールドがある場合、その関連レコード一覧が参照するアプリのフィールドも検索条件にすることができます。その場合も、選択できるフィールドタイプは上記と同じです。

制限事項

検索フォームに表示するフィールドの順番を変更することはできません。

複数のフィールドを「または(OR)」で検索することはできません。

前述の表のとおり、フィールドタイプに応じて検索条件が決まっています。 それ以外の条件で検索することはできません。 例えば、「文字列(1行)」の場合は必ず「含む」での検索になり「=(等しい)」で検索することはできません。

スマートフォン版アプリには対応していません。 スマートフォン版アプリで実行した場合、エラーにはなりませんが、フォームも表示されません。

複数の検索フォームを設置することはできません。 「一覧画面に簡易検索フォームを設置する」と「一覧画面にキーワードで検索する検索フォームを設置する」の検索フォームと同時に置くことは可能です。

アプリの一覧設定で、一覧の名前に重複がある場合は、 「一覧の取得、または更新に失敗しました。一覧「XXXX」の名前が重複しています。重複しない名前に変更してください。」 というエラーになります。

日付フィールドの検索条件入力では、日付の指定を「2018-11-05」のように、ハイフン区切りで指定する必要があります。それ以外の書式、例えば「2018/11/5」のように/区切りで入力すると、検索時に「日付書式が不正です」のエラーが出ます。

使用例