INSDBDATA
Permette di inserire un record non ancora presente in tabella. L'inserimento avviene eseguendo la scrittura di tutti i campi definiti sul tracciato e reperiti, in memoria, utilizzano le variabili eventualmente definite con l'appendice indicata.
Se il record è già presente in tabella viene restituito l'errore di chiave duplicata.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| TABELLA | |||||
| TIPOREC | |||||
| GRUPPO | Stringa | ||||
| VIRTUALE | Intero | ||||
| VINCOLI | Intero | ||||
| APPENDICE | Stringa | ||||
| STRUTTURA | Stringa | ||||
| BULKINSERT | Intero | ||||
| ERRORE | |||||
| RECORD | Classe | ||||
| RECORDSET | Collezione | ||||
| OGGETTO | Classe | ||||
| COLLEZIONE | Collezione | ||||
| IDENTITYINSERT | Intero | 28.1 |
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.
TIPOREC
Tipo record della tabella. Se omesso si utilizza il primo (o unico) tipo record definito per la tabella.
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 |
L'utilizzo del parametro esclude l'utilizzo del parametro COLLEZIONE
VINCOLI
Permette di abilitare la gestione della profilazione se la tabella è soggetta a un vincolo di tipo elenco, inserendo in modo automatico delle clausole SQL da parte dell'ambiente, per filtrare gli elementi della tabella.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
APPENDICE
È il carattere di appendice che si vuole dare al nome delle variabili lette dall'archivio indicato (es.: APPENDICE['X']).
STRUTTURA
Indica il nome della struttura. Se costante è da indicare tra i doppi apici.
BULKINSERT
L'attributo permette, solo in ambito DataBase, di utilizzare la tecnologia del BULK Insert per effettuare l'operazione di aggiunta.
| Valore | Descrizione |
|---|---|
| 0 | NON è utilizzata la tecnologia del BULK |
| 1 | Utilizzo della tecnologia del BULK, sulla base dati sono inseriti i dati dalla struttura (o dalla collezione) compreso l'ID (identificativo) della tabella |
| 2 | Utilizzo della tecnologia del BULK, sulla base dati sono inseriti i dati dalla struttura (o dalla collezione), l'ID (identificativo autoincrementale) della tabella viene determinato in fase di scrittura sul database |
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
L'utilizzo del parametro esclude l'utilizzo del parametro TABELLASESSIONE
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.
RECORD
Indica il nome della variabile di tipo record contenente la riga della tabella da inserire.
RECORDSET
Indica il nome della variabile di tipo recordset contenente i record da inserire in tabella.
OGGETTO
Indica il nome della variabile di tipo oggetto contenente la riga della tabella da inserire.
L'utilizzo del parametro esclude l'utilizzo del parametro _RECTABELLA
COLLEZIONE
Indica la collezione contenente le righe da passare alla specifica.
IDENTITYINSERT
L'attributo permette, solo in ambito DataBase e se non specificato il parametro BULKINSERT, di definire il comportamento della specifica a fronte di un campo autoincrementale.
| Valore | Descrizione |
|---|---|
| 0 | Il campo autoincrementale è definito dal database |
| 1 | Il campo autoincrementale è definito dal programma |
L'utilizzo del parametro esclude l'utilizzo dei parametri: BULKINSERT, VIRTUALE
Esempi
Definizione
'@INSDBDATA TABELLA[BLDFAMIGLIA] _
TIPOREC[FAM] _
ERRORE[#DUPKEY]
If ZDUPKEY > 0 Then
ErrorManagement()
EndIf