検索
クリックでコピー
データベース内の1つまたは複数のモデルオブジェクトを、そのフィールドに基づいて検索し、それらを返します。
ヒント: すべての検索は大文字と小文字を区別せず、検索値を "%" で囲んだ SQL "ILIKE" 文に対応する部分文字列を検索します (例: "first_name" の "Max" を検索する場合、SQL クエリは "first_name" ILIKE "%Max%" のようになります).
ヒント：SQL ワイルドカードを検索に使用することができます。例えば、"ma%m" と検索すると、"Maxim" が返されます。これらのワイルドカードをURLのクエリパラメータに渡す場合は、必ずエンコードしてください（例："%"は"%25 "に、"_"はそのままでOK）。
ヒント：URLのクエリーパラメーターに配列を渡す場合は、次のフォーマットでエンコードしてください：「arrayName[]=element1&arrayName[]=element2」（例：「colors[]=red&colors[]=blue」）。
フローコネクション
- [Input] In - ブロックの実行を開始します。
- [Output] Out - ブロックの実行が終了したときにアクティブになります。
データ接続
- [Input] _Offset (integer, optional) - 検索を開始するデータベースの最初の行 (0から始まるインデックス)。
- [Input] _Limit (integer, optional) - 返されるモデルオブジェクトの最大数
- [Input] _SortOrder (string, optional) - 返されるモデルオブジェクトのソート(昇順ソートの場合は "ASC"、降順ソートの場合は""DESC "となります)
- [Input] _SortBy (string, optional) - 返されるモデルオブジェクトがソートされるフィールド。フィールド名は、小文字のスネークケースで指定します (例: "first_name")。
- [Input] _with (enum, optional) - データベースから取得する対象のモデルオブジェクトに接続されたデータモデル。その後、見つかったモデルオブジェクトを展開した後に使用することができます。ビジネスプロセスFAQで_withについて詳しく説明しています。
- [Input] _Search (string, optional) - ORロジックを使用して、複数のフィールドで同時に検索される値（例："first_name" = "Max" OR "last_name" = "Max")。
- [Input] _SearchIn (string array, optional) - 検索データ入力で定義された値に対して検索されるフィールド。フィールド名は小文字のスネークケースで指定する (例: "first_name")。
- [Input] Fields (multiple, any) - 検索対象となるフィールドの値。検索は大文字小文字を区別しません(例えば、値が "MAX "に設定され、データベース内のオブジェクトの値が "Maxim "の場合、そのオブジェクトが返されます)。検索はSQLの "ILIKE "ステートメントと同等で、NULLでない入力はANDロジックを使用して結合されます（例： "First Name" ILIKE "%Max%" AND "Last Name" ILIKE "%Parker%").
- [Output] Data (model array) - データベースで見つかったモデル・オブジェクト。
- [Output] Count (integer) - 見つかったモデル・オブジェクトの数。
検索対象のモデルが一対多または多対多の関係を持ち、_withデータ入力を使って返すべき関連モデルを選択した場合、どの関連オブジェクトを返すかを定義することもできます（_Sort、_Searchなどを適用することで）。これらのパラメータによって検索されるモデルをフィルタリングするのではなく、関連するモデルだけをフィルタリングすることに留意してください (詳細は上記のビデオを参照してください)。