GETNEXTDBKEY
Esegue la lettura della chiave successiva a quella indicata dall'attributo IND, valorizzando le variabili della tabella relative alla chiave. Se la tabella è vuota oppure non esiste oppure nessun record soddisfa le condizioni di filtro, ritorna errore (tipicamente la valorizzazione di ZENDFIL=1). Nel caso in cui sia presente il parametro VIRTUALE, la '@GETNEXTDBKEY esegue la lettura su tabella o sulla struttura dinamica in memoria a seconda del valore del parametro VIRTUALE stesso.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| TABELLA | |||||
| IND | |||||
| TIPOREC | |||||
| TUTTIGRUPPI | Intero | ||||
| GRUPPO | Stringa | ||||
| VIRTUALE | Intero | ||||
| SELEZIONI | |||||
| SELEZIONIESTESE | |||||
| ERRORE |
TABELLA
Nome del DFX da cui reperire le caratteristiche della tabella, se sono indicati il dizionario dati e la sua versione fa riferimento la 'fotografia' del DFX alla determinata versione del dizionario dati indicata.
IND
Definisce l'indice con il quale eseguire la lettura.
TIPOREC
Tipo record della tabella. Se omesso si utilizza il primo (o unico) tipo record definito per la tabella.
TUTTIGRUPPI
Se indicato, il filtro sul campo speciale DBGruppo per selezionare solo le righe del gruppo indicato in BCContextInfo.GetGruppo non viene effettuato.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
GRUPPO
Definisce per il database il valore del campo speciale DBGruppo dei record da identificare nella tabella.
VIRTUALE
Il parametro permette la sovrapposizione tra la gestione delle tabelle su DB e la gestione delle tabelle in Struttura Dinamica.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | la specifica gestisce il normale accesso alla tabella del DataBase. |
1 | la specifica gestisce l'accesso alla Struttura Dinamica in memoria, struttura definita con lo stesso nome del DFX della tabella. |
2 | la specifica gestisce solo l'accesso alla Struttura per le operazioni di LETTURA, mentre vengono gestiti sia il DB che la Struttura per le operazioni di SCRITTURA/CANCELLAZIONE |
SELEZIONI
Indica una o più condizioni che se verificate fanno sì che il record sia selezionato
SELEZIONIESTESE
Indica una o più condizioni che richiedono una sintassi estesa rispetto quanto possibile dal parametro SELEZIONI[]
ERRORE
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.
Esempi
Definizione
DIM startKey[INT] = 10
'@GETNEXTDBKEY TABELLA[BLDCLIFOR] _
TIPOREC[CF] _
IND[0 \COD = startKey\] _
ERRORE[#ENDFIL]