Capitolo 5

Creare un Recordset 

Se decidi di usare un database con la tua applicazione, non puoi lavorare direttamente con il database: devi lavorare con l'intermediario di un recordset. Per esempio, quando fissi gli attributi della pagina con i dati, li fissi con i dati nel recordset, non nel database. 

Un recordset è un sottoinsieme di record estratto da un database da una richiesta del database. Una richiesta consiste in un criterio di ricerca che determina che cosa è incluso nel recordset e che cosa non lo è. Una richiesta può produrre un recordset che include solo certe colonne, certi redords, o una combinazione di ambedue. 

Un recordset può anche includere tutti i record e le colonne di una tabella del database. 

Comunque, poichè le tue applicazioni raramente avranno bisogno di usare tutti i pezzi dei dati in un database, sforzati di fare i tuoi recordsets di dimensioni minime. Un server contiene temporaneamente il recordset in memoria, poi lo scarta quando non è più ecessario. 

Più sono piccoli i recordsets meno memoria usano, e come risultato la prestazione del server può migliorare. L'orientamento di base quando si definiscono i recordsts, è di includere solo i dati strettamente necessari per l'applicazione. 

Definire un recordset 

Un recordset è definito da una richiesta che è un'espressione composta di criteri di ricerca disegnati per trovare ed estrarre le informazioni da un database. Dreamweaver UltraDev usa lo Structured Query Language per costruire le richieste. Non hai bisogno di conoscere l'SQL (pronuncia: "sequel") definire un semplice recordset in UltraDev. Comunque, se conosci l'SQL, puoi usarlo per definire i tuoi recordsets. 

Nota: Dopo aver definito un recordset,  i dati in esso contenuti non sono  immediatamente visibili nella finestra del Documento o nella finestra Live Data. I dati diventano visibili dopo che hai aggiunto una colonna dal recordset alla tua pagina e passi alla finestra Live Data (View > Live Data). 

Definire un recordset senza usare l'SQL 

Se hai poca dimestichezza con l'SQL, puoi definire i recordsets usando il dialog box Recordset semplice. Definire un recordset usando questo metodo può essere facile come selezionare un collegamento ed una tabella del database dai pop-up menu 

Se devi lavorare con l'SQL, usa il dialog box advanced Recordset.  

Per definire un recordset senza usare SQL: 

1 assicurati che la pagina che userà il recordset sia aperta nella finestra del Documento o nella finestra Live Data. 

2 nel pannello Data Bindings (Window > Data Bindings), clicka sul bottone Plus (+) e scegli Recordset (Query) dal pop-up menu. 

Appare il dialog box simple Recordset. 

Se invece appare il dialog di Recordset avanzato, passa al dialog box Recordset semplice clickando sul bottone Simple. 

3 nel box Name, inserisci un nome per il recordset. 

Una pratica comune è di aggiungere il prefisso rs al nome recordset  per distinguerli dagli altri nomi dell'oggetto nel tuo codice, per esempio, rsPressReleases. 

Nota: Non usare spazi o caratteri speciali nel nome del recordset. 

4 seleziona un collegamento pop-up menu Connection. 

Se nessun collegamento appare nell'elenco, clicka su Define per crearne uno.  

5 nel pop-up menu Table, seleziona la tabella del database che fornirà i dati al tuo recordset o riceverà i dati da esso. 

Il pop-up menu visualizza tutte le tabelle nel database collegato. 

6 per includere solo alcune delle colonne della tabella nel recordset, clicka su Slected e scegli le colonne desiderate con CTRL+click su (Windows) o Command+click su (Macintosh). 

7 per includere solo alcuni record della tabella, completa la sezione Filter come segue: 

-          Dal primo pop-up menu, seleziona una colonna nella tabella del database per paragonarla a un valore di prova che hai definito. 

-          Dal secondo pop-up menu, seleziona un'espressione condizionale per comparare il valore selezionato in ogni record a valore di prova. 

-          Dal terzo pop-up menu, seleziona Entered Value. 

-          Nella quarto box, inserisci il valore di prova. 

Se il valore specificato in un record soddisfa la tua condizione di filtrazione, il record sarà incluso nel recordset. 

8 se vuoi ordinare i records, seleziona una colonna da ordinare, poi specifica se i records devono essere ordinati in ordine crescente (1, 2, 3.. o A, B, C.) o in ordine decrescente. 

9 se vuoi, clicka su Test per connetterti al database e creare un esempio del recordset. 

Appare una tabella per visualizzare i dati nel tuo recordset. Ogni fila contiene un record ed ogni colonna rappresenta un campo in quel record. Ckica su OK per chiudere il recordset. 

10 se sei soddisfatto del tuo lavoro, ckica su OK. 

UltraDev aggiunge il recordset al tuo elenco dei dati sorgente disponibile nel pannello Data Bindings. Espandi i rami del recordset per vedere le colonne che hai definito. Puoi usare qualsiasi di queste colonne come una sorgente di contenuto dinamico per la tua pagina.  

Definire un recordset usando l'SQL 

Se hai dimestichezza con l'SQL o se devi impararlo, puoi definire i tuoi recordsets usando il dialog box Recordset avanzato.   

Per definire un recordset usando l'SQL: 

1 assicurati che la pagina che userà il recordset sia aperta nella finestra del Documento o nella finestra Live Data. 

2 nel pannello Data Bindings (Window > Data Bindings), clicka sul bottone Plus (+) e scegli Recordset (Qyery) dal pop-up menu.. 

Se appare il dialog box Recordset semplice, passa al dialog box Recordset avanzato clickando sul bottone Advanced. 

Appare il dialog box Recordset avanzato. 

3 nel box Name, inserisci un nome per il recordset. 

Una pratica comune è di aggiungere il prefisso rs al nome del  recordset per distinguerli dagli altri nomi dell'oggetto nel tuo codice, per esempio, rsPressReleases. 

Nota: Non usare spazi o caratteri speciali nei nomi del recordset. 

4 seleziona un collegamento dal pop-up menu Connection. 

Se nessun collegamento appare nell'elenco, clicka su Define per crearne uno.  

5 inserisci l'espressione SQL nell'area di testo SQL. 

Per ridurre la quantità di caratteri, puoi usare l'albero degli articoli del database in fondo al dialog box. Per usare l'albero, prima assicurati che l'area di testo SQL sia bianca. Dopo, espandi i rami nell'albero finché non trovi l'oggetto del database che ti serve, una colonna in una tabella per esempio. Selezionala ed aggiungila alla tua espressione SQL clickando su uno dei tre bottoni sul lato destro dell'albero: Select, Where, e Order By. Ognuno di questi bottoni aggiunge una clausola all'espressione  SQL. 

6 se inserisci le variabili nell'espressione SQL, definisci i loro valori nell'area Variables clickando sul bottone Plus (+) ed inserendo il nome della variabile, il valore di default (il valore che le variabili dovrebbero prendere se nessun valore viene restituito in run time), e il valore run time (di solito un oggetto del server che conserva un valore spedito da un browser, come un oggetto request ASP. 

Per esempio, supponi che un form HTML sulla pagina di richiesta abbia un campo chiamato " Name ". Il valore run time per questo campo in ASP potrebbe essere Request (" Name "), Request.Form (" Name "), o Request.QueryString (" Name "), in funzione dal metodo del form usato (o POST). Il valore run time per ColdFusion sarà #Name #. Il valore run time per JSP sarà request.getParameter ( " Name "). 

7 se vuoi, clicka su Test per connetterti al database e creare un esempio del recordset. 

Se tutto è OK, appare una tabella per visualizzare i dati nel tuo recordset. Ogni fila contiene un record ed ogni colonna rappresenta un campo in quel record. Ckica su OK per cancellare il recordset. 

8 se sei soddisfatto del tuo lavoro, ckica su OK. 

UltraDev aggiunge il recordset al tuo elenco dei dati sorgente disponibile nel pannello Data Bindings. Espandi i rami del recordset per vedere le colonne che hai definito per esso. Puoi usare qualsiasi di queste colonne come una sorgente del contenuto dinamico per la tua pagina. 

Esempi di espressioni SQL 

Ecco due esempi le espressioni SQL ed i passi per crearli nel dialog box Recordset avanzato. 

Nota: Per aprire il dialog Recordset avanzato, clicka sul bottone Plus (+) nel pannello Data Bindings (Window >Data Bindings) e scegli Recordset (Query) dal pop-up menu. Se appare il dialog box Recordset semplice, clicka su Advanced. 

Per creare la seguente espressione SwwQL: 

SELECT *FROM Employees 

1 nell'albero degli articoli del database in fondo al dialog box, espandi i rami Tables e seleziona la tabella EMPLOYEES. 

2 clicka sul bottone Select. 

3 ckica su OK per aggiungere il recordset al pannello Data Bindings. 

Per creare la seguente espressione SQL: 

SELECT emplNo,emplName 

FROM Employees 

WHERE emplJob ='varJob' 

ORDER BY emplName 

1 nell'albero degli articoli del database, espandi i rami Tables, poi espandi i rami  EMPLOYEES. 

2 costruisci l'espressione SQL come segue: 

-          Seleziona emplNo e clicka sul bottone Select. 

-          Seleziona emplName e clicka sul bottone Select. 

-          Seleziona emplJob e clicka sul bottone Where. 

-          Seleziona emplName e clicka sul bottone Order By. 

3 poni il punto di inserzione dopo WHERE emplJob nell'area di testo SQL e scrivi = '  varJob'(incluso il segnale uguale). 

4 definisci le variabili ' varJob'by clickando sul bottone Plus (+) nell'area di testo Variables ed inserendo i seguenti valori in Name, Default Value, e Run-Time Value colonne: varJob , CLERK , Request("job"). 

5 ckica su OK per aggiungere il recordset al pannello Data Bindings. 

Invocare una procedura memorizzata 

Un recordset può essere definito da una procedura memorizzata che consiste di uno o più espressioni SQL che stanno in un database. Le procedure memorizzate possono restituire uno o più recordsets, sebbene UltraDev supporti solo procedure memorizzate che restituiscono uno o nessun recordset. 

Le procedure memorizzate possono anche essere messe nella memoria del server ed usate come una sorgente di dati per la tua pagina.  

Invocare una procedura memorizzata per definire un recordset: 

1 apri la pagina che ha bisogno del recordset. 

2 nel pannello Data Bindings, clicka sul bottone Plus (+) e scegli Recordset (Qyery) dal pop-up menu.. 

Se si apre il dialog box Recordset semplice, clicka sul bottone Advanced per aprire il dialog box advanced Recordset. 

3 nel dialog box Recordset avanzato, inserisci un nome per il tuo recordset e seleziona il collegamento al database che contiene la procedura memorizzata. 

4 nell'albero degli articoli del database in fondo al dialog box, espandi il ramo Stored Procedures, seleziona la procedura memorizzata voluta, e clicka sul bottone Procedure. 

5 se la procedura memorizzata prende i parametri, definisci il loro default e i valori run time nell'area Variables. 

6 ckica su OK. 

Copiare un recordset su un'altra pagina 

Puoi copiare un recordset da una pagina all'altra nel tuo sito. 

Per copiare un recordset su un'altra pagina: 

1 seleziona il recordset nel pannello Data Bindings o nel pannello Server Behaviors. 

2 clicka sul bottone della freccia in alto a destra del pannello e scegli Copy dal pop-up menu. 

3 apri l'altra pagina. 

4 clicka sul bottone della freccia in alto a destra del pannello Data Bindings o del pannello Server Behaviors, e scegli Paste dal pop-up menu. 

Editare o cancellare un recordset come una sorgente di dati 

Puoi editare o cancellare qualsiasi recordset nell'elenco dei dati sorgente disponibile sulla tua pagina, ovvero, ogni recordset elencato nel pannello Data Bindings. 

Per esempio, supponi di visualizzare i numeri dei telefoni cellulari del tuo staff alle vendite su una pagina dei risultati. Se il tuo recordset esistente non ha una colonna che elenca i numeri cellulari, devi cambiare la sua definizione per includerne uno. 

Editare o cancellando un recordset nel pannello Data Bindings non edita o cancella qualsiasi esempio di quel recordset sulla pagina. Lo edita soltanto o lo cancella come una possibile sorgente di dati per la pagina.  

Per editare un recordset nel pannello Data Bindings: 

1 nel pannello Data Bindings, un doppio click sul nome del recordset che vuoi editare. 

2 fai le tue modifiche nel dialog box Recordset semplice o avanzato. 

3 clicka sul bottone Test per vedere i contenuti del recordset aggiornato, poi ckica su OK per chiudere il recordset di prova. 

4 se sei soddisfatto del tuo lavoro, ckica su OK. 

Per cancellare un recordset nel pannello Data Bindings: 

1 sia nel pannello Data Bilding che sul pannello Server Behavior, seleziona il recordset che vuoi cancellare. 

2 clicka sul bottone Minus (-) .