Aggiungere comportamenti server personalizzati in Dreamweaver

Comportamenti server personalizzati

Dreamweaver include un set di comportamenti server integrati che ti consente di aggiungere facilmente funzionalità dinamiche a una sede. Puoi estendere le funzionalità di Dreamweaver creando comportamenti server per soddisfare le tue esigenze di sviluppo o ottenendo comportamenti server dal sito Dreamweaver Exchange.

Prima di creare i tuoi comportamenti server, dovresti controllare il sito web Dreamweaver Exchange per vedere se terze parti hanno già creato un comportamento server che fornisce la funzionalità che vorresti aggiungere al tuo sito web. Spesso, uno sviluppatore di terze parti ha creato e testato un comportamento del server che soddisfa le tue esigenze.

Accesso a Dreamweaver Exchange

Installa un comportamento server o un'altra estensione in Dreamweaver

Flusso di lavoro dei comportamenti server personalizzati

Se sei uno sviluppatore web esperto in ColdFusion, JavaScript, VBScript o PHP, puoi scrivere i tuoi comportamenti server. I passaggi per creare un comportamento server includono le seguenti attività:

• Scrivi uno o più blocchi di codice che eseguono l'azione richiesta.

• Specifica dove il blocco di codice deve essere inserito all'interno del codice HTML della pagina.

• Se il comportamento del server richiede che venga specificato un valore per un parametro, crea una finestra di dialogo che chieda allo sviluppatore web che applica il comportamento di fornire un valore appropriato.

• Verificare il comportamento server prima di renderlo disponibile ad altri.

Utilizzare la funzione Creazione comportamenti server

Usa il Server Behavior Builder per aggiungere il blocco o i blocchi di codice che il comportamento inserisce in una pagina.

Opzioni avanzate

Dopo aver specificato il codice sorgente e la posizione di inserimento per ogni blocco di codice, il comportamento server è completamente definito.Nella maggior parte dei casi, non è necessario specificare ulteriori informazioni.

Se sei un utente avanzato, puoi impostare una qualsiasi delle seguenti opzioni:

Specifica se il blocco di codice deve essere trattato come un identificatore.

Per impostazione predefinita, ogni blocco di codice è un identificatore. Se Dreamweaver trova un blocco di codice identificatore in un punto qualsiasi di un documento, elenca il comportamento nel pannello Comportamenti server. Usa l'opzione Identificatore per specificare se il blocco di codice deve essere trattato come un identificatore.

Almeno uno dei blocchi di codice del comportamento server deve essere un identificatore.Un blocco di codice non deve essere un identificatore se si applica una delle seguenti condizioni: lo stesso blocco di codice è usato da qualche altro comportamento server; oppure il blocco di codice è così semplice che potrebbe apparire naturalmente nella pagina.

Specifica il titolo del comportamento nel pannello Comportamenti server.

Quando il designer della pagina fa clic sul pulsante Più (+) nel pannello Comportamenti server, il titolo del nuovo comportamento server apparirà nel menu a comparsa.Quando un designer applica un'istanza di un comportamento server a un documento, il comportamento appare nell'elenco dei comportamenti applicati nel pannello Comportamenti server.Usa la casella Titolo comportamento server per specificare i contenuti del menu a comparsa Più (+) e l'elenco dei comportamenti applicati.

Il valore iniziale nella casella è il nome che hai fornito nella finestra di dialogo Nuovo comportamento server.Man mano che vengono definiti i parametri, il nome viene aggiornato automaticamente in modo che i parametri appaiano tra parentesi dopo il nome del comportamento server.

Imposta variabile sessione (@@Name@@, @@Value@@)

Se l'utente accetta il valore predefinito, tutto quello che precede le parentesi appare nel menu a comparsa Più (+) (ad esempio, Imposta variabile di sessione).Il nome più i parametri appariranno nell'elenco dei comportamenti applicati, ad esempio, Imposta Variabile sessione ("abcd", "5").

Specifica quale blocco di codice viene selezionato quando l'utente seleziona il comportamento nel pannello Comportamenti server.

Quando applichi un comportamento server, uno dei blocchi di codice all'interno del comportamento viene designato come "blocco di codice da selezionare". Se applichi il comportamento server e poi selezioni il comportamento nel pannello Comportamenti server, il blocco designato viene selezionato nella finestra Documento. Per impostazione predefinita, Dreamweaver seleziona il primo blocco di codice che non si trova sopra il tag html. Se tutti i blocchi di codice si trovano sopra il tag html, viene selezionato il primo. Gli utenti avanzati possono specificare quale blocco di codice è quello selezionato.

Creare blocchi di codice

I blocchi di codice che crei nel Server Behavior Builder sono incapsulati in un comportamento server che appare nel pannello Comportamenti server.Il codice può essere qualsiasi codice di runtime valido per il modello server specificato. Ad esempio, se scegli ColdFusion come tipo di documento per il tuo comportamento server personalizzato, il codice che scrivi deve essere codice ColdFusion valido che viene eseguito su un server applicazioni ColdFusion.

Puoi creare i blocchi di codice direttamente nel Generatore di comportamenti server oppure copiare e incollare il codice da altre fonti. Ogni blocco di codice che crei nel Generatore di comportamenti server deve essere un singolo tag o blocco script.Se devi inserire più blocchi tag, dividili in blocchi di codice separati.

Condizioni nei blocchi di codice

Dreamweaver ti consente di sviluppare blocchi di codice che incorporano istruzioni di controllo eseguite condizionalmente. Il Generatore di comportamenti server utilizza le istruzioni if, elseif e else, e può contenere anche parametri di comportamento server. Questo ti consente di inserire blocchi di testo alternativo basati sui valori delle condizioni OR tra i parametri di comportamento del server.

Il seguente esempio mostra le istruzioni if, elseif e else. Le parentesi quadre ([ ]) indicano codice opzionale e l'asterisco (*) indica zero o più istanze. Per eseguire una parte di un blocco di codice o l'intero blocco di codice solo se si verifica una determinata condizione o più condizioni, utilizza la seguente sintassi:

<@ if (expression1) @> conditional

text1[<@ elseif (expression2) @> conditional text2]*[<@ else @>

conditional text3]<@ endif @>

Le espressioni condizione possono essere qualsiasi espressione JavaScript che può essere valutata utilizzando la funzione JavaScript eval(), e possono includere un parametro di comportamento server contrassegnato da @@. (I @@ distinguono il parametro dalle variabili e parole chiave JavaScript.)

Uso efficace delle espressioni condizionali

Quando utilizzi le direttive if, else e elseif all'interno del tag XML insertText, il testo partecipante viene pre-elaborato per risolvere le direttive if e determinare quale testo includere nel risultato. Le direttive if e elseif prendono l'espressione come argomento. L'espressione di condizione è identica a quella delle espressioni di condizione JavaScript e può contenere anche parametri di comportamento del server.Le direttive come questa ti consentono di scegliere tra blocchi di codice alternativi in base ai valori dei parametri di comportamento del server o alle relazioni tra di essi.

Ad esempio, il seguente codice JSP proviene da un comportamento server Dreamweaver che utilizza un blocco di codice condizionale:

@@rsName@@.close();

<@ if (@@callableName@@ != '') @>

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();<@ else @>

@@rsName@@ = Statement@@rsName@@.executeQuery();

<@ endif @>

@@rsName@@_hasData = @@rsName@@.next();

Il blocco di codice condizionale inizia con <@ if (@@callableName@@ != '') @> e termina con <@ endif @>. Secondo il codice, se l'utente inserisce un valore per il parametro @@callableName@@ nella finestra di dialogo Parametro del comportamento server, in altre parole, se il valore del parametro @@callableName@@ non è null, o (@@callableName@@ != '')—allora il blocco di codice condizionale viene sostituito con le seguenti istruzioni:

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();

Altrimenti, il blocco di codice viene sostituito con la seguente istruzione:

@@rsName@@ = Statement@@rsName@@.executeQuery();

Posizionare un blocco di codice

Quando crei blocchi di codice utilizzando Server Behavior Builder, devi specificare dove inserirli nel codice HTML della pagina.

Ad esempio, se inserisci un blocco di codice sopra il tag di apertura <html>, devi quindi specificare la posizione del blocco di codice relativa ad altri tag, script e comportamenti server in quella sezione del codice HTML della pagina. Esempi tipici includono il posizionamento di un comportamento prima o dopo eventuali richieste recordset che potrebbero esistere anche nel codice di pagina sopra il tag di apertura <html>.

Quando selezioni un'opzione di posizionamento dal menu a comparsa Inserisci codice, le opzioni disponibili nel menu a comparsa Posizione relativa cambiano per fornire opzioni rilevanti per quella parte della pagina. Ad esempio, se selezioni Sopra il tag <html> nel menu a comparsa Inserisci codice, le opzioni di posizionamento disponibili nel menu a comparsa Posizione relativa riflettono scelte rilevanti per quella parte della pagina.

La seguente tabella mostra le opzioni di inserimento dei blocchi di codice e le opzioni di posizionamento relativo disponibili per ciascuna:

Per specificare una posizione personalizzata, devi assegnare un peso al blocco di codice.Utilizza l'opzione Posizione personalizzata quando devi inserire più di un blocco di codice in un ordine particolare. Ad esempio, per inserire una serie ordinata di tre blocchi di codice dopo i blocchi di codice che aprono i recordset, inserisci un peso di 60 per il primo blocco, 65 per il secondo e 70 per il terzo.

Per impostazione predefinita, Dreamweaver assegna un peso di 50 a tutti i blocchi di codice di apertura recordset inseriti sopra il tag <html>.Se lo spessore di due o più blocchi corrisponde, Dreamweaver imposta\ncasualmente l'ordine tra i blocchi.

Posiziona un blocco di codice (istruzioni\ngenerali)

Posiziona un blocco di codice rispetto a un altro tag nella pagina

Posiziona un blocco di codice relativo\na un tag selezionato dal progettista della pagina

Ripetere blocchi di codice mediante direttiva loop

Per ripetere una porzione di un blocco di codice o l'intero blocco\ndi codice un certo numero di volte, usa la seguente sintassi:

<@ loop (@@param1@@,@@param2@@) @> codice

blocco<@ endloop @>

Quando crei comportamenti server, puoi utilizzare costrutti di loop per ripetere un blocco di codice un numero specificato di volte. <@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> blocco di codice <@ endloop @>La direttiva loop accetta un elenco separato da virgole di array di parametri come argomenti. In questo caso, gli argomenti dell'array di parametri consentono a un utente di fornire valori multipli per un singolo parametro. Il testo ripetuto viene duplicato n volte, dove n è la lunghezza degli argomenti dell'array di parametri. Se viene specificato più di un argomento di array di parametri, tutti gli array devono avere la stessa lunghezza. Alla i-esima valutazione del ciclo, gli i-esimi elementi degli array di parametri sostituiscono le istanze di parametri associate nel blocco di codice.

Quando crei una finestra di dialogo per il comportamento server, puoi aggiungere un controllo alla finestra di dialogo che consente al progettista di pagine di creare array di parametri. Dreamweaver include un controllo array semplice che puoi utilizzare per creare finestre di dialogo. Questo controllo, chiamato Text Field Comma Separated List, è disponibile tramite Server Behavior Builder. Per creare elementi dell'interfaccia utente di maggiore complessità, consulta la documentazione API per creare una finestra di dialogo con un controllo per creare array (ad esempio, un controllo griglia).

Puoi nidificare qualsiasi numero di condizionali o una direttiva loop all'interno di una direttiva condizionale. Ad esempio, puoi specificare che se un'espressione è vera per eseguire un loop.

L'esempio seguente mostra come tali blocchi di codice ripetuti possano essere utilizzati per creare comportamenti server (l'esempio è un comportamento ColdFusion utilizzato per accedere a una stored procedure):

<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> blocco di codice

<@ endloop @>

<CFSTOREDPROC procedure="AddNewBook"

datasource=#MM_connection_DSN#

username=#MM_connection_USERNAME#

password=#MM_connection_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryID#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

In questo esempio, il tag CFSTOREDPROC può includere zero o più tag CFPROCPARAM. Tuttavia, senza il supporto per la direttiva loop, non esiste alcun modo per includere i tag CFPROCPARAM all'interno del tag CFSTOREDPROC inserito. Se questo dovesse essere creato come comportamento del Server senza l'uso della direttiva loop, sarebbe necessario dividere questo esempio in due partecipanti: un tag CFSTOREDPROC principale, e un tag CFPROCPARAM il cui tipo di partecipante è multiplo.

Utilizzando la direttiva loop, puoi scrivere la stessa procedura come segue:

<CFSTOREDPROC procedure="@@procedure@@"

datasource=#MM_@@conn@@_DSN#

username=#MM_@@conn@@_USERNAME#

password=#MM_@@conn@@_PASSWORD#>

<@ loop (@@paramName@@,@@value@@,@@type@@) @>

<CFPROCPARAM type="IN"

dbvarname="@@paramName@@"

value="@@value@@"

cfsqltype="@@type@@">

<@ endloop @>

</CFSTOREDPROC>

Se l'utente ha inserito i seguenti valori dei parametri nella finestra di dialogo Server Behavior Builder:

procedure = "proc1"

conn = "connection1"

paramName = ["@CategoryId", "@Year", "@ISBN"]

value = ["#Form.CategoryId#", "#Form.Year#", "#Form.ISBN#"]

type = ["CF_SQL_INTEGER", "CF_SQL_INTEGER", "CF_SQL_VARCHAR"]

Il comportamento del Server inserirebbe il seguente codice di runtime nella pagina:

<CFSTOREDPROC procedure="proc1"

datasource=#MM_connection1_DSN#

username=#MM_connection1_USERNAME#

password=#MM_connection1_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryId#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@Year" value="#Form.Year#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

Uso delle variabili di direttiva loop _length e _index

La direttiva di ciclo include due variabili integrate che puoi usare per le condizioni if incorporate. Le variabili sono: _length e _index. La variabile _length valuta la lunghezza degli array elaborati dalla direttiva di ciclo, mentre la variabile _index valuta l'Indice corrente della direttiva di ciclo. Per assicurarti che le variabili vengano riconosciute solo come direttive e non come parametri da passare nel ciclo, non racchiudere nessuna delle due variabili tra @@.

Un esempio di utilizzo delle variabili integrate consiste nell'applicarle all'attributo import della direttiva di pagina. L'attributo import richiede la separazione con virgola dei pacchetti. Se la direttiva loop si estende attorno all'intero attributo import, dovresti inviare il nome dell'attributo import= solo alla prima iterazione del ciclo—questo include le virgolette di chiusura (")—e non inviare una virgola all'ultima iterazione del ciclo. Usando la variabile integrata, puoi esprimere questo come segue:

<@loop (@@Import@@)@>

<@ if(_index == 0)@>import="

<@endif@>@@Import@@<@if (_index == _length-1)@>"<@else@>,

<@ endif @>

<@endloop@>

Richiedere un parametro per il comportamento del server

I comportamenti del server spesso richiedono che il web designer fornisca un Valore di parametro. Questo valore deve essere inserito prima che il codice del comportamento del server venga inserito nella pagina.

Crei la finestra di dialogo definendo nel codice i parametri forniti dal designer.Quindi generi una finestra di dialogo per il comportamento del server che richiede al web designer un Valore di parametro.

Definire il parametro nel codice del comportamento server

Potete anche evidenziare la stringa e fare clic sul pulsante Inserisci parametro nel blocco di codice. Inserite un nome parametro e fate clic su OK. Dreamweaver sostituisce ogni occorrenza della stringa evidenziata con il nome parametro specificato, racchiuso fra indicatori di parametro.

Dreamweaver utilizza le stringhe racchiuse tra gli indicatori di parametro come etichette dei controlli della finestra di dialogo generata (consultate la procedura descritta di seguito). Nell’esempio precedente Dreamweaver crea una finestra di dialogo con la seguente etichetta:

Crea una finestra di dialogo per il comportamento del server per richiedere il valore del parametro

Visualizzare la finestra di dialogo

Modifica la finestra di dialogo creata per il comportamento server

Modificare i comportamenti server

Puoi modificare qualsiasi comportamento server creato con Server Behavior Builder, inclusi i comportamenti server scaricati dal sito web Dreamweaver Exchange e da altri sviluppatori di terze parti.

Se applichi un comportamento server a una pagina e poi modifichi il comportamento in Dreamweaver, le istanze del comportamento precedente non vengono più visualizzate nel pannello Comportamenti Server. Il pannello Comportamenti Server cerca nella pagina il codice che corrisponde al codice dei comportamenti server noti. Se il codice di un comportamento server cambia, il pannello non riconosce le versioni precedenti del comportamento in quella pagina.

Mantieni le versioni precedenti e nuove del comportamento nel pannello

Modifica il codice di un comportamento server creato con Server Behavior Builder

Indicazioni per la codifica

In generale, il codice del tuo comportamento server dovrebbe essere compatto e robusto. Gli sviluppatori di applicazioni web sono molto sensibili al codice aggiunto alle loro pagine. Segui le pratiche di codifica generalmente accettate per il linguaggio del tipo di documento (ColdFusion, JavaScript, VBScript o PHP). Quando scrivi commenti, considera i diversi pubblici tecnici che potrebbero aver bisogno di comprendere il codice, come web e interaction designer, o altri sviluppatori di applicazioni web. Includi commenti che descrivano con precisione lo scopo del codice e qualsiasi istruzione speciale per includerlo in una pagina.

Tieni presente le seguenti linee guida di codifica quando crei comportamenti server:

Un aspetto molto importante. Il codice del comportamento server dovrebbe gestire i casi di errore con eleganza. È necessario cercare di prevedere ogni possibilità. Ad esempio, cosa succede se una richiesta di parametro fallisce? Cosa succede se non vengono restituiti record da una query?

Aiuta a garantire che il codice sia chiaramente identificabile ed evita conflitti di nomi con il codice esistente. Ad esempio, se la pagina contiene una funzione chiamata hideLayer() e una variabile globale chiamata ERROR_STRING, e il comportamento server inserisce codice che usa anche quei nomi, il comportamento server potrebbe entrare in conflitto con il codice esistente.

Ti consente di identificare le tue funzioni di runtime e variabili globali in una pagina. Per convenzione si possono usare le proprie iniziali. Non usare mai il prefisso MM_, poiché è riservato esclusivamente all'uso di Dreamweaver. Dreamweaver antepone a tutte le funzioni e variabili globali il prefisso MM_ per impedire che entrino in conflitto con qualsiasi codice che scrivi.

var MM_ERROR_STRING = "...";

function MM_hideLayer() {

in modo che il codice che scrivi non assomigli troppo al codice di altri blocchi. Se un blocco di codice assomiglia troppo a un altro blocco di codice sulla pagina, il pannello Server Behaviors potrebbe erroneamente identificare il primo blocco di codice come istanza del secondo blocco di codice (o viceversa). Una soluzione semplice è aggiungere un commento a un blocco di codice per renderlo più unico.

Verificare i comportamenti server

Dreamweaver Exchange raccomanda di eseguire i seguenti test su ogni server behavior che crei:

• Applicare il comportamento dal pannello Comportamenti server. Se ha una finestra di dialogo, inserisci dati validi in ogni campo e fai clic su OK. Controllare che non si verifichino errori quando si applica il comportamento. Verifica che il codice di runtime per il server behavior appaia nel Code inspector.

• Applica nuovamente il server behavior e inserisci dati non validi in ogni campo della finestra di dialogo. Prova a lasciare il campo vuoto, usando numeri grandi o negativi, usando caratteri non validi (come /, ?, :, *, e così via), e usando lettere nei campi numerici. Puoi scrivere routine di convalida dei moduli per gestire dati non validi (le routine di convalida richiedono codifica manuale, che va oltre l'ambito di questo libro).

  Dopo aver applicato con successo il server behavior alla pagina, verifica quanto segue:

• Controlla il pannello Server Behaviors per assicurarti che il nome del server behavior appaia nell'elenco dei behavior aggiunti alla pagina.

• Se applicabile, verifica che le icone degli script lato server appaiano sulla pagina. Le icone generiche dello script server-side sono degli scudetti dorati. Per vedere le icone, abilita Elementi invisibili (View > Visual Aids > Invisible Elements).

• Nella vista Codice (View > Code), verifica che non venga generato codice non valido.

  Inoltre, se il comportamento del server inserisce codice nel documento stabilendo una connessione a un database, crea un database di test per testare il codice inserito nel documento.Verifica la connessione definendo query che producono set di dati diversi e di dimensioni diverse.

  Infine, carica la pagina sul server e aprila in un browser. Visualizza il codice sorgente HTML della pagina e verifica che non sia stato generato HTML non valido dagli script lato server.