DELDBDATA

DesktopWeb

Elimina i record dalla tabella selezionati mediante il criterio indicato dal parametro SELEZIONI, o alternativamente mediante una query.
Nel caso in cui la tabella su cui leggere non esista, la specifica non esegue alcuna operazione (la tabella non è creata).
Nel caso in cui sia presente il parametro VIRTUALE, la '@DELDBDATA esegue la cancellazione 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
VINCOLI	Intero
NUMRECORD	Long
IDQUERY	Long
TABLOCK	Booleano			29.1

TABELLA

InputObbligatorioValore non necessarioDesktopWeb

SottoParametri

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

InputValore non necessarioDesktopWeb

Definisce l'indice con il quale eseguire la lettura.

TIPOREC

InputValore non necessarioDesktopWeb

Tipo record da utilizzare. Se non indicato viene reperito l'unico tipo record relativo alla definizione del dfx.

TUTTIGRUPPI

InteroInputValore non necessarioDesktopWeb

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

StringaInputValore non necessarioDesktopWeb

Indica il valore del campo speciale DBGruppo delle righe da identificare nella tabella, se non indicato è utilizzato il valore di BCContextInfo.GetGruppo.

VIRTUALE

InteroInputValore non necessarioDesktopWeb

Permette alla specifica di operare sulla tabella o sulla struttura dinamica in memoria a seconda del valore del parametro VIRTUALE[] indicato.

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

InputValore non necessarioDesktopWeb

Indica una o più condizioni che se verificate fanno sì che il record sia selezionato

SELEZIONIESTESE

InputValore non necessarioDesktopWeb

Indica una o più condizioni che richiedono una sintassi estesa rispetto quanto possibile dal parametro SELEZIONI[]

VINCOLI

InteroInputValore non necessarioDesktopWeb

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

NUMRECORD

LongOutputValore non necessarioDesktopWeb

Numero di record cancellati.

IDQUERY

LongInputValore non necessarioDesktopWeb

Indica la sorgente dei dati per l'operazione di cancellazione. I record letti dalla query sono cancellati dalla tabella di origine. L'indicazione del parametro IDQUERY[] non consente l'indicazione dei parametri IND[], SELEZIONI[] e SELEZIONIESTESE[].

TABLOCK

29.1BooleanoInputValore non necessarioDesktop

Permette di indicare l'operazione che blocca l'intera tabella durante l'esecuzione.

note

• Il blocco è utile in particolari situazioni e va usato nei contesti in cui si è certi che non si fermi l'operatività dell'installazione.

Vantaggi:

• Dimensione del log ridotta al minimo
• Ottimizzazione della velocità (se siamo in un contesto di bassa concorrenza, come durante un aggiornamento di db).

Svantaggi:

• La tabella è bloccata durante l'intera esecuzione, in caso di concorrenza si possono verificare dei blocchi.

Esempi

Definizione

 DIM deleteFamCode[STRING] = "01"

 '@DELDBDATA TABELLA[BLDFAMIGLIA] _
             TIPOREC[FAM] _
             IND[0 \COD = ""\] _
             SELEZIONI[FAMCOD$ = deleteFamCode]