WRITEDBDATA
Permette di scrivere un record in tabella senza doversi preoccupare di verificare che il record sia presente in tabella.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| TABELLA | |||||
| TIPOREC | |||||
| IND | |||||
| TUTTIGRUPPI | Intero | ||||
| GRUPPO | Stringa | ||||
| VIRTUALE | Intero | ||||
| VINCOLI | Intero | ||||
| APPENDICE | Stringa | ||||
| ERRORE | |||||
| PRIORITA | Enumerazione | ||||
| OPERAZIONE | Intero | ||||
| CAMPINOUPDATE | |||||
| RECORD | Classe | ||||
| OGGETTO | Classe |
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.
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 |
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']).
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.
PRIORITA
Priorità della modalità di aggiornamento del record della tabella.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
INSERT | 0 |
UPDATE | 1 |
OPERAZIONE
Ritorna quale operazione è stata eseguita: UPDATE=1, INSERT=0.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | INSERT |
1 | UPDATE |
CAMPINOUPDATE
Se presente, i campi indicati non verranno aggiornati se la scrittura viene eseguita in modalità UPDATE. Se il parametro non è indicato vengono scritti tutti i campi.
Il parametro non deve essere utilizzato se viene gestito il parametro OGGETTO[].
RECORD
Variabile Record valorizzata col contenuto della riga corrente.
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
Esempi
Definizione
FAMCOD$ = "02"
FAMDES$ = "Famiglia 01"
'@WRITEDBDATA TABELLA[BLDFAMIGLIA] _
TIPOREC[FAM] _
IND[0 \COD =\] _
PRIORITA[#UPDATE]