一覧画面にキーワードで検索する検索フォームを設置する
概要
一覧画面に主にキーワードで検索する検索フォームを設置します。
ただし、数値フィールドや計算フィールドはキーワードではなく「=（等しい）」で検索します。
使い方
「一覧画面にキーワードで検索する検索フォームを設置する」を実行すると一覧画面に検索フォームが表示されます。 ユーザーがこの検索フォームに検索条件を入力し、「検索」ボタンを押すと、一覧画面に表示されるレコードのリストがさらに絞り込まれます。
複数のフィールドを条件として設置し、それぞれに条件を入力して検索した場合、 それらの条件を「かつ(AND)」で結んだ条件で検索します。
ユーザーが現在選択している kintone の「一覧」に絞り込み条件が付いている場合、 「一覧」に絞り込み条件と、ユーザーが検索フォームで入力した条件を「かつ(AND)」で結んだ条件で検索します。つまり、もともとの「一覧」の条件からさらに絞り込む形になります。
「一覧画面にキーワードと数値の範囲で検索する検索フォームを設置する」と似ていますが、「一覧画面にキーワードと数値の範囲で検索する検索フォームを設置する」は、数値・計算フィールドを数値の範囲で検索します。それに対しこちらの「一覧画面にキーワードで検索する検索フォームを設置する」の方は、数値フィールドや計算フィールドを、範囲ではなくイコール「=」で検索します。
「一覧画面に簡易検索フォームを設置する」との主な違いは以下の通りです。
- 条件となるフィールドが複数選択できます。
- 「文字列（1行）」での検索条件が「=(等しい)」ではなくキーワード検索になります。
- フォームの表示位置が、メニューの下になります。
設定するパラメーター
「検索条件フィールド」を設定します。
検索条件フィールド
検索条件として検索フォームに表示したいフィールドを選択します。
選択可能なフィールドタイプと、それが検索フォーム上でどのような入力タイプになるか、どのような検索条件になるか、は以下の表の通りです。
| フィールドタイプ | 検索条件入力フォーム | 検索条件タイプ |
|---|---|---|
| 文字列（1行） | 文字列入力 | (検索条件として入力したキーワードを)含む |
| ルックアップ（文字列） | 文字列入力 | (検索条件として入力したキーワードを)含む |
| ルックアップ（数値） | 文字列入力 | =(等しい) |
| リンク | 文字列入力 | (検索条件として入力したキーワードを)含む |
| 数値 | 文字列入力 | =(等しい) |
| 計算 | 文字列入力 | =(等しい) |
| レコード番号 | 文字列入力 | =(等しい) |
| 文字列（複数行） | 文字列入力 | (検索条件として入力したキーワードを)含む |
| リッチエディター | 文字列入力 | (検索条件として入力したキーワードを)含む |
| チェックボックス | 複数選択 | (検索条件として選択した項目を)含む |
| ラジオボタン | 複数選択 | (検索条件として選択した項目を)含む |
| ドロップダウン | 複数選択 | (検索条件として選択した項目を)含む |
| 複数選択 | 複数選択 | (検索条件として選択した項目を)含む |
| 日付 | 文字列入力2つ | （下記参照） |
日付の検索条件は、以下のようになります。
- 左側のみ入力した場合の条件は「日付 >= 左の入力条件」
- 右側のみ入力した場合の条件は「日付 <= 右の入力条件」
- 両方入力した場合の条件は「日付 >= 左の入力条件 かつ 日付 <= 右の入力条件」
アプリに関連レコード一覧のフィールドがある場合、その関連レコード一覧が参照するアプリのフィールドも検索条件にすることができます。その場合も、選択できるフィールドタイプは上記と同じです。
制限事項
検索フォームに表示するフィールドの順番を変更することはできません。
複数のフィールドを「または(OR)」で検索することはできません。
前述の表のとおり、フィールドタイプに応じて検索条件が決まっています。 それ以外の条件で検索することはできません。 例えば、「文字列（1行）」の場合は必ず「含む」での検索になり「=(等しい)」で検索することはできません。
１つの検索フォームの中で、「ある数値・計算フィールドはイコール「=」で検索し、ある別の数値・計算フィールドは範囲で検索する」、という設定はできません。
スマートフォン版アプリには対応していません。 スマートフォン版アプリで実行した場合、エラーにはなりませんが、フォームも表示されません。
複数の検索フォームを設置することはできません。「一覧画面にキーワードで検索する検索フォームを設置する」と「一覧画面にキーワードと数値の範囲で検索する検索フォームを設置する」と同時に置くこともできません。例外的に、「一覧画面に簡易検索フォームを設置する」と「一覧画面にキーワードで検索する検索フォームを設置する」の検索フォームと同時に置くことは可能です。
アプリの一覧設定で、一覧の名前に重複がある場合は、 「一覧の取得、または更新に失敗しました。一覧「XXXX」の名前が重複しています。重複しない名前に変更してください。」 というエラーになります。
日付フィールドの検索条件入力では、日付の指定を「2018-11-05」のように、ハイフン区切りで指定する必要があります。それ以外の書式、例えば「2018/11/5」のように／区切りで入力すると、検索時に「日付書式が不正です」のエラーが出ます。