Ricerca

Suggerimento: tutte le ricerche sono insensibili alle maiuscole e alle minuscole e cercano una sottostringa, corrispondente all'istruzione SQL "ILIKE" con "%" intorno al valore di ricerca (ad esempio, se si cerca "Max" in "nome_nome", la query SQL sarà "nome_nome" ILIKE "%Max%").

Suggerimento: è possibile utilizzare i caratteri jolly SQL nelle ricerche. Ad esempio, se si cerca "ma%m", verrà restituito "Maxim". Se si passano questi caratteri jolly attraverso un parametro di query URL, assicurarsi di codificarli (ad esempio, "%" diventa "%25", mentre "_" può rimanere così com'è).

Suggerimento: per passare un array attraverso un parametro di query URL, assicurarsi di codificarlo nel seguente formato "arrayName[]=element1&arrayName[]=element2" (ad esempio "colors[]=red&colors[]=blue").

Connessioni di flusso

• [Input] In - avvia l'esecuzione del blocco.
• [Output] Out - si attiva quando il blocco ha terminato la sua esecuzione.

Connessioni ai dati

• [Input] _Offset (integer, optional) - prima riga del database da cui iniziare la ricerca (indice a partire da 0).
• [Input] _Limit (integer, optional) - numero massimo di oggetti modello da restituire.
• [Input] _SortOrder (string, optional) - ordinamento degli oggetti modello restituiti (può essere "ASC" per l'ordinamento ascendente o ""DESC" per l'ordinamento discendente).
• [Input] _SortBy (string, optional) - campo in base al quale verranno ordinati gli oggetti modello restituiti. Il nome del campo deve essere fornito in minuscolo (ad esempio "first_name").
• [Input] _with (enum, optional) - modelli di dati collegati all'oggetto modello di destinazione da recuperare dal database. Può essere utilizzato dopo l'espansione dell'oggetto modello trovato. Per ulteriori informazioni su _with, consultare le FAQ sui processi aziendali.
• [Input] _Search (string, optional) - valore da ricercare in più campi contemporaneamente utilizzando la logica OR (ad es. "nome_nome" = "Max" OPPURE "cognome" = "Max").
• [Input] _SearchIn (string array, optional) - campi da ricercare per il valore definito in _Cerca dati. I nomi dei campi devono essere forniti in minuscolo (ad es. "nome_nome").
• [Input] Fields (multiple, any) - valori dei campi da ricercare. Verranno restituiti tutti gli oggetti che contengono la sottostringa indicata; la ricerca è inoltre insensibile alle maiuscole e minuscole (ad esempio, se il valore è impostato su "MAX" e il valore di un oggetto nel database è "Maxim", verrà restituito). La ricerca è equivalente all'istruzione SQL "ILIKE" e tutti gli input non nulli vengono combinati con la logica AND (ad esempio, "Nome" ILIKE "%Max%" AND "Cognome" ILIKE "%Parker%").
• [Output] Data (model array) - oggetti modello trovati nel database.
• [Output] Count (integer) - numero di oggetti modello trovati.

Se il modello che si sta cercando ha relazioni uno-a-molti o molti-a-molti e si è selezionato il modello correlato da restituire usando l'input di dati _with, sarà anche possibile definire quali oggetti correlati saranno restituiti (applicando _Sort, _Search e simili). Si tenga presente che questi parametri non filtrano il modello ricercato, ma solo i modelli correlati (si veda il video precedente per maggiori dettagli).