Öffnen Sie im Dokumentfenster die Seite, auf der die Datensatzgruppe verwendet werden soll.

Wählen Sie „Fenster“ > „Bindungen“, um das Bedienfeld „Bindungen“ einzublenden.

Klicken Sie im Bedienfeld „Bindungen“ auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie „Datensatzgruppe (Abfrage)“ im Popup-Menü aus.

Das einfache Dialogfeld „Datensatzgruppe“ wird angezeigt. Wenn Sie eine ColdFusion-Site erstellen, sieht das Dialogfeld „Datensatzgruppe“ etwas anders aus. (Wenn stattdessen das erweiterte Dialogfeld „Datensatzgruppe“ angezeigt wird, klicken Sie auf die Schaltfläche „Einfach“, um zum einfachen Dialogfeld umzuschalten.)

Füllen Sie das Dialogfeld „Datensatzgruppe“ für Ihren Dokumenttyp aus.

Anweisungen hierzu finden Sie in folgenden Themen:

Klicken Sie auf die Schaltfläche „Testen“, um die Abfrage auszuführen und sicherzustellen, dass damit die gewünschten Informationen abgerufen werden.

Wenn Sie einen Filter definiert haben, der von Benutzern eingegebene Parameter verwendet, geben Sie in das Feld „Testwert“ einen Wert ein und klicken Sie auf „OK“. Wenn eine Instanz der Datensatzgruppe erfolgreich erstellt wurde, wird eine Tabelle mit den aus der Datensatzgruppe extrahierten Daten angezeigt.

Klicken Sie auf „OK“, um die Datensatzgruppe der Liste der verfügbaren Inhaltsquellen im Bedienfeld „Bindungen“ hinzuzufügen.

Geben Sie im Feld „Name“ einen Namen für die Datensatzgruppe ein.

Üblicherweise werden Namen von Datensatzgruppen mit dem Präfix rs versehen, um sie von anderen Objektnamen im Code zu unterscheiden, wie z. B. rsPressReleases.

Namen von Datensatzgruppen dürfen nur aus Buchstaben, Ziffern und dem Unterstrich (_) bestehen. Sonderzeichen und Leerzeichen sind nicht zulässig.

Wählen Sie im Popup-Menü „Verbindung“ eine Verbindung aus.

Wird in der Liste keine Verbindung aufgeführt, klicken Sie auf „Definieren“, um eine Verbindung zu erstellen.

Wählen Sie im Popup-Menü „Tabelle“ die Datenbanktabelle aus, die die Daten für die Datensatzgruppe liefern soll.

Im Popup-Menü werden alle Tabellen der angegebenen Datenbank angezeigt.

Um nur einige Spalten der Tabelle in die Datensatzgruppe aufzunehmen, klicken Sie auf „Ausgewählt“. Wählen Sie dann die gewünschten Spalten aus, indem Sie bei gedrückter Strg-Taste (Windows) bzw. Befehlstaste (Mac) auf die jeweiligen Listeneinträge klicken.

Wenn Sie die Anzahl der aus der Tabelle zurückgegebenen Datensätze weiter einschränken möchten, nehmen Sie im Bereich „Filter“ die folgenden Einstellungen vor:

• Wählen Sie im ersten Popup-Menü eine Spalte in der Datenbanktabelle aus, die mit einem von Ihnen definierten Testwert verglichen werden soll.

• Wählen Sie im zweiten Popup-Menü einen bedingten Ausdruck aus, anhand dessen der ausgewählte Wert in jedem Datensatz mit dem Testwert verglichen werden soll.

• Wählen Sie im dritten Popup-Menü die Option „Eingegebener Wert“.

• Geben Sie den Testwert in das Feld ein.

  Wenn der festgelegte Wert in einem Datensatz Ihre Filterbedingung erfüllt, wird dieser Datensatz in die Datensatzgruppe aufgenommen.

Optional: Wenn Sie die Datensätze sortieren möchten, wählen Sie eine Spalte aus, auf der die Sortierung basieren soll, und geben Sie dann an, ob die Datensätze in aufsteigender (1, 2, 3... bzw. A, B, C...) oder in absteigender Reihenfolge sortiert werden sollen.

Klicken Sie auf „Testen“, um eine Verbindung zur Datenbank herzustellen und eine Instanz der Datenquelle zu erstellen. Klicken Sie dann auf „OK“, um die Datenquelle zu schließen.

Es wird eine Tabelle angezeigt, in der die zurückgegebenen Daten enthalten sind. Jede Zeile enthält einen Datensatz und jede Spalte entspricht einem Feld in diesem Datensatz.

Klicken Sie auf „OK“. Die neu definierte Datensatzgruppe wird im Bedienfeld „Bindungen“ angezeigt.

Geben Sie im Feld „Name“ einen Namen für die Datensatzgruppe ein.

Üblicherweise werden Namen von Datensatzgruppen mit dem Präfix rs versehen, um sie von anderen Objektnamen im Code zu unterscheiden. Beispiel: rsPressReleases

Namen von Datensatzgruppen dürfen nur aus Buchstaben, Ziffern und dem Unterstrich (_) bestehen. Sonderzeichen und Leerzeichen sind nicht zulässig.

Wenn Sie eine Datensatzgruppe für eine ColdFusion-Komponente definieren (d. h. wenn in Dreamweaver gerade eine CFC-Datei geöffnet ist), wählen Sie eine vorhandene CFC-Funktion im Popup-Menü „Funktion“ aus oder klicken auf „Neue Funktion“, um eine neue Funktion zu erstellen.

Die Datensatzgruppe wird in der Funktion definiert.

Wählen Sie im Popup-Menü „Datenquelle“ eine Datenquelle aus.

Wenn im Popup-Menü keine Datenquelle aufgeführt wird, müssen Sie eine ColdFusion-Datenquelle erstellen.

Geben Sie, falls erforderlich, in die Felder „Benutzername“ und „Kennwort“ den Benutzernamen und das Kennwort für den ColdFusion-Anwendungsserver ein.

Für den Zugriff auf Datenquellen ist in ColdFusion unter Umständen die Eingabe eines Benutzernamens und eines Kennworts erforderlich. Wenn Sie nicht über diese Zugangsdaten verfügen, wenden Sie sich an den ColdFusion-Administrator Ihrer Firma.

Wählen Sie im Popup-Menü „Tabelle“ die Datenbanktabelle aus, die die Daten für die Datensatzgruppe liefern soll.

Im Popup-Menü „Tabelle“ werden alle Tabellen der angegebenen Datenbank angezeigt.

Um nur einige Spalten der Tabelle in die Datensatzgruppe aufzunehmen, klicken Sie auf „Ausgewählt“. Wählen Sie dann die gewünschten Spalten aus, indem Sie bei gedrückter Strg-Taste (Windows) bzw. Befehlstaste (Mac) auf die jeweiligen Listeneinträge klicken.

Wenn Sie die Anzahl der aus der Tabelle zurückgegebenen Datensätze weiter einschränken möchten, nehmen Sie im Bereich „Filter“ die folgenden Einstellungen vor:

• Wählen Sie im ersten Popup-Menü eine Spalte in der Datenbanktabelle aus, die mit einem von Ihnen definierten Testwert verglichen werden soll.

• Wählen Sie im zweiten Popup-Menü einen bedingten Ausdruck aus, anhand dessen der ausgewählte Wert in jedem Datensatz mit dem Testwert verglichen werden soll.

• Wählen Sie im dritten Popup-Menü die Option „Eingegebener Wert“.

• Geben Sie den Testwert in das Feld ein.

  Wenn der festgelegte Wert in einem Datensatz Ihre Filterbedingung erfüllt, wird dieser Datensatz in die Datensatzgruppe aufgenommen.

Optional: Wenn Sie die Datensätze sortieren möchten, wählen Sie eine Spalte aus, auf der die Sortierung basieren soll, und geben Sie dann an, ob die Datensätze in aufsteigender (1, 2, 3... bzw. A, B, C...) oder in absteigender Reihenfolge sortiert werden sollen.

Klicken Sie auf „Testen“, um eine Verbindung zur Datenbank herzustellen und eine Instanz der Datenquelle zu erstellen.

Es wird eine Tabelle angezeigt, in der die zurückgegebenen Daten enthalten sind. Jede Zeile enthält einen Datensatz und jede Spalte entspricht einem Feld in diesem Datensatz. Klicken Sie auf „OK“, um die Testdatensatzgruppe zu schließen.

Klicken Sie auf „OK“. Die neu definierte ColdFusion-Datensatzgruppe wird im Bedienfeld „Bindungen“ angezeigt.

Öffnen Sie im Dokumentfenster die Seite, auf der die Datensatzgruppe verwendet werden soll.

Wählen Sie „Fenster“ > „Bindungen“, um das Bedienfeld „Bindungen“ einzublenden.

Klicken Sie im Bedienfeld „Bindungen“ auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü die „Datensatzgruppe (Abfrage)“ aus.

Das erweiterte Dialogfeld „Datensatzgruppe“ wird eingeblendet. Wenn Sie eine ColdFusion-Site erstellen, sieht das Dialogfeld „Datensatzgruppe“ etwas anders aus. (Wird stattdessen das einfache Dialogfeld „Datensatzgruppe“ angezeigt, können Sie zum erweiterten Dialogfeld wechseln, indem Sie auf die Schaltfläche „Erweitert“ klicken.)

Nehmen Sie im erweiterten Dialogfeld „Datensatzgruppe“ die gewünschten Einstellungen vor.

Anweisungen hierzu finden Sie in folgenden Themen:

Klicken Sie auf die Schaltfläche „Testen“, um die Abfrage auszuführen und sicherzustellen, dass damit die gewünschten Informationen abgerufen werden.

Wenn Sie einen Filter definiert haben, der von Benutzern eingegebene Parameter verwendet, wird mit der Schaltfläche „Testen“ das Dialogfeld „Testwert“ eingeblendet. Geben Sie einen Wert in das Feld „Testwert“ ein und klicken Sie auf „OK“. Wenn eine Instanz der Datensatzgruppe erfolgreich erstellt wurde, wird eine Tabelle mit den aus der Datensatzgruppe extrahierten Daten angezeigt.

Klicken Sie auf „OK“, um die Datensatzgruppe der Liste der verfügbaren Inhaltsquellen im Bedienfeld „Bindungen“ hinzuzufügen.

Geben Sie im Feld „Name“ einen Namen für die Datensatzgruppe ein.

Üblicherweise werden Namen von Datensatzgruppen mit dem Präfix rs versehen, um sie von anderen Objektnamen im Code zu unterscheiden. Beispiel: rsPressRelease

Namen von Datensatzgruppen dürfen nur aus Buchstaben, Ziffern und dem Unterstrich (_) bestehen. Sonderzeichen und Leerzeichen sind nicht zulässig.

Wählen Sie im Popup-Menü „Verbindung“ eine Verbindung aus.

Geben Sie eine SQL-Anweisung in den SQL-Textbereich ein oder erstellen Sie mithilfe der Strukturansicht „Datenbankelemente“ unten im Dialogfeld eine SQL-Anweisung anhand der ausgewählten Datensatzgruppe.

Wenn Sie die SQL-Anweisung mithilfe der Strukturansicht „Datenbankelemente“ erstellen möchten, gehen Sie folgendermaßen vor:

• Vergewissern Sie sich, dass der SQL-Textbereich leer ist.

• Erweitern Sie die Strukturansicht, bis Sie das gewünschte Datenbankobjekt finden, z. B. eine bestimmte Tabellenspalte oder eine gespeicherte Prozedur in der Datenbank.

• Wählen Sie das Datenbankobjekt aus und klicken Sie auf eine der Schaltflächen rechts neben der Struktur.

  Wenn Sie beispielsweise eine Tabellenspalte auswählen, stehen die Schaltflächen „SELECT“, „WHERE“ und „ORDER BY“ zur Verfügung. Klicken Sie auf eine der Schaltflächen, um Ihrer SQL-Anweisung den entsprechenden Ausdruck hinzuzufügen.

  Sie können auch eine vordefinierte SQL-Anweisung in einer gespeicherten Prozedur verwenden, indem Sie die gespeicherte Prozedur in der Strukturansicht „Datenbankelemente“ auswählen und auf die Schaltfläche „Prozedur“ klicken. Die Bereiche „SQL“ und „Variablen“ werden automatisch von Dreamweaver ausgefüllt.

Wenn die SQL-Anweisung Variablen enthält, definieren Sie deren Werte im Bereich „Variablen“, indem Sie auf die Schaltfläche mit dem Plussymbol (+) klicken. Geben Sie dann jeweils den Namen der Variable, den Typ (Ganzzahl, Text, Datum oder Gleitkommazahl), den Standardwert (den Wert der Variable, wenn kein Laufzeitwert zurückgegeben wird) und den Laufzeitwert ein.

Wenn die SQL-Anweisung Variablen enthält, muss die Spalte „Standardwert“ des Feldes „Variablen“ gültige Testwerte enthalten.

Der Laufzeitwert ist normalerweise ein URL- oder Formularparameter, der von einem Benutzer in ein HTML-Formularfeld eingegeben wird.

URL-Parameter in der Spalte „Laufzeitwert“:

Formularparameter in der Spalte „Laufzeitwert“:

Klicken Sie auf „Testen“, um eine Verbindung zur Datenbank herzustellen und eine Instanz der Datensatzgruppe zu erstellen.

Wenn die SQL-Anweisung Variablen enthält, vergewissern Sie sich zuerst, dass in der Spalte „Standardwert“ des Feldes „Variablen“ gültige Testwerte angezeigt werden. Klicken Sie dann auf „Testen“.

Kann dies erfolgreich ausgeführt werden, wird eine Tabelle mit den Daten Ihrer Datensatzgruppe angezeigt. Jede Zeile enthält einen Datensatz und jede Spalte entspricht einem Feld in diesem Datensatz. Klicken Sie auf „OK“, um die Datensatzgruppe zu löschen.

Wenn Sie mit dem Ergebnis zufrieden sind, klicken Sie auf „OK“.

Geben Sie im Feld „Name“ einen Namen für die Datensatzgruppe ein.

Üblicherweise werden Namen von Datensatzgruppen mit dem Präfix rs versehen, um sie von anderen Objektnamen im Code zu unterscheiden. Beispiel: rsPressReleases

Namen von Datensatzgruppen dürfen nur aus Buchstaben, Ziffern und dem Unterstrich (_) bestehen. Sonderzeichen und Leerzeichen sind nicht zulässig.

Wenn Sie eine Datensatzgruppe für eine ColdFusion-Komponente definieren (d. h. wenn in Dreamweaver gerade eine CFC-Datei geöffnet ist), wählen Sie eine vorhandene CFC-Funktion im Popup-Menü „Funktion“ aus oder klicken auf „Neue Funktion“, um eine neue Funktion zu erstellen.

Die Datensatzgruppe wird in der Funktion definiert.

Wählen Sie im Popup-Menü „Datenquelle“ eine Datenquelle aus.

Wenn im Popup-Menü keine Datenquelle aufgeführt wird, müssen Sie zunächst eine ColdFusion-Datenquelle erstellen.

Geben Sie, falls erforderlich, in die Felder „Benutzername“ und „Kennwort“ den Benutzernamen und das Kennwort für den ColdFusion-Anwendungsserver ein.

Für den Zugriff auf Datenquellen ist in ColdFusion unter Umständen die Eingabe eines Benutzernamens und eines Kennworts erforderlich. Wenn Sie nicht über diese Zugangsdaten verfügen, wenden Sie sich an den ColdFusion-Administrator Ihrer Firma.

Geben Sie eine SQL-Anweisung in den SQL-Textbereich ein oder erstellen Sie mithilfe der Strukturansicht „Datenbankelemente“ unten im Dialogfeld eine SQL-Anweisung anhand der ausgewählten Datensatzgruppe.

Optional: Wenn Sie die SQL-Anweisung mithilfe der Strukturansicht „Datenbankelemente“ erstellen möchten, gehen Sie folgendermaßen vor:

• Vergewissern Sie sich, dass der SQL-Textbereich leer ist.

• Erweitern Sie anschließend die Struktur der Datenbankelemente, bis Sie zu dem gewünschten Datenbankobjekt gelangen, z. B. zu einer Spalte in einer Tabelle.

• Wählen Sie das Datenbankobjekt aus und klicken Sie auf eine der Schaltflächen rechts neben der Struktur.

Wenn Sie beispielsweise eine Tabellenspalte auswählen, stehen die Schaltflächen „Select“, „Where“ und „Order by“ zur Verfügung. Klicken Sie auf eine der Schaltflächen, um Ihrer SQL-Anweisung den entsprechenden Ausdruck hinzuzufügen.

Wenn die SQL-Anweisung Parameter enthält, definieren Sie die entsprechenden Werte im Bereich „Parameter“. Klicken Sie dazu auf die Schaltfläche mit dem Pluszeichen (+) und geben Sie den Namen sowie den Standardwert des Parameters (den Wert, den der Parameter annehmen soll, wenn kein Laufzeitwert zurückgegeben wird) ein.

Wenn die SQL-Anweisung Parameter enthält, muss die Spalte „Standardwert“ des Feldes „Parameter“ gültige Testwerte enthalten.

Mithilfe der „Seitenparameter“ können Sie in Ihren SQL-Anweisungen Standardwerte für Laufzeitwert-Verweise vorgeben. So wird zum Beispiel bei der folgenden SQL-Anweisung ein Mitarbeiterdatensatz anhand der Kennnummer des Mitarbeiters ausgewählt. Indem Sie diesem Parameter einen Standardwert zuweisen, stellen Sie sicher, dass immer ein Laufzeitwert zurückgegeben wird. In diesem Beispiel verweist formFieldName auf ein Formularfeld, in dem der Benutzer eine Mitarbeiter-Kennnummer eingibt.

Das Dialogfeld „Seitenparameter hinzufügen“ würde dann etwa folgendes Name/Wert-Paar enthalten:

Der Laufzeitwert ist normalerweise ein URL- oder Formularparameter, der von einem Benutzer in ein HTML-Formularfeld eingegeben wird.

Klicken Sie auf „Testen“, um eine Verbindung zur Datenbank herzustellen und eine Instanz der Datensatzgruppe zu erstellen.

Wenn die SQL-Anweisung Laufzeitverweise enthält, vergewissern Sie sich zuerst, dass in der Spalte „Standardwert“ des Feldes „Seitenparameter“ gültige Testwerte angezeigt werden. Klicken Sie dann auf „Testen“.

Kann dies erfolgreich ausgeführt werden, wird eine Tabelle mit den Daten Ihrer Datensatzgruppe angezeigt. Jede Zeile enthält einen Datensatz und jede Spalte entspricht einem Feld in diesem Datensatz. Klicken Sie auf „OK“, um die Datensatzgruppe zu löschen.

Wenn Sie mit dem Ergebnis zufrieden sind, klicken Sie auf „OK“.

Wählen Sie im Popup-Menü „Name“ einen Parameternamen aus.

Geben Sie im Feld „Standardparameter“ einen Standardwert für den Parameter ein und klicken Sie auf „OK“.

Geben Sie im Feld „Name“ einen Namen für den Parameter ein.

Geben Sie im Feld „Standardparameter“ einen Standardwert für den Parameter ein.

Geben Sie im Feld „Laufzeitwert“ einen Laufzeitwert für den Parameter ein und klicken Sie auf „OK“.

Erweitern Sie den Zweig „Tabellen“, sodass alle Tabellen der ausgewählten Datenbank angezeigt werden.

Wählen Sie die Tabelle „Employees“ aus.

Klicken Sie auf die Schaltfläche „Select“.

Klicken Sie auf „OK“, um die Datensatzgruppe dem Bedienfeld „Bindungen“ hinzuzufügen.

Erweitern Sie den Zweig „Tabellen“, sodass alle Tabellen der ausgewählten Datenbank angezeigt werden. Erweitern Sie dann die Tabelle Employees, sodass die einzelnen Tabellenzeilen zu sehen sind.

Stellen Sie die SQL-Anweisung folgendermaßen zusammen:

• Wählen Sie emplNo und klicken Sie auf „SELECT“.

• Wählen Sie emplName und klicken Sie auf „SELECT“.

• Wählen Sie emplJob und klicken Sie auf „WHERE“.

• Wählen Sie emplName und klicken Sie auf „ORDER BY“.

Setzen Sie die Einfügemarke im SQL-Textbereich hinter WHERE emplJob und geben Sie ='varJob' ein (einschließlich Gleichheitszeichen).

Definieren Sie die Variable 'varJob', indem Sie im Bereich „Variablen“ auf die Schaltfläche mit dem Pluszeichen (+) klicken und in die Spalten „Name“, „Standardwert“ und „Laufzeitwert“ folgende Werte eingeben: varJob, CLERK, Request("job").

Klicken Sie auf „OK“, um die Datensatzgruppe dem Bedienfeld „Bindungen“ hinzuzufügen.

Öffnen Sie im Dokumentfenster die Seite, in der die Variable verwendet werden soll.

Wählen Sie „Fenster“ > „Bindungen“, um das Bedienfeld „Bindungen“ einzublenden.

Klicken Sie im Bedienfeld „Bindungen“ auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü einen der folgenden Einträge aus:

Geben Sie im Dialogfeld „URL-Variable“ den Namen der URL-Variablen in das Feld ein und klicken Sie auf „OK“.

Der Name der URL-Variablen entspricht normalerweise dem Namen des HTML-Formularfelds oder -Objekts, das zum Einlesen des Werts verwendet wird.

Die URL-Variable wird im Bedienfeld „Bindungen“ angezeigt.

Öffnen Sie im Dokumentfenster die Seite, in der die Variable verwendet werden soll.

Wählen Sie „Fenster“ > „Bindungen“, um das Bedienfeld „Bindungen“ einzublenden.

Klicken Sie im Bedienfeld „Bindungen“ auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü einen der folgenden Einträge aus:

Geben Sie im Dialogfeld „Formularvariable“ den Namen der Formularvariablen ein und klicken Sie auf „OK“. Der Name der Formularvariablen entspricht normalerweise dem Namen des HTML-Formularfelds oder -Objekts, das zum Einlesen des Wertes verwendet wird.

Der Formularparameter wird im Bedienfeld „Bindungen“ angezeigt.

Erstellen Sie eine Sitzungsvariable im Quellcode und weisen Sie ihr einen Wert zu.

Im folgenden ColdFusion-Beispiel wird eine Sitzung namens username instanziiert und anschließend wird ihr der Wert Cornelius zugewiesen:

Wählen Sie „Fenster“ > „Bindungen“, um das Bedienfeld „Bindungen“ einzublenden.

Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü den Eintrag „Sitzungsvariable“ aus.

Geben Sie den Namen der Variablen ein, den Sie im Quellcode der Anwendung definiert haben. Klicken Sie dann auf „OK“.

Öffnen Sie ein dynamisches Dokument im Dokumentfenster.

Wählen Sie „Fenster“ > „Bindungen“, um das Bedienfeld „Bindungen“ einzublenden.

Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü den Eintrag „Anwendungsvariable“ aus.

Geben Sie den Namen der Variablen so ein, wie er im Quellcode der Anwendung definiert wurde. Klicken Sie dann auf „OK“.

Die Anwendungsvariable wird im Bedienfeld „Bindungen“ unter dem Anwendungssymbol angezeigt.

Stellen Sie sicher, dass im Dokumentfenster eine ColdFusion-Seite aktiv ist.

Klicken Sie im Bedienfeld „Bindungen“ auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü die Option „DSN-Variable“.

Das Dialogfeld „DSN-Variable“ wird eingeblendet.

Definieren Sie eine Variable und klicken Sie auf „OK“.

Wählen Sie beim Definieren der Datensatzgruppe die Variable als Datenquelle der Datensatzgruppe aus.

Im Dialogfeld „Datensatzgruppe“ wird die Variable zusammen mit den ColdFusion-Datenquellen auf dem Server im Popup-Menü „Datenquelle“ angezeigt.

Nehmen Sie im Dialogfeld „Datensatzgruppe“ die gewünschten Einstellungen vor und klicken Sie auf „OK“.

Initialisieren Sie die Variable.

Die Variable wird nicht von Dreamweaver initialisiert, d. h., Sie haben die Möglichkeit, die Variable auf die gewünschte Weise und an der gewünschten Stelle zu initialisieren. Sie können die Variable im Seitencode (vor dem Tag cfquery), in einer Include-Datei oder in einer anderen Datei als Sitzungs- oder Anwendungsvariable initialisieren.

Öffnen Sie das Bedienfeld „Bindungen“ („Fenster“ > „Bindungen“). Geben Sie im Dialogfeld „Servervariable“ den Namen der Servervariablen ein und klicken Sie auf „OK“.

Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü die Servervariable aus.

Geben Sie den Namen der Variablen ein und klicken Sie auf „OK“. Die ColdFusion-Servervariable wird im Bedienfeld „Bindungen“ angezeigt.

Geben Sie im Dialogfeld „Lokale Variable“ den Namen der lokalen Variablen ein und klicken Sie auf „OK“.

Öffnen Sie das Bedienfeld „Bindungen“ („Fenster“ > „Bindungen“).

Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü den Eintrag „Anforderungsvariable“ aus.

Wählen Sie im Dialogfeld „Anforderungsvariable“ eine der folgenden Anforderungssammlungen im Popup-Menü „Typ“ aus:

ruft Informationen ab, die an die URL der übertragenden Seite angehängt wurden. Dies ist beispielsweise der Fall, wenn die Seite ein HTML-Formular enthält, auf dem die Methode GET verwendet wird. Die Abfragezeichenfolge besteht aus einem oder mehreren Name/Wert-Paaren (beispielsweise last=Smith, first=Winston), die mit einem Fragezeichen an die URL angehängt sind (?). Wenn die Abfragezeichenfolge mehrere Name/Wert-Paare hat, werden diese mit dem Und-Zeichen (&) verknüpft.

ruft Formularinformationen aus dem Hauptteil einer HTTP-Anforderung ab, die von einem HTML-Formular mit der Methode POST gesendet wird.

ruft die Werte von vordefinierten Umgebungsvariablen ab. Für die Sammlung stehen zahlreiche Variablen zur Verfügung, z. B. CONTENT_LENGTH (Länge des Inhalts, der an die HTTP-Anforderungen übertragen wird: hiermit kann überprüft werden, ob das Formular leer ist) und HTTP_USER_AGENT (Informationen über den Browser des Besuchers).

Mit Request.ServerVariables("HTTP_USER_AGENT") werden beispielsweise Informationen über den verwendeten Browser abgerufen. Das Ergebnis Mozilla/4.07 [en] (WinNT; I) bedeutet beispielsweise, dass Netscape Navigator 4.07 verwendet wird.

Eine vollständige Liste der ASP-Server-Umgebungsvariablen finden Sie in der Online-Dokumentation, die zusammen mit dem Microsoft Personal Web Server (PWS) oder Internet Information Server (IIS) installiert wurde.

ruft die Werte der Cookies ab, die in einer HTTP-Anforderung übertragen wurden. Angenommen, Ihre Seite liest ein Cookie namens „readMe“ im System des Benutzers. Auf dem Server werden die Werte des Cookies in der Variablen Request.Cookies("readMe") gespeichert.

ruft die Zertifizierungsfelder aus der vom Browser übertragenen HTTP-Anforderung ab. Die Zertifizierungsfelder sind nach dem X.509-Standard definiert.

Geben Sie an, auf welche Variable der Sammlung Sie zugreifen möchten. Klicken Sie dann auf „OK“.

Wenn Sie beispielsweise auf die Informationen in der Variable Request.ServerVariables("HTTP_USER_AGENT") zugreifen möchten, geben Sie das Argument HTTP_USER_AGENT ein. Wenn Sie auf die Daten in der Variablen Request.Form("lastname") zugreifen möchten, geben Sie das Argument lastname ein.

Die Anforderungsvariable wird im Bedienfeld „Bindungen“ angezeigt.

Öffnen Sie das Bedienfeld „Bindungen“ („Fenster“ > „Bindungen“).

Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+) und wählen Sie im Popup-Menü die Variable aus.

Geben Sie im Dialogfeld „Anforderungsvariable“ den Namen der Variablen (z. B. REQUEST_METHOD) ein und klicken Sie auf „OK“.

Weitere Informationen finden Sie über das Schlüsselwort „$_SERVER“ in der PHP-Dokumentation.

Geben Sie im Dialogfeld „Clientvariable“ den Namen der Variablen ein und klicken Sie auf „OK“.

Um beispielsweise auf die Informationen in der ColdFusion-Variable Client.LastVisit zuzugreifen, geben Sie LastVisit ein.

Clientvariablen sind Variablen, die im Code zum Verknüpfen von Daten mit einem bestimmten Client erstellt wurden. Sie werden verwendet, um den Status der Anwendung beizubehalten, wenn der Besucher der Site in der Anwendung von einer Seite zur nächsten wechselt. Der Status kann auch von einer Sitzung zur nächsten gespeichert werden.

Clientvariablen sind entweder benutzerdefiniert oder integriert. In der folgenden Tabelle sind die integrierten ColdFusion-Clientvariablen aufgeführt:

Geben Sie im Dialogfeld „Cookie-Variable“ den Namen der Cookie-Variablen ein und klicken Sie auf „OK“.

Geben Sie im Dialogfeld „CGI-Variable“ den Namen der Variablen ein und klicken Sie auf „OK“.

Wenn Sie beispielsweise auf die Informationen in der Variable CGI.HTTP_REFERER zugreifen möchten, geben Sie HTTP_REFERER ein.

In der folgenden Tabelle sind die gängigsten ColdFusion-CGI-Variablen aufgelistet, die auf dem Server erstellt werden:

Variable	Beschreibung
SERVER_SOFTWARE	Name und Version der Informationsserver-Software, die die Anforderung beantwortet (und das Gateway ausführt). Format: Name/Version.
SERVER_NAME	Hostname, DNS-Alias oder IP-Adresse des Servers, wie sie in selbst referenzierenden URLs angegeben sind.
GATEWAY_INTERFACE	Version der CGI-Spezifikation, der der Server entspricht. Format: CGI/Version.
SERVER_PROTOCOL	Name und Version des Informationsprotokolls, mit dem die Anforderung eingereicht wurde. Format: Protokoll/Revision.
SERVER_PORT	Nummer des Anschlusses, an den die Anforderung gesendet wurde.
REQUEST_METHOD	Methode, mit der die Anforderung durchgeführt wurde. Bei HTTP kann dies „Get“, „Head“, „Post“ usw. sein.
PATH_INFO	Vom Client zusätzlich bereitgestellte Pfadinformationen. Auf Skripts kann über ihren virtuellen Pfad, gefolgt von zusätzlichen Informationen, zugegriffen werden. Die zusätzlichen Informationen werden als PATH_INFO gesendet.
PATH_TRANSLATED	Der Server liefert eine übersetzte Version von PATH_INFO, bei der alle etwaigen virtuellen Pfadinformationen in physische umgewandelt werden.
SCRIPT_NAME	Ein virtueller Pfad zu dem auszuführenden Skript. Dient zur Selbstreferenzierung von URLs.
QUERY_STRING	Die Abfrageinformationen, die in der URL, die auf dieses Skript verweist, auf das Fragezeichen (?) folgen.
REMOTE_HOST	Name des Hosts, der die Anforderung durchführt. Wenn dem Server diese Informationen nicht zur Verfügung stehen, setzt er statt REMOTE_HOST die Variable REMOTE_ADDR.
REMOTE_ADDR	IP-Adresse des Remote-Hosts, der die Anforderung durchführt.
AUTH_TYPE	Wenn der Server Benutzerauthentifizierung unterstützt und das Skript geschützt ist, ist dies die protokollspezifische Methode zur Prüfung der Identität des Benutzers.
REMOTE_USER AUTH_USER	Wenn der Server Benutzerauthentifizierung unterstützt und das Skript geschützt ist, ist dies der Benutzername zur Identifizierung. (Auch als AUTH_USER verfügbar.)
REMOTE_IDENT	Wenn der HTTP-Server die RFC 931-Identifizierung unterstützt, wird diese Variable auf den Namen des Remote-Benutzers gesetzt, der vom Server abgerufen wird. Verwenden Sie diese Variable nur zur Protokollzwecken.
CONTENT_TYPE	Bei Abfragen, an die Informationen angehängt sind (z. B. HTTP POST und PUT), ist dies der Inhaltstyp der Daten.
CONTENT_LENGTH	Die Länge des Inhalts, wie vom Client vorgegeben.

In der folgenden Tabelle sind die gängigsten CGI-Variablen aufgelistet, die vom Browser erstellt und an den Server übergeben werden:

Klicken Sie auf den Pfeil rechts oben im Bedienfeld „Bindungen“ und aktivieren Sie im Popup-Menü die Option „Cache“.

Doppelklicken Sie im Bedienfeld „Bindungen“ („Fenster“ > „Bindungen“) auf den Namen der Inhaltsquelle, die Sie bearbeiten möchten.

Nehmen Sie die gewünschten Änderungen im angezeigten Dialogfeld vor.

Wenn Sie mit dem Ergebnis zufrieden sind, klicken Sie auf „OK“.

Wählen Sie im Bedienfeld „Bindungen“ („Fenster“ > „Bindungen“) eine Inhaltsquelle in der Liste aus.

Klicken Sie auf die Schaltfläche mit dem Minuszeichen (–).

Wählen Sie die Datensatzgruppe entweder im Bedienfeld „Bindungen“ oder im Bedienfeld „Serververhalten“ aus.

Klicken Sie mit der rechten Maustaste auf die Datensatzgruppe und wählen Sie im Popup-Menü die Option „Kopieren“.

Öffnen Sie die Seite, auf die Sie die Datensatzgruppe kopieren möchten.

Klicken Sie mit der rechten Maustaste auf das Bedienfeld „Bindungen“ oder die Symbolleiste „Serververhalten“ und wählen Sie im Popup-Menü die Option „Einfügen“.