Szukaj
Znajduje jeden lub kilka obiektów modelu w bazie danych na podstawie ich pól i zwraca je.
Wskazówka: wszystkie wyszukiwania nie uwzględniają wielkości liter i wyszukują podłańcuch odpowiadający zapytaniu SQL "ILIKE" z "%" wokół szukanej wartości (np. jeśli szukasz "Max" w "first_name", zapytanie SQL wyglądałoby jak "first_name" ILIKE "%Max%").
Wskazówka: możesz użyć znaków wieloznacznych SQL w swoich wyszukiwaniach. Na przykład, jeśli szukasz "ma%m", zwrócone zostanie "Maxim". Jeśli przekazujesz te symbole wieloznaczne poprzez parametr zapytania URL, upewnij się, że są one zakodowane (np. "%" staje się "%25", podczas gdy "_" może pozostać bez zmian).
Wskazówka: aby przekazać tablicę poprzez parametr zapytania URL, upewnij się, że jest ona zakodowana w następującym formacie "arrayName[]=element1&arrayName[]=element2" (np. "colors[]=red&colors[]=blue").
Przepływ Połączenia.
- [Input] In - uruchamia wykonanie bloku.
- [Wyjście] Out - uaktywnia się po zakończeniu wykonywania bloku.
Połączenia danych [Data Connections]
- [Input] _Offset (integer, optional) - pierwszy wiersz w bazie danych, od którego ma się rozpocząć wyszukiwanie (indeks zaczynający się od 0).
- [Input] _Limit (integer, optional) - maksymalna liczba obiektów modelu do zwrócenia.
- [Input] _SortOrder (string, optional) - sortowanie zwróconych obiektów modelu (może być "ASC" dla sortowania rosnącego lub "DESC" dla sortowania malejącego).
- [Input] _SortBy (string, optional) - pole, według którego zostaną posortowane zwrócone obiekty modelu. Nazwa pola powinna być podana małymi literami (np. "first_name").
- [Input] _with (enum, optional) - modele danych połączone z docelowym obiektem modelu do pobrania z bazy danych. Może być następnie użyty po rozwinięciu znalezionego obiektu modelu. Więcej o _with można przeczytać w FAQ dotyczącym procesów biznesowych.
- [Input] _Search (string, optional) - wartość do wyszukania w wielu polach jednocześnie przy użyciu logiki OR (np. "first_name" = "Max" OR "last_name" = "Max").
- [Input] _SearchIn (string array, optional) - pola, które mają być przeszukiwane pod kątem wartości zdefiniowanej w polu _Wprowadzanie danych do wyszukiwania. Nazwy pól powinny być podane małymi literami węża (np. "first_name").
- [Input] Fields (multiple, any) - wartości pól, które mają być przeszukiwane. Zwrócone zostaną wszystkie obiekty zawierające podany podłańcuch, wyszukiwanie jest również niewrażliwe na wielkość liter (np. jeśli wartość jest ustawiona na "MAX", a wartość obiektu w bazie to "Maxim", to zostanie on zwrócony). Wyszukiwanie jest równoważne instrukcji SQL "ILIKE", a wszelkie wejścia non-null są łączone przy użyciu logiki AND (np. "First Name" ILIKE "%Max%" AND "Last Name" ILIKE "%Parker%").
- [Output] Data (model array) - obiekty modelu znalezione w bazie danych.
- [Output] Count (integer) - liczba znalezionych obiektów modelu.
W przypadku, gdy szukany model posiada relacje jeden do wielu lub wiele do wielu i wybrałeś model powiązany, który ma być zwrócony za pomocą wejścia danych _with, będziesz mógł również określić, które powiązane obiekty zostaną zwrócone (poprzez zastosowanie na nich _Sort, _Search i podobnych). Pamiętaj, że nie będziesz filtrować modelu wyszukiwanego przez te parametry, a jedynie modele powiązane (więcej szczegółów w filmie powyżej).