Utilizzo di componenti ColdFusion in Dreamweaver

I file dei componenti ColdFusion (CFC) consentono di incorporare la logica aziendale e quella dell'applicazione in unità autonome e riutilizzabili, nonché di creare servizi Web in modo semplice e rapido.

Un componente CFC è un'unità software riutilizzabile scritta in linguaggio CFML (ColdFusion Markup Language), che facilita il riutilizzo e la gestione del codice.

Dreamweaver supporta l'uso dei componenti CFC. Per informazioni sui tag e sulla sintassi CFC, consultate la documentazione di ColdFusion disponibile in Dreamweaver (Aiuto > Uso di ColdFusion).

I CFC forniscono agli sviluppatori un metodo semplice ma potente per incorporare gli elementi dei siti Web. Generalmente, i componenti vengono utilizzati per la logica aziendale o quella dell'applicazione, mentre i tag personalizzati per elementi di presentazione come saluti personalizzati, menu dinamici e così via.

Come nel caso di molti altri tipi di elementi, nei siti dinamici è spesso possibile fare uso di parti intercambiabili. Ad esempio, è possibile che un sito dinamico esegua ripetutamente la stessa query o ricalcoli il prezzo totale delle pagine del carrello della spesa ogni volta che viene aggiunto un articolo. Queste operazioni possono essere gestite dai componenti. Potete correggere, migliorare, estendere e perfino sostituire un componente con ripercussioni minime sul resto dell'applicazione.

Supponete che un negozio Web calcoli i costi di spedizione in base al prezzo degli ordini. Per ordini inferiori a $20, il costo di spedizione ammonta a $4; per ordini compresi tra $20 e $40, il costo di spedizione ammonta a $6 e così via. Potete inserire la logica per il calcolo dei costi di spedizione sia nella pagina del carrello della spesa che in quella del pagamento, ma in questo caso il codice di presentazione HTML e quello della logica CFML verrebbero mischiati, rendendo probabilmente il codice difficile da gestire e riutilizzare.

Decidete quindi di creare un componente CFC denominato Prezzo che dispone, tra le altre, di una funzione chiamata CostoSpedizione. La funzione considera un prezzo come un argomento e restituisce un costo di spedizione. Ad esempio, se il valore dell'argomento è 32.80, la funzione restituisce 6.

Nella pagina del carrello della spesa e in quella del pagamento inserite un tag speciale per richiamare la funzione CostoSpedizione. Quando la pagina viene richiesta, la funzione viene richiamata e alla pagina viene restituito un costo di spedizione.

Successivamente, il negozio annuncia una promozione speciale: spedizione gratuita per tutti gli ordini superiori a $100. Modificando le aliquote in un solo punto (la funzione CostoSpedizione del componente Prezzo), in tutte le pagine che utilizzano la funzione si otterranno automaticamente costi di spedizione accurati.

Panoramica sul pannello Componenti (ColdFusion)

Utilizzate il pannello Componenti CF (Finestra > Componenti) per visualizzare e modificare i componenti ColdFusion e per aggiungere alla pagina codice che richiama la funzione quando viene richiesta la pagina CFM.

Creare o eliminare un CFC in Dreamweaver

Dreamweaver consente di definire visivamente un CFC e le relative funzioni. Dreamweaver crea un file .cfc e inserisce automaticamente i tag CFML necessari.

Visualizzare i CFC in Dreamweaver

Dreamweaver consente di esaminare visivamente i componenti ColdFusion (CFC) che si trovano nella cartella del sito o sul server. Dreamweaver legge i file CFC e visualizza le relative informazioni in una vista ad albero di facile navigazione nel pannello Componenti.

Dreamweaver cerca i componenti sul server di prova (vedete Connessione al database in Dreamweaver). Se create nuovi CFC o modificate CFC esistenti, ricordatevi di caricare i file CFC corrispondenti sul server di prova, in modo che siano correttamente visualizzati nel pannello Componenti.

Per visualizzare componenti presenti su un altro server, modificate le impostazioni del server di prova.

Potete visualizzare le informazioni seguenti sui componenti CF:

• Elencate tutti i componenti ColdFusion definiti sul server.

• Se utilizzate ColdFusion MX 7 o successivo, filtrate l'elenco in modo da visualizzare solo i CFC che si trovano nella cartella del sito.

• Esplorate le funzioni e gli argomenti di ciascun componente.

• Analizzate le proprietà delle funzioni che fungono da servizi Web.

Per visualizzare i CFC in Dreamweaver, procedete nel modo seguente:

Modificare i CFC in Dreamweaver

Dreamweaver consente di modificare facilmente il codice dei componenti ColdFusion definiti per il sito. Ad esempio, potete aggiungere, modificare o eliminare qualsiasi funzione di un componente senza uscire da Dreamweaver.

Per utilizzare questa funzione, è necessario che l'ambiente di sviluppo sia impostato nel modo seguente:

• ColdFusion deve essere eseguito localmente.

• Nella scheda Avanzate della finestra di dialogo Definizione del sito di Dreamweaver, il tipo di accesso specificato nella categoria Server di prova deve essere Locale/rete.

• Nella scheda Avanzate della finestra di dialogo Definizione del sito, il percorso della cartella principale locale deve essere lo stesso della cartella del server di prova (ad esempio, c:\Inetpub\wwwroot\progetti_cf\nuovaApplicaz\). Potete esaminare e modificare questi percorsi selezionando Sito > Modifica siti.

• Il componente deve essere memorizzato nella cartella del sito locale o in una delle sue sottocartelle sul disco rigido.

Aprite una pagina di ColdFusion in Dreamweaver e visualizzate i componenti nel pannello Componenti. Per visualizzare i componenti, aprite il pannello Componenti (Finestra > Componenti), selezionate Componenti CF dal menu a comparsa del pannello e fate clic sul pulsante Aggiorna.

Poiché ColdFusion viene eseguito localmente, Dreamweaver visualizza i pacchetti di componenti presenti sul disco rigido.

Utilizzate la procedura seguente per modificare un componente.

Creare pagine Web che utilizzano i CFC

Un metodo per utilizzare una funzione di un componente in una pagina Web consiste nello scrivere del codice che richiami la funzione quando la pagina viene richiesta. Dreamweaver facilita la scrittura di tale codice.

Definire un recordset in un CFC

Dreamweaver può essere utilizzato per definire un recordset (noto anche come “query ColdFusion”) in un componente ColdFusion (CFC). Se definite un recordset in un CFC, non dovete definirlo su ogni pagina che lo utilizza, bensì è sufficiente definirlo una volta nel CFC e utilizzare il CFC su più pagine.

Uso di un recordset CFC come origine di contenuto dinamico

Potete utilizzare un componente ColdFusion (CFC) come origine di contenuto dinamico per le pagine, se il componente contiene una funzione che definisce un recordset.

Definire contenuto dinamico mediante un CFC

Potete definire un recordset come origine di contenuto dinamico in Dreamweaver utilizzando un CFC che contiene una definizione di recordset.

1. Nella casella Nome, inserite il nome del recordset CFC.

In genere è consigliabile aggiungere il prefisso rs ai nomi dei recordset per distinguerli dai nomi degli altri oggetti all'interno del codice, ad esempio: rsPressRelease.

I nomi di recordset possono contenere solo caratteri alfanumerici e trattini di sottolineatura (_). I nomi non possono contenere caratteri speciali o spazi.

2. Selezionate un pacchetto tra quelli già definiti sul server.

Se il pacchetto non compare nel menu a comparsa, potete aggiornare l'elenco dei pacchetti facendo clic sul pulsante Aggiorna accanto al menu.

Accertatevi di aver dapprima caricato i CFC sul server di prova. Solo i CFC che si trovano sul server di prova vengono visualizzati.

3. Selezionate un componente tra quelli definiti nel pacchetto selezionato.

Se il menu a comparsa Componente non contiene alcun componente, oppure se nessuno dei componenti creati in precedenza compare nel menu, caricate i file CFC sul server di prova.

4.(Opzionale) Per creare un componente, fate clic sul pulsante Crea nuovo componente.

a. Nella casella Nome, inserite il nome del nuovo CFC. Il nome può contenere solo caratteri alfanumerici e trattini di sottolineatura (_).

b. Nella casella Directory componente, inserite il percorso del CFC oppure fate clic su Sfoglia per individuarlo.

5. Nel menu a comparsa Funzione, selezionate la funzione che contiene la definizione del recordset.

Il menu a comparsa Funzione contiene solo le funzioni definite nel componente attualmente selezionato. Se nel menu non compare alcuna funzione, oppure se le ultime modifiche non risultano applicate nelle funzioni elencate, controllate che le ultime modifiche siano state correttamente salvate e caricate sul server.

6. Utilizzando il pulsante Modifica, modificate ogni parametro (tipo, valore e valore predefinito) che deve essere passato come argomento di funzione.

a. Inserite un valore per il parametro corrente selezionando il tipo di valore dal menu a comparsa Valore e digitando il valore nella casella a destra. Il tipo di valore può essere un parametro URL, una variabile di modulo, un cookie, una variabile di sessione, una variabile di applicazione o un valore inserito.

b. Inserite un valore predefinito per il parametro nella casella Valore predefinito. Se non viene restituito un valore runtime, viene utilizzato il parametro predefinito.

c. Fate clic su OK.  

Non è possibile modificare la connessione di database e la query SQL per il recordset. Questi campi sono sempre disabilitati; il loro contenuto è visualizzato a solo scopo informativo.

7. Fate clic su Prova per connettervi al database e creare un'istanza del recordset.

Se l'istruzione SQL contiene parametri di pagina, verificate che la colonna Valore predefinito della casella Parametri contenga valori di prova validi prima di fare clic su Prova.

Se la query è stata eseguita correttamente, viene visualizzata una tabella con il recordset. Ciascuna riga contiene un record, mentre ciascuna colonna rappresenta un campo del record.

Fate clic su OK per cancellare la query CFC.

8. Fate clic su OK.