Recherche

Cliquez pour copier

Recherche un ou plusieurs objets de modèle dans la base de données en fonction de leurs champs et les renvoie.



Conseil: toutes les recherches sont insensibles à la casse et recherchent une sous-chaîne, correspondant à l'instruction SQL "ILIKE" avec "%" autour de la valeur recherchée (par exemple, si vous recherchez "Max" dans "prénom", la requête SQL ressemblerait à "prénom" ILIKE "%Max%").

Conseil: vous pouvez utiliser des caractères génériques SQL dans vos recherches. Par exemple, si vous recherchez "ma%m", vous obtiendrez "Maxim". Si vous transmettez ces caractères génériques par le biais d'un paramètre de requête URL, veillez à les coder (par exemple, "%" devient "%25", tandis que "_" peut rester tel quel).

Conseil: pour transmettre un tableau par le biais d'un paramètre de requête URL, veillez à l'encoder au format suivant : "arrayName[]=élément1&arrayName[]=élément2" (par exemple, "colors[]=red&colors[]=blue").

Connexions de flux

  • [Entrée] In - lance l'exécution du bloc.
  • [Sortie] Out - s'active lorsque le bloc a terminé son exécution.

Connexions de données

  • [Input] _Offset (integer, optional) - première ligne de la base de données à partir de laquelle lancer la recherche (l'index commence à 0).
  • [Input] _Limit (integer, optional) - nombre maximum d'objets modèles à retourner.
  • [Input] _SortOrder (string, optional) - tri des objets modèles retournés (peut être "ASC" pour un tri ascendant ou ""DESC" pour un tri descendant).
  • [Input] _SortBy (string, optional) - champ par lequel les objets du modèle renvoyés seront triés. Le nom du champ doit être fourni en minuscules serpentines (par exemple, "prénom_nom").
  • [Input] _with (enum, optional) - modèles de données connectés à l'objet modèle cible à récupérer dans la base de données. Peut ensuite être utilisé après l'expansion de l'objet modèle trouvé. Pour en savoir plus sur _with, consultez la FAQ sur les processus métier.
  • [Input] _Search (string, optional) - valeur à rechercher dans plusieurs champs en même temps en utilisant la logique OR (par exemple, "prénom" = "Max" OU "nom_famille" = "Max").
  • [Input] _SearchIn (string array, optional) - champs dans lesquels la valeur définie dans _Search data input doit être recherchée. Les noms des champs doivent être fournis en minuscules serpentines (par exemple, "prénom_nom").
  • [Input] Fields (multiple, any) - les valeurs des champs à rechercher. Tous les objets contenant cette sous-chaîne seront retournés, la recherche n'est pas sensible à la casse (par exemple, si la valeur est définie sur "MAX" et que la valeur d'un objet dans la base de données est "Maxim", il sera retourné). La recherche est équivalente à l'instruction SQL "ILIKE" et toutes les entrées non nulles sont combinées en utilisant la logique AND (par exemple, "First Name" ILIKE "%Max%" AND "Last Name" ILIKE "%Parker%").
  • [Output] Data (model array) - objets de modèle trouvés dans la base de données.
  • [Output] Count (integer) - nombre d'objets de modèle trouvés.

Si le modèle que vous recherchez a des relations un-à-plusieurs ou plusieurs-à-plusieurs et que vous avez sélectionné le modèle lié à renvoyer à l'aide de l'entrée de données _with, vous pourrez également définir les objets liés qui seront renvoyés (en appliquant _Sort, _Search, etc.). Gardez à l'esprit que vous ne filtrerez pas le modèle recherché par ces paramètres, mais seulement les modèles liés (voir la vidéo ci-dessus pour plus de détails).