CREATEDBKEY
Esegue una lettura della chiave massima e genera una nuova chiave restituendo nella variabile corrispondente all'ultimo segmento della chiave il nuovo valore incrementato di una unità. Il tipo della variabile deve essere numerico. L'incremento è pari ad 1. Se la tabella è vuota oppure non esiste oppure nessun record soddisfa le condizioni di filtro, ritorna nella variabile il valore 1.
Nel caso in cui sia presente il parametro VIRTUALE[], la '@CREATEDBKEY esegue la lettura sulla 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 |
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.
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
Indica il valore del campo speciale DBGruppo delle righe da identificare nella tabella, se non indicato è utilizzato il valore di BCContextInfo.GetGruppo.
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[]
Esempi
Definizione semplice
'@CREATEDBKEY TABELLA[BLDCLIFOR] _
TIPOREC[CF] _
IND[0 \COD = 99999999\]
Definizione per sottotabella
' ID documento
DIM TESIDDOC[INT] = 1
'@CREATEDBKEY TABELLA[BLDRIGA] _
TIPOREC[RIG] _
IND[0 \IDR = 999999999\] _
SELEZIONI[RIGIDDOC = TESIDDOC]
Definizione per sottotabella
' Codice Cliente Fornitore
DIM CFCOD[INT] = 1
'@CREATEDBKEY TABELLA[BLDINDCLIFOR] _
TIPOREC[ICL] _
IND[0 \COD = CFCOD\\NPR = 99999999\] _
SELEZIONI[ICLCOD = CFCOD]