Definire le origini di contenuto dinamico

Ultimo aggiornamento il 25 apr 2024
Nota

L’interfaccia utente di Dreamweaver e versioni successive è stata semplificata. Di conseguenza, potreste non trovare alcune delle opzioni descritte in questo articolo in Dreamweaver e versioni successive. Per ulteriori informazioni, consultate questo articolo.

Definire un recordset senza scrivere SQL

Crea un recordset senza inserire manualmente le istruzioni SQL.

Nella finestra Documento, apri la pagina che utilizzerà il recordset.
Seleziona Finestra > Associazioni per visualizzare il pannello Associazioni.
Nel pannello Associazioni, fai clic sul pulsante Più (+) e seleziona Recordset (Richiesta) dal menu a comparsa.

Viene visualizzata la finestra di dialogo Recordset semplice. Se stai sviluppando un sito ColdFusion, la finestra di dialogo Recordset è leggermente diversa. (Se compare invece la finestra di dialogo Recordset avanzata, fai clic sul pulsante Semplice per passare alla finestra di dialogo Recordset semplice.)

Compilare la sezione della finestra di dialogo Recordset relativa al tipo di documento richiesto.

Per istruzioni, vedete gli argomenti seguenti.

Fai clic sul pulsante Test per eseguire la query e assicurarti che recuperi le informazioni che desideri.

Se hai definito un filtro che utilizza parametri inseriti dagli utenti, immetti un valore nella casella Valore test e fai clic su OK.Se un'istanza del recordset viene creata correttamente, compare una tabella che visualizza i dati estratti dal recordset.

Fai clic su OK per aggiungere il recordset all'elenco delle origini contenuto disponibili nel pannello Associazioni.

Opzioni per la finestra di dialogo Recordset semplice (PHP, ASP)

Nella casella Nome, inserisci un nome per il recordset.

È prassi comune aggiungere il prefisso rs ai nomi dei recordset per distinguerli dagli altri nomi di oggetto nel codice, ad esempio: rsPressReleases.

I nomi dei recordset possono contenere solo lettere, numeri e il carattere underscore (_). I nomi non possono contenere caratteri speciali o spazi.

Selezionate una connessione dal menu a comparsa Connessione.

Se nessuna connessione compare nell'elenco, fai clic su Definisci per crearne una.

Nel menu a comparsa Tabella, seleziona la tabella del database che fornirà i dati al recordset.

Il menu a comparsa visualizza tutte le tabelle nel database specificato.

Per includere un sottoinsieme delle colonne della tabella nel recordset, fai clic su Selezionato e scegli le colonne desiderate tenendo premuto Ctrl e facendo clic (Windows) o tenendo premuto Comando e facendo clic (Macintosh) su di esse nell'elenco.

Per limitare ulteriormente i record restituiti dalla tabella, completa la sezione Filtro:

  • Dal primo menu a comparsa, seleziona una colonna nella tabella del database da confrontare con un valore di test che definisci.

  • Dal secondo menu a comparsa, seleziona un'espressione condizionale per confrontare il Valore selezionato in ogni record con il Valore test.

  • Dal terzo menu a comparsa, selezionate Valore inserito.

  • Nella casella, inserite il valore di prova.

    Se il valore specificato in un record soddisfa la condizione di filtro, il record viene incluso nel recordset.

(Facoltativo) Per ordinare i record, seleziona una colonna per cui ordinare, e quindi specifica se i record devono essere ordinati in ordine crescente (1, 2, 3... o A, B, C...) o in ordine decrescente.

Fai clic su Test per connetterti al database e creare un'istanza dell'origine dati, quindi fai clic su OK per chiudere l'origine dati.

Viene visualizzata una tabella con i dati restituiti. Ogni riga contiene un record e ogni colonna rappresenta un campo di tale record.

Fate clic su OK. Il recordset appena definito appare nel pannello Associazioni.

Opzioni per la finestra di dialogo Recordset semplice (ColdFusion)

Definisci un recordset per i tipi di documento ColdFusion come origine di contenuto dinamico senza dover scrivere manualmente istruzioni SQL.

Nella casella Nome, inserisci un nome per il recordset.

È pratica comune aggiungere il prefisso rs ai nomi dei recordset per distinguerli dagli altri nomi di oggetti nel codice. Ad esempio: rsPressReleases

I nomi dei recordset possono contenere solo lettere, numeri e il carattere di sottolineatura (_). I nomi non possono contenere caratteri speciali o spazi.

Se stai definendo un recordset per un componente ColdFusion (ovvero se un file CFC è attualmente aperto in Dreamweaver), seleziona una funzione CFC esistente dal menu a comparsa Funzione oppure fai clic sul pulsante Nuova funzione per creare una nuova funzione.

Nota

Il menu a comparsa Funzione è disponibile solo se un file CFC è il documento corrente e hai accesso a un computer che esegue ColdFusion MX 7 o versione successiva.

Il recordset è definito nella funzione.

Selezionate un’origine dati dal menu a comparsa Origine dati.

Se nessuna origine dati viene visualizzata nel menu a comparsa, devi creare un'origine dati ColdFusion.

Nelle caselle Nome utente e Password, inserisci il nome utente e la password per il server applicazioni ColdFusion, se necessari.

Le origini dati in ColdFusion potrebbero richiedere nome utente e password per accedervi. Se non hai il nome utente e la password per accedere a un'origine dati in ColdFusion, contatta l'amministratore ColdFusion della tua organizzazione.

Nel menu a comparsa Tabella, seleziona la tabella del database che fornirà dati al recordset.

Il menu a comparsa Tabella visualizza tutte le tabelle nel database specificato.

Per includere un sottoinsieme delle colonne della tabella nel recordset, fai clic su Selezionate e scegli le colonne desiderate tenendo premuto Ctrl mentre fai clic (Windows) o Cmd mentre fai clic (Macintosh) nell'elenco.

Per limitare ulteriormente i record restituiti dalla tabella, completa la sezione Filtro:

  • Dal primo menu a comparsa, seleziona una colonna nella tabella del database da confrontare con un valore di test che definisci.

  • Dal secondo menu a comparsa, seleziona un'espressione condizionale per confrontare il valore selezionato in ogni record con il valore di test.

  • Dal terzo menu a comparsa, selezionate Valore inserito.

  • Nella casella, inserite il valore di prova.

    Se il valore specificato in un record soddisfa la condizione del filtro, il record viene incluso nel recordset.

(Facoltativo) Per ordinare i record, seleziona una colonna in base alla quale ordinare, quindi specifica se i record devono essere ordinati in ordine crescente (1, 2, 3... o A, B, C...) o ordine decrescente.

Fai clic su Test per connetterti al database e creare un'istanza dell'origine dati.

Viene visualizzata una tabella con i dati restituiti. Ogni riga contiene un record e ogni colonna rappresenta un campo in tale record. Fate clic su OK per chiudere il recordset di prova.

Fate clic su OK. Il recordset ColdFusion appena definito viene visualizzato nel pannello Binding.

Definisci un recordset avanzato scrivendo SQL

Scrivi le tue istruzioni SQL utilizzando la finestra di dialogo Recordset avanzato oppure crea un'istruzione SQL utilizzando l'albero grafico Elementi del database.

Nella finestra Documento, apri la pagina che utilizzerà il recordset.
Seleziona Finestra > Associazioni per visualizzare il pannello Associazioni.
Nel pannello Bindings, fai clic sul pulsante Più (+) e seleziona Recordset (Query) dal menu a comparsa.

Viene visualizzata la finestra di dialogo Recordset avanzata. Se stai sviluppando un sito ColdFusion, la finestra di dialogo Recordset è leggermente diversa. (Se invece viene visualizzata la finestra di dialogo Recordset semplice, passa alla finestra di dialogo Recordset avanzata facendo clic sul pulsante Avanzate.)

Compilate la finestra di dialogo Recordset avanzata.

Per istruzioni, vedete gli argomenti seguenti.

Fai clic sul pulsante Test per eseguire la richiesta e assicurarti che recuperi le informazioni desiderate.

Se hai definito un filtro che utilizza parametri immessi dagli utenti, il pulsante Test visualizza la finestra di dialogo Valore di test.Inserisci un valore nella casella Valore test e fai clic su OK. Se un'istanza del recordset viene creata correttamente, viene visualizzata una tabella con i dati del recordset.

Fai clic su OK per aggiungere il recordset all'elenco delle sorgenti di contenuto disponibili nel pannello Associazioni.

Opzioni per la finestra di dialogo Recordset avanzata (PHP, ASP)

Definisci un recordset come origine di contenuto dinamico scrivendo un'istruzione SQL personalizzata o creando un'istruzione SQL utilizzando l'albero grafico Elementi database.

Nella casella Nome, inserite il nome del recordset.

Una pratica comune è aggiungere il prefisso rs ai nomi dei recordset per distinguerli dagli altri nomi di oggetti nel codice. Ad esempio: rsPressReleases

I nomi dei recordset possono contenere solo lettere, numeri e il carattere underscore (_). Impossibile utilizzare caratteri speciali o spazi.

Selezionate una connessione dal menu a comparsa Connessione.
Inserisci un'istruzione SQL nell'area di testo SQL o utilizza l'albero grafico Elementi database nella parte inferiore della finestra di dialogo per generare un'istruzione SQL dal recordset selezionato.

Procedi come segue per utilizzare l'albero Elementi database per generare l'istruzione SQL:

  • Assicuratevi che l'area di testo SQL sia vuota.

  • Espandi i rami dell'albero finché non trovi l'oggetto database necessario, ad esempio una colonna in una tabella o una stored procedure nel database.

  • Seleziona l'oggetto database e fai clic su uno dei pulsanti sul lato destro dell'albero.

    Ad esempio, se selezioni una colonna di tabella, i pulsanti disponibili sono SELECT, WHERE e ORDER BY. Fai clic su uno dei pulsanti per aggiungere la clausola associata all'istruzione SQL.

    Puoi anche utilizzare un'istruzione SQL predefinita in una stored procedure selezionando la stored procedure dall'albero Elementi database e facendo clic sul pulsante Procedura.Dreamweaver compila automaticamente le aree SQL e Variabile.

Se l'istruzione SQL contiene variabili, definisci i loro valori nell'area Variabili facendo clic sul pulsante Più (+) e inserendo il nome della Variabile, il tipo (numero intero, testo, data o numero a virgola mobile), il Valore predefinito (il Valore che la Variabile dovrebbe assumere se non viene restituito alcun Valore di runtime) e il Valore di runtime.
Nota

Quando utilizzi variabili in un'istruzione SQL in PHP, Dreamweaver aggiunge automaticamente un segno del dollaro iniziale al nome della variabile, quindi ometti il segno del dollaro (ad esempio, colname, invece di $colname).

Se l'istruzione SQL contiene variabili, assicurati che la colonna Valore predefinito della casella Variabili contenga valori di test validi.

Il valore di runtime è solitamente un parametro URL o di modulo inserito da un utente in un campo del modulo HTML.

Parametri URL nella colonna Valore di runtime:

Modello server

Espressione del valore runtime per il parametro URL

ASP

Request.QueryString(“formFieldName”)

PHP

$_GET['formFieldName']

Parametri modulo nella colonna Valore runtime:

Modello server

Espressione del valore runtime per il parametro modulo

ASP

Request.Form(“formFieldName”)

PHP

$_POST[’formFieldName’]

Fai clic su test per collegarti al database e creare un'Istanza del recordset.

Se l'istruzione SQL contiene variabili, assicurati che la colonna Valore predefinito della casella Variabili contenga valori di test validi prima di fare clic su Test.

Se l'operazione va a buon fine, appare una tabella che visualizza i dati nel recordset. Ogni riga contiene un record e ogni colonna rappresenta un campo in quel record. Fai clic su OK per cancellare il recordset.

Se siete soddisfatti del risultato, fate clic su OK.

Opzioni per la finestra di dialogo Recordset avanzato (ColdFusion)

Utilizza la finestra di dialogo Recordset avanzato per scrivere richieste SQL personalizzate o utilizza l'albero Elementi database per creare richieste SQL utilizzando un'interfaccia point-and-click.

Nella casella Nome, inserite il nome del recordset.

Una pratica comune è aggiungere il prefisso rs ai nomi dei recordset per distinguerli da altri nomi di oggetti nel codice. Ad esempio: rsPressReleases

I nomi dei recordset possono contenere solo lettere, numeri e il carattere underscore (_). I nomi non possono contenere caratteri speciali o spazi.

Se stai definendo un recordset per un componente ColdFusion (ovvero se un file CFC è attualmente aperto in Dreamweaver), seleziona una funzione CFC esistente dal menu a comparsa Funzione oppure fai clic sul pulsante Nuova funzione per creare una nuova funzione.

Nota

Il menu a comparsa Funzione è disponibile solo se un file CFC è il documento corrente e hai accesso a un computer che esegue ColdFusion MX 7 o versione successiva.

Il recordset è definito nella funzione.

Selezionate un’origine dati dal menu a comparsa Origine dati.

Se nell'elenco del menu a comparsa non appare alcuna origine dati, è necessario prima creare un'origine dati ColdFusion.

Nelle caselle Nome utente e password, inserisci il nome utente e la password per il server dell'applicazione ColdFusion, se necessario.

Le origini dati in ColdFusion potrebbero richiedere un nome utente e una password per accedervi. Se non disponi del nome utente e della password per accedere a un'origine dati in ColdFusion, contatta l'amministratore ColdFusion della tua organizzazione.

Inserisci un'istruzione SQL nell'area di testo SQL o usa l'albero grafico Elementi di database nella parte inferiore della finestra di dialogo per generare un'istruzione SQL dal recordset scelto.
(Facoltativo) Procedi come segue per usare l'albero degli elementi del database per generare l'istruzione SQL:
  • Assicuratevi che l'area di testo SQL sia vuota.

  • Espandi i rami dell'albero fino a trovare l'oggetto database necessario, ad esempio una colonna in una tabella.

  • Seleziona l'oggetto database e fai clic su uno dei pulsanti sul lato destro dell'albero.

Ad esempio, se selezioni una colonna della tabella, i pulsanti disponibili sono Seleziona, Where e Ordina per.Fai clic su uno dei pulsanti per aggiungere la clausola associata alla tua istruzione SQL.

Se l'istruzione SQL contiene parametri, definisci i relativi valori nell'area Parametri facendo clic sul pulsante Più (+) e inserendo il nome del parametro e il valore predefinito (il valore che il parametro dovrebbe assumere se non viene restituito alcun valore in fase di esecuzione).

Se l'istruzione SQL contiene parametri, assicurati che la colonna Valore predefinito della casella Parametri contenga valori di test validi.

I Parametri pagina permettono di fornire valori predefiniti per i riferimenti ai valori di runtime nell'SQL che scrivi. Ad esempio, la seguente istruzione SQL seleziona un record del dipendente in base al valore dell'ID del dipendente.Puoi assegnare un valore predefinito a questo parametro, assicurandoti che venga sempre restituito un valore di runtime. In questo esempio, FormFieldName si riferisce a un campo del modulo in cui l'utente inserisce un ID dipendente:

SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))

La finestra di dialogo Aggiungi parametri pagina conterrebbe un'associazione nome-valore simile a:

Nome

Valori predefiniti

FormFieldName

0001

Il valore di runtime è solitamente un URL o un parametro di modulo inserito da un utente in un campo di modulo HTML.

Fai clic su Test per connetterti al database e creare un'istanza del recordset.

Se l'istruzione SQL contiene riferimenti di runtime, assicurati che la colonna Valore predefinito del campo Parametri pagina contenga valori di test validi prima di fare clic su Test.

Se l'operazione ha esito positivo, viene visualizzata una tabella che mostra i dati nel recordset.Ogni riga contiene un record e ogni colonna rappresenta un campo in quel record. Fai clic su OK per cancellare il recordset.

Se siete soddisfatti del risultato, fate clic su OK.

Definire parametri in un'istruzione SQL (ColdFusion)

Definisci parametri in un'istruzione SQL; il valore predefinito è il valore che il parametro dovrebbe usare se non viene restituito alcun valore di runtime.

Selezionate un nome di parametro dal menu a comparsa Nome.
Inserisci un valore predefinito per il parametro nella casella Parametro predefinito e fai clic su OK.

Definire parametri in un'istruzione SQL (PHP)

Definisci parametri in un'istruzione SQL; il valore predefinito è il valore che il parametro dovrebbe utilizzare se non viene restituito alcun valore in fase di esecuzione.

Inserite un nome di parametro nella casella Nome.
Immetti un valore predefinito per il parametro nella casella Parametro predefinito.
Immetti un valore in fase di esecuzione per un parametro nella casella Valore in fase di esecuzione e fai clic su OK.

Crea query SQL utilizzando l'albero Elementi database

Invece di digitare manualmente istruzioni SQL nella casella SQL, puoi utilizzare l'interfaccia point-and-click di Database Item per creare query SQL complesse.La struttura Elementi database consente di selezionare oggetti del database e collegarli utilizzando le clausole SQL SELECT, WHERE e ORDER BY.Dopo aver creato una richiesta SQL, puoi definire tutte le variabili utilizzando l'area Variabili della finestra di dialogo.

I due esempi successivi descrivono due istruzioni SQL e i passaggi per crearle utilizzando l'albero Elementi database della finestra di dialogo Recordset avanzata.

Esempio: Selezione di una tabella

Questo esempio seleziona l'intero contenuto della tabella Dipendenti. L'istruzione SQL che definisce la richiesta appare come segue:

SELECT * FROM Employees

Per creare questa richiesta, segui questi passaggi.

Espandi il ramo Tabelle per visualizzare tutte le tabelle nel database selezionato.
Selezionate la tabella Employees.
Fate clic sul pulsante Select.
Fate clic su OK per aggiungere il recordset al pannello Associazioni.

Esempio: Selezione di righe specifiche da una tabella e ordinamento dei risultati

Il seguente esempio seleziona due righe dalla tabella Dipendenti e seleziona il tipo di lavoro utilizzando una Variabile che devi definire. I risultati vengono quindi ordinati in base al nome del dipendente.

SELECT emplNo, emplName

FROM Employees

WHERE emplJob = 'varJob'

ORDER BY emplName

Espandi il ramo Tabelle per visualizzare tutte le tabelle nel database selezionato; quindi espandi la tabella Employees per visualizzare le singole righe della tabella.
Create l'istruzione SQL nel modo seguente:
  • Seleziona emplNo e fai clic sul pulsante Seleziona.

  • Seleziona emplName e fai clic sul pulsante Selezionare.

  • Seleziona emplJob, e fai clic sul pulsante Where.

  • Seleziona emplName e fai clic sul pulsante Order By.

Posiziona il punto di inserimento dopo WHERE emplJob nell'area di testo SQL e digita ='varJob' (includi il segno di uguale).
Definisci la Variabile 'varJob' facendo clic sul pulsante Più (+) nell'area Variabili e inserendo i seguenti valori nelle colonne Nome, Valore predefinito e Valore runtime: varJob, CLERK, Request("job").
Fate clic su OK per aggiungere il recordset al pannello Associazioni.

Definire i parametri URL

I parametri URL archiviano informazioni recuperate inserite dagli utenti.Prima di iniziare, assicurati di passare un modulo o un parametro URL al server.Dopo aver definito la Variabile URL, puoi usare il suo Valore nella pagina attualmente selezionata.

Nella finestra Documento, apri la pagina che userà la variabile.
Seleziona Finestra > Associazioni per visualizzare il pannello Associazioni.
Nel pannello Associazioni, fai clic sul pulsante Più (+) e seleziona una delle seguenti opzioni dal menu a comparsa:

Tipi di documento

Opzione di menu del pannello Associazioni per la variabile URL

ASP

Variabile di richiesta > Request.QueryString

ColdFusion

Variabile URL

PHP

Variabile URL

Nella finestra di dialogo Variabile URL, immetti il nome della variabile URL nella casella e fai clic su OK.

Il nome della Variabile URL è normalmente il nome del campo modulo HTML o dell'oggetto utilizzato per ottenere il suo Valore.

La variabile URL viene visualizzata nel pannello Associazioni.

Definire i parametri di modulo

I parametri di modulo memorizzano le informazioni recuperate che vengono incluse nella richiesta HTTP per una pagina web.Se crei un modulo che usa il metodo POST, i dati inviati dal modulo vengono passati al server.Prima di iniziare, assicurati di passare un parametro modulo al server.Dopo aver definito il parametro del modulo come origine del contenuto, puoi usare il suo valore nella pagina.

Nella finestra Documento, apri la pagina che userà la Variabile.
Seleziona Finestra > Associazioni per visualizzare il pannello Associazioni.
Nel pannello Associazioni, fai clic sul pulsante Più (+) e seleziona una delle seguenti opzioni dal menu a comparsa:

Tipi di documento

Opzione di menu del pannello Associazioni per la variabile modulo

ASP

Variabile di richiesta > Request.Form

ColdFusion

Variabile modulo

PHP

Variabile modulo

Nella finestra di dialogo Variabile modulo, inserisci il nome della Variabile modulo e fai clic su OK.Il nome del parametro di modulo è normalmente il nome del campo modulo HTML o dell'oggetto utilizzato per ottenere il relativo valore.

Il parametro di modulo viene visualizzato nel pannello Associazioni.

Pannello Associazioni con Modulo espanso
Pannello Associazioni con Modulo espanso

Definire le variabili di sessione

Puoi usare le variabili di sessione per memorizzare e visualizzare informazioni mantenute per la durata della visita (o sessione) di un utente.Il server crea un oggetto sessione diverso per ciascun Utente e lo mantiene per un periodo di tempo stabilito o fino a quando l'oggetto non viene esplicitamente terminato.

Prima di definire le variabili sessione per una pagina, devi crearle nel codice sorgente.Dopo aver creato una variabile di sessione nel codice sorgente dell'applicazione web, puoi usare Dreamweaver per recuperarne il valore e usarlo in una pagina web.

Crea una variabile di sessione nel codice sorgente e assegnale un valore.

Ad esempio, questo esempio ColdFusion istanzia una sessione chiamata username e le assegna il valore Cornelius:

<CFSET session.username = Cornelius>

Seleziona Finestra > Associazioni per visualizzare il pannello Associazioni.
Fai clic sul pulsante Più (+) e seleziona Variabile di sessione dal menu a comparsa.
Inserisci il nome della variabile definita nel codice sorgente dell'applicazione e fai clic su OK.

Definire le variabili di applicazione per ASP e ColdFusion

In ASP e ColdFusion, puoi utilizzare le variabili di applicazione per archiviare e visualizzare informazioni che vengono mantenute a vita dell'applicazione e persistono da Utente a Utente.Dopo aver definito la variabile di applicazione, puoi utilizzare il suo valore in una pagina.

Nota

Non esistono oggetti Variabile di applicazione in PHP.

Aprite il tipo di documento dinamico nella finestra del documento.
Seleziona Finestra > Associazioni per visualizzare il pannello Associazioni.
Fai clic sul pulsante Più (+) e seleziona Variabile di applicazione dal menu a comparsa.
Inserisci il nome della variabile come definito nel codice sorgente dell'applicazione e fai clic su OK.

La Variabile di applicazione appare nel pannello Associazioni sotto l'icona Applicazione.

Pannello Associazioni con Applicazione espanso
Pannello Associazioni con Applicazione espanso

Utilizzare una Variabile come origine dati per un recordset ColdFusion

Quando definisci un recordset per una pagina nel pannello Associazioni, Dreamweaver inserisce il nome del data source ColdFusion nel tag cfquery nella pagina.Per maggiore flessibilità, puoi archiviare un data source name in una Variabile e utilizzare la Variabile nel tag cfquery.Dreamweaver fornisce un metodo visivo per specificare tale Variabile nei tuoi recordset.

Assicurati che una pagina ColdFusion sia attiva nella finestra Documento.
Nel pannello Associazioni, fai clic sul pulsante Più (+) e seleziona Nome origine dati variabile dal menu a comparsa.

Viene visualizzata la finestra di dialogo Variabile DSN.

Definite una variabile e fate clic su OK.
Quando definisci il recordset, seleziona la Variabile come origine dati per il recordset.

Nella finestra di dialogo Recordset, la Variabile appare nel menu a comparsa Origine dati insieme ai data source ColdFusion sul server.

Impostate la finestra di dialogo Recordset e fate clic su OK.
Inizializzate la variabile.

Dreamweaver non inizializza la variabile per te in modo che tu possa inizializzarla come e dove vuoi.Puoi inizializzare la variabile nel codice di pagina (prima del tag cfquery), in un file di inclusione o in qualche altro file come variabile di sessione o di applicazione.

Definire le variabili server

Definisci le variabili server come origini di contenuto dinamico da utilizzare all'interno di un'applicazione web.Le variabili server variano da tipo di documento a tipo di documento e includono variabili di modulo, variabili URL, variabili di sessione e variabili di applicazione.

Le variabili server sono accessibili da tutti i client che accedono al server e da qualsiasi applicazione in esecuzione sul server. Le variabili persistono fino all'arresto del server.

Definire le variabili server ColdFusion

Apri il pannello Associazioni (Finestra > Associazioni). Nella finestra di dialogo Variabile server, inserisci il nome della variabile server e fai clic su OK.
Fai clic sul pulsante Più (+) e seleziona la variabile server dal menu a comparsa.
Inserite il nome da assegnare alla variabile e fate clic su OK. La variabile server ColdFusion viene visualizzata nel pannello Associazioni.

La tabella seguente elenca le variabili server ColdFusion integrate:

Variabile

Descrizione

Server.ColdFusion.ProductName

Nome di prodotto ColdFusion.

Server.ColdFusion.ProductVersion

Numero di versione ColdFusion.

Server.ColdFusion.ProductLevel

Edizione ColdFusion (Enterprise, Professional).

Server.ColdFusion.SerialNumber

Numero di serie della versione di ColdFusion attualmente installata.

Server.OS.Name

Nome del sistema operativo in esecuzione sul server (Windows XP, Windows 2000, Linux).

Server.OS.AdditionalInformation

Informazioni aggiuntive sul sistema operativo installato (service pack, aggiornamenti).

Server.OS.Version

Versione del sistema operativo installato.

Server.OS.BuildNumber

Numero di build del sistema operativo installato.

Definire una variabile locale ColdFusion

Le variabili locali sono variabili create con il tag CFSET o CFPARAM all'interno di una pagina ColdFusion.La variabile locale definita viene visualizzata nel pannello Associazioni.

Nella finestra di dialogo Variabile locale, inserisci il nome della variabile locale e fai clic su OK.

Definire le variabili server ASP

Puoi definire le seguenti variabili server ASP come origini di contenuto dinamico: Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables e Request.ClientCertificates.

Apri il pannello Associazioni (Finestra > Associazioni).
Fai clic sul pulsante Più (+) e seleziona Variabile richiesta dal menu a comparsa.
Nella finestra di dialogo Variabile richiesta, seleziona una delle seguenti raccolte di richieste dal menu a comparsa Tipo:

La raccolta QueryString

Recupera informazioni aggiunte all'URL della pagina di invio, ad esempio quando la pagina ha un modulo HTML che usa il metodo GET. La stringa di richiesta è costituita da una o più coppie nome-valore (ad esempio, last=Smith, first=Winston) aggiunte all'URL con un punto interrogativo (?). Se la stringa di richiesta ha più di una coppia nome-valore, vengono combinate con e commerciali (&).

La raccolta Form

Recupera informazioni del modulo incluse nel corpo della richiesta HTTP da un modulo HTML che usa il metodo POST.

La raccolta ServerVariables

Recupera i valori delle variabili ambientali predefinite. La raccolta ha un lungo elenco di variabili, incluse CONTENT_LENGTH (la lunghezza del contenuto inviato nella richiesta HTTP, che è possibile utilizzare per verificare se un form è vuoto) e HTTP_USER_AGENT (fornisce informazioni sul browser dell'utente).

Ad esempio, Request.ServerVariables("HTTP_USER_AGENT") contiene informazioni sul browser di invio, come Mozilla/4.07 [en] (WinNT; I), che indica un browser Netscape Navigator 4.07.

Per un elenco completo delle variabili dell'ambiente server ASP, consulta la documentazione online installata con Microsoft Personal Web Server (PWS) o Internet Information Server (IIS).

La raccolta Cookies

Recupera i valori dei cookie inviati in una richiesta HTTP. Ad esempio, supponi che la pagina legga un cookie chiamato "readMe" sul sistema dell'utente. Sul server, i valori del cookie vengono memorizzati nella variabile Request.Cookies("readMe").

La raccolta ClientCertificate

Recupera i campi di certificazione dalla richiesta HTTP inviata dal browser.I campi di certificazione sono specificati nello standard X.509.

Specifica la variabile nella raccolta a cui desideri accedere e fai clic su OK.

Ad esempio, se desideri accedere alle informazioni nella variabile Request.ServerVariables("HTTP_USER_AGENT"), inserisci l'argomento HTTP_USER_AGENT.Se desideri accedere alle informazioni nella variabile Request.Form("lastname"), inserisci l'argomento lastname.

La variabile della richiesta appare nel pannello Associazioni.

Definire le variabili server PHP

Definisci le variabili del server come origine di contenuto dinamico per le pagine PHP.Le variabili del server PHP appaiono nel pannello Associazioni.

Apri il pannello Associazioni (Finestra > Associazioni).
Fai clic sul pulsante Più (+) e seleziona la variabile dal menu a comparsa.
Nella finestra di dialogo Variabile di richiesta, inserisci il nome della variabile (ad esempio, REQUEST_METHOD) e fai clic su OK.

Per maggiori informazioni, cerca la parola chiave $_SERVER nella documentazione PHP.

Definire una variabile client ColdFusion

Definisci una variabile client ColdFusion come origine di contenuto dinamico per la pagina.Le variabili client ColdFusion appena definite appaiono nel pannello Associazioni.

Nella finestra di dialogo Variabile client, inserisci il nome della variabile e fai clic su OK.

Ad esempio, per accedere alle informazioni nella variabile ColdFusion Client.LastVisit, inserisci LastVisit.

Le variabili client sono variabili create nel codice per associare dati a un client specifico.Le variabili client mantengono lo stato dell'applicazione mentre l'utente si sposta da pagina a pagina all'interno dell'applicazione, oltre che da sessione a sessione.

Le variabili client possono essere definite dall’utente o incorporate. Nella tabella seguente sono elencate le variabili client ColdFusion incorporate:

Variabile

Descrizione

Client.CFID

Un ID incrementale per ogni client che si connette al server.

Client.CFTOKEN

Un numero generato casualmente utilizzato per identificare univocamente un client particolare.

Client.URLToken

Una combinazione di CFID e CFTOKEN da trasmettere tra i modelli quando non vengono utilizzati i cookie.

Client.LastVisit

Registra la marca temporale dell'ultima visita effettuata da un client.

Client.HitCount

Il numero di richieste di pagina legate a un singolo client (tracciato utilizzando CFID e CFTOKEN).

Client.TimeCreated

Registra la marca temporale di quando CFID e CFTOKEN sono stati creati per la prima volta per un client particolare.

Le variabili cookie vengono create nel codice e consentono di accedere alle informazioni contenute nei cookie trasmessi al server da un browser.La variabile cookie definita viene visualizzata nel pannello Bindings.

Nella finestra di dialogo Variabile cookie, immetti il nome della variabile cookie e fai clic su OK.

Definire una variabile CGI ColdFusion

La variabile CGI definita appare nel pannello Bindings.

Nella finestra di dialogo Variabile CGI, inserisci il nome della variabile e fai clic su OK.

Ad esempio, se desideri accedere alle informazioni nella variabile CGI.HTTP_REFERER , inserisci HTTP_REFERER.

La tabella seguente elenca le variabili CGI ColdFusion più comuni create sul server:

Variabile

Descrizione

SERVER_SOFTWARE

Il nome e la versione del software del server di informazioni che risponde alla richiesta (ed esegue il gateway).Formato: nome/versione.

SERVER_NAME

Il nome host, l'alias DNS o l'indirizzo IP del server come appare negli URL autoreferenziali.

GATEWAY_INTERFACE

La revisione delle specifiche CGI a cui questo server è conforme. Formato: CGI/revisione.

SERVER_PROTOCOL

Il nome e la revisione del protocollo delle informazioni con cui è arrivata questa richiesta. Formato: protocollo/revisione.

SERVER_PORT

Il numero di porta a cui è stata inviata la richiesta.

REQUEST_METHOD

Metodo con cui è stata eseguita la richiesta. Per HTTP, si tratta del metodo Get, Head, Post e così via.

PATH_INFO

Le informazioni del percorso aggiuntive, fornite dal client. È possibile accedere agli script tramite il percorso virtuale, seguito da informazioni aggiuntive alla fine di questo percorso.Le informazioni aggiuntive vengono inviate come PATH_INFO.

PATH_TRANSLATED

Il server fornisce una versione tradotta di PATH_INFO, che prende il percorso ed esegue qualsiasi mappatura da virtuale a fisico.

SCRIPT_NAME

Un percorso virtuale allo script in esecuzione; utilizzato per URL autoreferenziali.

QUERY_STRING

Le informazioni della richiesta che seguono il punto interrogativo (?) nell'URL che fa riferimento allo script.

REMOTE_HOST

Nome host che esegue la richiesta. Se il server non dispone di queste informazioni, imposta REMOTE_ADDR e non imposta REMOTE_HOST.

REMOTE_ADDR

L'indirizzo IP dell'host remoto che effettua la richiesta.

AUTH_TYPE

Se il server supporta l'autenticazione utente e lo script è protetto, questo è il metodo di autenticazione specifico del protocollo utilizzato per convalidare l'utente.

REMOTE_USER AUTH_USER

Se il server supporta l'autenticazione utente e lo script è protetto, questo è il nome utente con cui si sono autenticati. (Disponibile anche come AUTH_USER.)

REMOTE_IDENT

Se il server HTTP supporta l'identificazione RFC 931, questa variabile viene impostata sul nome utente remoto recuperato dal server. Utilizzate questa variabile soltanto per la connessione.

CONTENT_TYPE

Per le richieste che contengono informazioni allegate, come HTTP POST e PUT, questo è il tipo di contenuto dei dati.

CONTENT_LENGTH

La lunghezza del contenuto come fornita dal client.

La seguente tabella riporta le variabili CGI più comuni create dal browser e trasmesse al server:

Variabile

Descrizione

HTTP_REFERER

Documento di riferimento. Si tratta del documento che ha collegato o inviato i dati del modulo.

HTTP_USER_AGENT

Il browser che il cliente utilizza attualmente per inviare la richiesta. Formato: software/versione libreria/versione.

HTTP_IF_MODIFIED_SINCE

Ultima modifica della pagina. Questa variabile viene inviata a discrezione del browser, solitamente in risposta all'intestazione HTTP LAST_MODIFIED inviata dal server. Può essere utilizzata per sfruttare la memorizzazione nella cache lato browser.

Memorizzare origini di contenuto nella cache

Puoi memorizzare nella cache le origini del contenuto dinamico in una Nota di progettazione. Questo ti consente di lavorare su un sito anche se non hai accesso al database o al server applicazioni che memorizza le origini del contenuto dinamico.La memorizzazione nella cache può anche velocizzare lo sviluppo eliminando l'accesso ripetuto attraverso una rete al database e al Server applicazioni.

Fai clic sul pulsante freccia nell'angolo in alto a destra del pannello Collegamenti e attiva Cache nel menu a comparsa.

Se apporti modifiche a una delle origini del Contenuto, puoi aggiornare la cache facendo clic sul pulsante Aggiorna (l'icona con la freccia a cerchio) nell'angolo in alto a destra del pannello Collegamenti. (Espandi il pannello se non vedi il pulsante.)

Modificare o eliminare le origini di contenuto

Puoi cambiare o eliminare qualsiasi origine esistente del contenuto dinamico, ovvero qualsiasi origine di contenuto elencata nel pannello Collegamenti.

Cambiare o eliminare un'origine di Contenuto nel pannello Collegamenti non modifica né elimina alcuna Istanza di quel contenuto sulla pagina. Semplicemente lo cambia o lo elimina come possibile origine di Contenuto per la pagina.

Cambiare un'origine di Contenuto nel pannello Collegamenti

Nel pannello Collegamenti (Finestra > Collegamenti), fai doppio clic sul nome dell'origine del Contenuto che desideri modificare.
Apportate le modifiche nella finestra di dialogo visualizzata.
Se siete soddisfatti del risultato, fate clic su OK.

Eliminare un'origine di Contenuto dal pannello Collegamenti

Nel pannello Collegamenti (Finestra > Collegamenti), seleziona l'origine del contenuto dall'elenco.
Fate clic sul pulsante meno (-).

Copiare un recordset da una pagina a un'altra pagina

Puoi copiare un recordset da una pagina a un'altra all'interno di un sito definito.

Seleziona il recordset nel pannello Collegamenti o nel pannello Comportamenti del server.
Fai clic con il pulsante destro del mouse sul recordset e seleziona Copia dal menu a comparsa.
Aprite la pagina in cui desiderate copiare il recordset.
Fai clic con il pulsante destro del mouse sul pannello Collegamenti o sulla barra degli strumenti Comportamenti del Server e seleziona Incolla dal menu a comparsa.