GETQUERYPAGE

31.4Web

Permette di recuperare i dati da una query in modalità paginata, specificando le righe da cui far partire la lettura e il numero di record da estrarre.
In questo modo è possibile produrre pagine di dati per scorre il risultato della query.
Questa specifica è consigliata per lo sviluppo di servizi REST che devono ritornare un elenco di dati.

note

Pertanto data una query che restituisce 105 record, posso decidere di paginarla eseguendo tre letture con i seguenti parametri:

• SKIP=0, TAKE=50 è 50 Righe

• SKIP=50, TAKE=50 è 50 Righe

• SKIP=100, TAKE=50 è 5 Righe

suggerimento

Per ottenere ottime prestazioni specificare ordinamenti di soli campi definiti come indici sul db.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
IDQUERY	Long
SKIP	Long
TAKE	Long
COLLEZIONE	Collezione
TOTRECORD	Long
AZIONE
ERRORE

IDQUERY

LongInputObbligatorioValore non necessarioDesktopWeb

Identificatore della query ottenuto tramite @DEFQUERY.

SKIP

LongInputObbligatorioValore non necessarioDesktopWeb

Identifica il numero di righe che devono essere saltata prima di cominciare la lettura.

TAKE

LongInputObbligatorioValore non necessarioDesktopWeb

Identifica il numero di record da leggere. Se viene indicato zero verranno letti tutti i record.

COLLEZIONE

CollezioneInputValore non necessarioDesktopWeb

Indica il nome della variabile di tipo collezione che conterrà le righe restituite dalla specifica.

TOTRECORD

LongOutputObbligatorioValore non necessarioDesktopWeb

Restituisce il numero di righe presenti sulla query indipendentemente dalla paginazione.

AZIONE

InputValore non necessarioDesktopWeb

SottoParametri

Permette di indicare una callback per l'elaborazione dei dati.

ERRORE

InputDesktopWeb

SottoParametri

Indica un'azione da eseguire nel caso in cui sia stata raggiunta la fine/inizio del file, nel caso in cui siano terminati i record che soddisfano i filtri indicati nel parametro SELEZIONI[] o nel caso in cui l'archivio non esista