English
Instant Developer Foundation Documentazione
  • Reference Oggetti
  • Area Query

Colonna di query

copia link

L’oggetto colonna rappresenta una espressione della select list della query, quindi una colonna del recordset risultato dall'esecuzione della query stessa. Esso viene usato anche per le query di modifica dati (update, insert) per esplicitare le espressioni che dovranno essere assegnate ai campi dei record in fase di modifica. Le icone che la rappresentano sono le seguenti:

Colonna derivata da un campo del database (stessa icona)

Colonna calcolata

Colonna calcolata con espressione errata

Espressione correlata con variabile in memoria

Proprietà di classe di una query Document Oriented


Video corso: Creazione viste database

Video corso: Eseguire query database nel codice

Normalmente le colonne vengono create e modificate tramite il visual code editor; ma è possibile aggiungerne tirando i campi delle tabelle che si desidera recuperare, oppure tramite il menù contestuale dell’oggetto query.

Proprietà

Nome: rappresenta il nome logico della colonna della query. Verrà usata nell’interfaccia utente come valore di default della caption dei campi che da essa derivano.

Descrizione: contiene la descrizione della colonna, anch’essa può essere utilizzata come tooltip dei campi che da essa derivano.

Visibile: indica se questa colonna deve essere mostrata all'interno della combo box che viene mostrata a run-time per modificare il valore del campo a cui appartiene la query. Tale flag è attivo solo per le query di tipo ValueSource e Autolookup.

Decodifica: indica se questa colonna deve essere utilizzata come decodifica del valore del campo associato alla query. Se nessuna colonna della query ha il flag Decodifica attivato, il sistema utilizza l'ultima colonna come decodifica.

Espressione: questa proprietà permette di modificare l’espressione della colonna, ed è valida solo per colonne calcolate. Normalmente la modifica delle espressioni avviene tramite il visual code editor, quindi questa proprietà non viene usata. Vedi anche:

Dominio/Lista Valori: una colonna calcolata può riferirsi ad un oggetto dominio, oppure ad una lista che ne elenca i possibili valori. In questo modo i campi che ne derivano verranno visualizzati con il controllo più adeguato al caso. Le colonne che derivano da un campo del database non hanno questa proprietà perché è definita nel campo stesso.

Codice: rappresenta l’alias della colonna nella query. Se è attivo il check-box Automatico allora Instant Developer sceglierà un alias adeguato e non dovrai preoccuparti che rimanga univoco. Se la query è bloccata, non potrai modificare questa proprietà.

Automatico: indica che l’alias della colonna viene calcolato e reso univoco in base al nome logico della stessa.

Menu contestuale

Order By: aggiunge una clausola di Order By in base alla colonna. E’ anche possibile scrivere ORDER BY come token sull’espressione della colonna per ottenere il medesimo risultato. Non valido per query di tipo vista o per query che modificano i dati.

Group By: aggiunge una clausola di Group By manuale in base alla colonna. E’ anche possibile scrivere GROUP BY come token sull’espressione della colonna per ottenere il medesimo risultato. NOTA: normalmente In.de calcola in automatico la clausola di group by, l’uso di questo comando è riservato ai pochissimi casi in cui la gestione automatica non è soddisfacente.

Converti in campo: da utilizzare solo se non si usa il visual code editor per modificare la query: estrae il primo riferimento al campo del database e esclude il resto dell’espressione.

Converti in espressione: da utilizzare solo se non si usa il visual code editor per modificare la query: converte un riferimento a campo in una colonna calcolata.

Vai al campo di pannello: permette di saltare nell'albero degli oggetti al campo di pannello che mostra il valore della colonna di query.

Aggiungi attività: crea un nuovo oggetto attività collegato alla colonna della query. Serve come promemoria per modifiche future o per gestire il lavoro di gruppo.

Vai a: permette di saltare nell'albero agli oggetti correlati alla colonna.

Trova oggetti derivati: cerca tutti gli oggetti del progetto derivati dalla colonna della query anche a più livelli di derivazione.

Trova dove usato (oggetto): cerca tutti i punti del progetto dove è stata direttamente riferita in qualunque modo questa colonna della query.

Trova dove usato (contenuto): cerca tutti i punti del progetto dove è stata direttamente riferita in qualunque modo questa colonna della query o uno degli oggetti in essa contenuti.

Puoi tirare una colonna di query con il drag&drop su…

Colonna di query: se la colonna della query appartiene alla stessa query di quella tirata, riordina le colonne nella select list.
Se la colonna tirata appartiene alla master query di un pannello ed essa viene tirata su di una colonna di una lookup query dello stesso pannello, si imposta la colonna su cui verrà eseguito l’ordinamento dei dati quando l’utente chiede di ordinare per la colonna del lookup. Vedi anche: Ordinamento per campi di lookup

aggiunge alla query una condizione di filtro sui campi derivanti dalle colonne. Solitamente usato in caso di subquery per collegarla alla query principale.

copia la colonna e la posiziona vicino all’oggetto su cui stai tirando.

Query: per le colonne di una vista, aggiunge alla from list della query la vista e alla select list la colonna tirata.

Campo di pannello: sostituisce la colonna a cui il campo di pannello è collegato. Non ci deve essere un altro campo già collegato alla colonna.

Applicazione, Videata, Classe: crea una variabile globale adatta a contenere il valore estratto da questo colonna di query (vista). La colonna e la variabile rimarranno sincronizzati: se modifichi la colonna, la variabile verrà aggiornata automaticamente.

Pannello (nel form editor): aggiunge la colonna di query (vista) al pannello, eventualmente modificando la master query per includere il colonna tirata.

Report: aggiunge al report un raggruppamento rispetto alla colonna della master query del report tirata.

Report (nel report designer): aggiunge al report una box ed uno span rispetto alla colonna della master query del report tirata. Il tipo di box dipende dalla combinazione di tasto SHIFT e CTRL premuti durante il trascinamento.

Box di report: aggiunge uno span alla box per visualizzare il valore della colonna della master query del report.

Procedura / funzione / evento: crea una variabile locale adatta a contenere il valore estratto da questo colonna.

invece di una variabile locale, crea un parametro (non valido per gli eventi).

Blocco di codice: crea una variabile locale al blocco adatta a contenere il valore estratto da questa colonna di vista.

Variabile: collega la variabile alla colonna tirata: le modifiche fatte alla colonna verranno automaticamente propagate alla variabile.

Ultima modifica: 16/11/2022 / Validità: da 8.5.3800

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum