Suche

Zum Kopieren anklicken

Findet ein oder mehrere Modellobjekte in der Datenbank anhand ihrer Felder und gibt sie zurück.



Tipp: Bei allen Suchen wird die Groß- und Kleinschreibung nicht berücksichtigt und es wird nach einer Teilzeichenkette gesucht, die der SQL-Anweisung "ILIKE" mit "%" um den Suchwert entspricht (wenn Sie z. B. nach "Max" in "vorname" suchen, würde die SQL-Abfrage wie folgt aussehen: "vorname" ILIKE "%Max%").

Tipp: Sie können SQL-Wildcards in Ihren Suchen verwenden. Wenn Sie zum Beispiel nach "ma%m" suchen, wird "Maxim" zurückgegeben. Wenn Sie diese Wildcards über einen URL-Abfrageparameter übergeben, achten Sie darauf, sie zu kodieren (d. h. "%" wird zu "%25", während "_" unverändert bleiben kann).

Tipp: Um ein Array über einen URL-Abfrageparameter zu übergeben, müssen Sie es im folgenden Format kodieren: "arrayName[]=element1&arrayName[]=element2" (z. B. "colors[]=red&colors[]=blue").

Fluss-Verbindungen

  • [Input] In - startet die Ausführung des Blocks.
  • [Output] Out - wird aktiviert, wenn der Block seine Ausführung beendet hat.

Daten-Verbindungen

  • [Input] _Offset (integer, optional) - erste Zeile in der Datenbank, ab der die Suche beginnen soll (Index ab 0).
  • [Input] _Limit (integer, optional) - maximale Anzahl der zurückzugebenden Modellobjekte.
  • [Input] _SortOrder (string, optional) - Sortierung der zurückgegebenen Modellobjekte (kann entweder "ASC" für aufsteigende Sortierung oder "DESC" für absteigende Sortierung sein).
  • [Input] _SortBy (string, optional) - Feld, nach dem die zurückgegebenen Modellobjekte sortiert werden sollen. Der Name des Feldes sollte in Kleinbuchstaben angegeben werden (z. B. "first_name").
  • [Input] _with (enum, optional) - Datenmodelle, die mit dem Zielmodellobjekt verbunden sind, das aus der Datenbank abgerufen werden soll. Kann dann nach dem Erweitern des gefundenen Modellobjekts verwendet werden. Lesen Sie mehr über _with in den Business Processes FAQ.
  • [Input] _Search (string, optional) - Wert, nach dem in mehreren Feldern gleichzeitig mit ODER-Logik gesucht werden soll (z.B. "vorname" = "Max" ODER "nachname" = "Max").
  • [Input] _SearchIn (string array, optional) - Felder, die nach dem in _Suchdateneingabe definierten Wert durchsucht werden sollen. Die Namen der Felder sollten in Kleinbuchstaben angegeben werden (z. B. "vor_name").
  • [Input] Fields (multiple, any) - Feldwerte, nach denen gesucht werden soll. Alle Objekte, die die genannte Teilzeichenkette enthalten, werden zurückgegeben, wobei die Groß- und Kleinschreibung keine Rolle spielt (z. B. wenn der Wert auf "MAX" gesetzt ist und der Wert eines Objekts in der Datenbank "Maxim" lautet, wird es zurückgegeben). Die Suche entspricht der SQL-Anweisung "ILIKE", und alle Eingaben, die nicht Null sind, werden mit UND-Logik kombiniert (z. B. "Vorname" ILIKE "%Max%" AND "Nachname" ILIKE "%Parker%").
  • [Output] Data (model array) - in der Datenbank gefundene Modellobjekte.
  • [Output] Count (integer) - Anzahl der gefundenen Modellobjekte.

Für den Fall, dass das Modell, nach dem Sie suchen, Eins-zu-viele- oder Viele-zu-viele-Beziehungen hat und Sie das verwandte Modell, das zurückgegeben werden soll, mit der Dateneingabe _mit ausgewählt haben, können Sie auch festlegen, welche verwandten Objekte zurückgegeben werden sollen (indem Sie _Sort, _Search und Ähnliches auf sie anwenden). Denken Sie daran, dass Sie das gesuchte Modell nicht nach diesen Parametern filtern, sondern nur die verwandten Modelle (siehe Video oben für weitere Details).