Quellen für dynamische Inhalte definieren

Zuletzt aktualisiert am 25. April 2024
Anmerkung

Die Benutzeroberfläche wurde in Dreamweaver vereinfacht. Daher kann es sein, dass einige der in diesem Artikel beschriebenen Optionen in Ihrer Version von Dreamweaver nicht vorhanden sind. Weitere Informationen finden Sie in diesem Artikel.

Definiere ein Recordset, ohne SQL zu schreiben

Du kannst ein Recordset erstellen, ohne manuell SQL-Anweisungen einzugeben.

Öffne im Dokumentfenster die Seite, die das Recordset verwenden soll.
Wähle Fenster > Bindungen, um das Bedienfeld Bindungen anzuzeigen.
Klicke im Bedienfeld Bindungen auf den Plus-Button (+) und wähle Recordset (Abfrage) aus dem Popup-Menü.

Das einfache Dialogfeld „Datensatzgruppe“ wird angezeigt. Wenn du eine ColdFusion-Website entwickelst, sieht das Recordset-Dialogfeld etwas anders aus.(Falls stattdessen das erweiterte Recordset-Dialogfeld erscheint, klicke auf den Button Einfach, um zum einfachen Recordset-Dialogfeld zu wechseln.)

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

Anweisungen hierzu finden Sie in folgenden Themen:

Klicke auf den Button Test, um die Abfrage auszuführen und sicherzustellen, dass sie die gewünschten Informationen abruft.

Wenn du einen Filter definiert hast, der Parameter verwendet, die von Anwendern eingegeben werden, gib einen Wert in das Feld Testwert ein und klicke auf OK.Wenn eine Instanz des Recordsets erfolgreich erstellt wurde, erscheint eine Tabelle mit den aus dem Recordset extrahierten Daten.

Klicke auf OK, um das Recordset zur Liste der verfügbaren Inhaltsquellen im Bedienfeld Bindungen hinzuzufügen.

Optionen für das einfache Recordset-Dialogfeld (PHP, ASP)

Gib im Feld Name einen Namen für das Recordset ein.

Eine gängige Praxis ist es, das Präfix rs zu Recordset-Namen hinzuzufügen, um sie von anderen Objektnamen im Code zu unterscheiden, zum Beispiel: rsPressReleases.

Recordset-Namen dürfen nur Buchstaben, Zahlen und den Unterstrich (_) enthalten.Sonderzeichen und Leerzeichen sind nicht zulässig.

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

Falls keine Verbindung in der Liste erscheint, klicke auf Definieren, um eine zu erstellen.

Wähle im Popup-Menü Tabelle die Datenbanktabelle aus, die Daten für das Recordset bereitstellen soll.

Das Popup-Menü zeigt alle Tabellen in der angegebenen Datenbank an.

Um nur eine Teilmenge der Tabellenspalten in das Recordset einzubeziehen, klicke auf Ausgewählt und wähle die gewünschten Spalten aus, indem du sie bei gedrückter Strg-Taste (Windows) oder Befehlstaste (Macintosh) in der Liste anklickst.

Um die von der Tabelle zurückgegebenen Datensätze weiter einzuschränken, fülle den Abschnitt Filter aus:

  • Wähle aus dem ersten Popup-Menü eine Spalte in der Datenbanktabelle aus, die mit einem von dir definierten Testwert verglichen werden soll.

  • Wähle aus dem zweiten Popup-Menü einen bedingten Ausdruck aus, um den ausgewählten Wert in jedem Datensatz mit dem Testwert zu vergleichen.

  • Wählen Sie im dritten Popupmenü die Option „Eingegebener Wert“.

  • Geben Sie den Testwert in das Feld ein.

    Wenn der angegebene Wert in einem Datensatz deine Filterungsbedingung erfüllt, wird der Datensatz in das Recordset aufgenommen.

(Optional) Um die Datensätze zu sortieren, wähle eine Spalte zum Sortieren aus und gib dann an, ob die Datensätze in aufsteigender Reihenfolge (1, 2, 3...oder A, B, C...) sortiert werden sollen.oder in absteigender Reihenfolge.

Klicke auf Test, um eine Verbindung zur Datenbank herzustellen und eine Instanz der Datenquelle zu erstellen, und klicke auf OK, um die Datenquelle zu schließen.

Eine Tabelle wird angezeigt, die die zurückgegebenen Daten zeigt.Jede Zeile enthält einen Datensatz und jede Spalte repräsentiert ein Feld in diesem Datensatz.

Klicken Sie auf „OK“. Das neu definierte Recordset wird im Bindungen-Bedienfeld angezeigt.

Optionen für das einfache Recordset-Dialogfeld (ColdFusion)

Definiere ein Recordset für ColdFusion-Dokumenttypen als Quelle für dynamischen Content, ohne dass du SQL-Anweisungen von Hand programmieren musst.

Gib im Feld Name einen Namen für das Recordset ein.

Eine gängige Praxis ist es, das Präfix rs zu Recordset-Namen hinzuzufügen, um sie von anderen Objektnamen in deinem Code zu unterscheiden.Beispiel: rsPressReleases

Recordset-Namen können nur Buchstaben, Zahlen und den Unterstrich (_) enthalten.Sonderzeichen und Leerzeichen sind nicht zulässig.

Wenn du ein Recordset für eine ColdFusion-Komponente definierst (das heißt, wenn eine CFC-Datei derzeit in Dreamweaver geöffnet ist), wähle eine vorhandene CFC-Funktion aus dem Popup-Menü Funktion aus oder klicke auf die Schaltfläche Neue Funktion, um eine neue Funktion zu erstellen.

Anmerkung

Das Popup-Menü Funktion ist nur verfügbar, wenn eine CFC-Datei das aktuelle Dokument ist und du Zugriff auf einen Computer mit ColdFusion MX 7 oder besser hast.

Das Recordset ist in der Funktion definiert.

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

Wenn keine Datenquelle im Popup-Menü angezeigt wird, musst du eine ColdFusion-Datenquelle erstellen.

Gib in den Feldern Benutzername und Kennwort den Benutzernamen und das Kennwort für den ColdFusion-Anwendungsserver ein, falls erforderlich.

Datenquellen in ColdFusion erfordern möglicherweise einen Benutzernamen und ein Kennwort für den Zugriff. Wenn du nicht über den Benutzernamen und das Kennwort für den Zugriff auf eine Datenquelle in ColdFusion verfügst, wende dich an den ColdFusion-Administrator deiner Organisation.

Wähle im Popup-Menü Tabelle die Datenbanktabelle aus, die Daten für das Recordset bereitstellt.

Das Popup-Menü Tabelle zeigt alle Tabellen in der angegebenen Datenbank an.

Um eine Teilmenge der Tabellenspalten in das Recordset einzubeziehen, klicke auf Ausgewählt und wähle die gewünschten Spalten aus, indem du sie bei gedrückter Strg-Taste (Windows) oder Befehlstaste (Macintosh) in der Liste anklickst.

Um die von der Tabelle zurückgegebenen Datensätze weiter zu begrenzen, vervollständige den Abschnitt Filter:

  • Wähle aus dem ersten Popup-Menü eine Spalte in der Datenbanktabelle aus, die mit einem von dir definierten Testwert verglichen werden soll.

  • Wähle aus dem zweiten Popup-Menü einen bedingten Ausdruck aus, um den ausgewählten Wert in jedem Datensatz mit dem Testwert zu vergleichen.

  • Wählen Sie im dritten Popupmenü die Option „Eingegebener Wert“.

  • Geben Sie den Testwert in das Feld ein.

    Wenn der angegebene Wert in einem Datensatz deine Filterbedingung erfüllt, wird der Datensatz in das Recordset einbezogen.

(Optional) Um die Datensätze zu sortieren, wähle eine Spalte zum Sortieren aus und gib dann an, ob die Datensätze in aufsteigender (1, 2, 3...oder A, B, C...) oder in absteigender Reihenfolge.

Klicke auf Test, um eine Verbindung zur Datenbank herzustellen und eine Instanz der Datenquelle zu erstellen.

Eine Tabelle erscheint und zeigt die zurückgegebenen Daten an.Jede Zeile enthält einen Datensatz und jede Spalte repräsentiert ein Feld in diesem Datensatz. Klicken Sie auf „OK“, um die Testdatensatzgruppe zu schließen.

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

Erweiterte Recordsets durch Schreiben von SQL definieren

Schreibe deine eigenen SQL-Anweisungen mit dem erweiterten Recordset-Dialogfeld oder erstelle eine SQL-Anweisung mit dem grafischen Datenbankeinträge-Baum.

Öffne im Dokumentfenster die Seite, die das Recordset verwenden soll.
Wähle Fenster > Bindungen, um das Bedienfeld Bindungen anzuzeigen.
Klicke im Bedienfeld Bindungen auf den Plus-Button (+) und wähle Recordset (Abfrage) aus dem Popup-Menü.

Das erweiterte Dialogfeld „Datensatzgruppe“ wird eingeblendet. Wenn du einen ColdFusion-Bereich entwickelst, ist das Recordset-Dialogfeld etwas anders. (Falls stattdessen das einfache Recordset-Dialogfeld angezeigt wird, wechsle zum erweiterten Recordset-Dialogfeld, indem du auf den Button „Erweitert" klickst.)

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

Anweisungen hierzu finden Sie in folgenden Themen:

Klicke auf den Button Test, um die Abfrage auszuführen und sicherzustellen, dass sie die gewünschten Informationen abruft.

Wenn du einen Filter definiert hast, der Parameter verwendet, die von Anwendern eingegeben werden, zeigt der Button „Test" das Dialogfeld „Testwert" an.Gib einen Wert\nin das Feld „Test-Wert" ein und klicke auf „OK".Wenn eine Instanz des Recordsets erfolgreich erstellt wird, erscheint eine Tabelle, die die Daten aus dem Recordset anzeigt.

Klicke auf „OK", um das Recordset zur Liste der verfügbaren\nInhaltsquellen im Bedienfeld „Bindungen" hinzuzufügen.

Optionen für das erweiterte Recordset-Dialogfeld (PHP, ASP)

Definiere ein Recordset als Quelle für dynamische Inhalte, indem du eine benutzerdefinierte SQL-Anweisung schreibst oder eine SQL- Anweisung mit dem grafischen Datenbankeinträge-Baum erstellst.

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

Eine gängige Praxis ist es, das Präfix rs zu Recordset-Namen hinzuzufügen, um sie von anderen Objektnamen im Code zu unterscheiden.Beispiel: rsPressRelease

Recordset-Namen dürfen nur Buchstaben, Zahlen und den Unterstrich (_) enthalten. Du kannst keine Sonderzeichen oder Leerzeichen verwenden.

Wählen Sie im Popup-Menü „Verbindung“ eine Verbindung aus.
Gib eine SQL-Anweisung in den SQL-Textbereich ein oder verwende den grafischen Datenbankeinträge-Baum am unteren Rand des Dialogfelds, um eine SQL-Anweisung aus dem gewählten Recordset aufzubauen.

Führe die folgenden Schritte aus, um den Datenbankeinträge-Baum zum Aufbau der SQL-Anweisung zu verwenden:

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

  • Erweitere die Äste des Baums, bis du das Datenbankobjekt findest, das du benötigst – eine Spalte in einer Tabelle zum Beispiel oder eine gespeicherte Prozedur in der Datenbank.

  • Wähle das Datenbankobjekt aus und klicke auf einen der Buttons auf der rechten Seite des Baums.

    Wenn du zum Beispiel eine Tabellenspalte auswählst, stehen dir die Schaltflächen SELECT, WHERE und ORDER BY zur Verfügung.Klicke auf einen der Buttons, um die zugehörige Klausel zu deiner SQL-Anweisung hinzuzufügen.

    Du kannst auch eine vordefinierte SQL-Anweisung in einer gespeicherten Prozedur verwenden, indem du die gespeicherte Prozedur aus dem Datenbankeinträge-Baum auswählst und auf den Button Prozedur klickst. Dreamweaver füllt automatisch die SQL- und Variablen-Bereiche aus.

Wenn die SQL-Anweisung Variablen enthält, definiere ihre Werte im Variablen-Bereich, indem du auf die Schaltfläche Plus (+) klickst und den Namen der Variable, den Typ (Ganzzahl, Text, Datum oder Fließkommazahl), den Standardwert (der Wert, den die Variable annehmen soll, wenn kein Laufzeitwert zurückgegeben wird) und den Laufzeitwert eingibst.
Anmerkung

Wenn du Variablen in einer SQL-Anweisung in PHP verwendest, fügt Dreamweaver automatisch ein vorangestelltes Dollarzeichen zum Variablennamen hinzu, daher solltest du das Dollarzeichen weglassen (z. B. colname anstatt $colname).

Wenn die SQL-Anweisung Variablen enthält, stelle sicher, dass die Spalte Standardwert im Variablen-Feld gültige Testwerte enthält.

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

URL-Parameter in der Spalte Laufzeitwert:

Servermodell

Laufzeitwertausdrücke für URL-Parameter

ASP

Request.QueryString("formFieldName")

PHP

$_GET['formFieldName']

Formularparameter in der Spalte „Laufzeitwert“:

Servermodell

Laufzeitwertausdrücke für Formularparameter

ASP

Request.Form("formFieldName")

PHP

$_POST['formFieldName']

Klicke auf Test, um die Verbindung zur Datenbank zu testen und eine Instanz des Recordsets zu erstellen.

Wenn die SQL-Anweisung Variablen enthält, stelle sicher, dass die Spalte Standardwert im Variablen-Feld gültige Testwerte enthält, bevor du auf Test klickst.

Bei erfolgreichem Ausführen erscheint eine Tabelle, die die Daten in deinem Recordset anzeigt. Jede Zeile enthält einen Datensatz und jede Spalte stellt ein Feld in diesem Datensatz dar. Klicke auf OK, um das Recordset zu schließen.

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

Optionen für das erweiterte Recordset-Dialogfeld (ColdFusion)

Verwende das erweiterte Recordset-Dialogfeld, um benutzerdefinierte SQL-Abfragen zu schreiben oder verwende den Datenbankeinträge-Baum, um SQL-Abfragen mit einer Point-and-Click-Oberfläche zu erstellen.

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

Eine gängige Praxis ist es, das Präfix rs zu Recordset-Namen hinzuzufügen, um sie von anderen Objektnamen in Ihrem Code zu unterscheiden.Beispiel: rsPressReleases

Recordset-Namen können nur Buchstaben, Zahlen und den Unterstrich (_) enthalten. Sonderzeichen und Leerzeichen sind nicht zulässig.

Wenn du ein Recordset für eine ColdFusion-Komponente definierst (das heißt, wenn eine CFC-Datei aktuell in Dreamweaver geöffnet ist), wähle eine vorhandene CFC-Funktion aus dem Popup-Menü Funktion aus oder klicke auf den Button Neue Funktion, um eine neue Funktion zu erstellen.

Anmerkung

Das Popup-Menü Funktion ist nur verfügbar, wenn eine CFC-Datei das aktuelle Dokument ist und du Zugriff auf einen Computer mit ColdFusion MX 7 oder neuer hast.

Das Recordset wird in der Funktion definiert.

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

Wenn keine Datenquelle in der Popup-Menü-Liste angezeigt wird, musst du zuerst eine ColdFusion-Datenquelle erstellen.

Gib in den Feldern Benutzername und Kennwort den Benutzernamen und das Kennwort für den ColdFusion-Anwendungsserver ein, falls erforderlich.

Datenquellen in ColdFusion erfordern möglicherweise einen Benutzernamen und ein Kennwort für den Zugriff.Wenn du den Benutzernamen und das Kennwort für den Zugriff auf eine Datenquelle in ColdFusion nicht hast, wende dich an den ColdFusion-Administrator deiner Organisation.

Gib eine SQL-Anweisung in den SQL-Textbereich ein oder verwende die grafische Datenbankeinträge-Struktur am unteren Rand des Dialogfelds, um eine SQL-Anweisung aus dem ausgewählten Recordset aufzubauen.
(Optional) Führe die folgenden Schritte aus, um die Datenbankeinträge-Struktur zum Aufbau der SQL-Anweisung zu verwenden:
  • Vergewissern Sie sich, dass der SQL-Textbereich leer ist.

  • Erweitere die Zweige der Struktur, bis du das benötigte Datenbankobjekt findest – beispielsweise eine Spalte in einer Tabelle.

  • Wähle das Datenbankobjekt aus und klicke auf eine der Schaltflächen auf der rechten Seite der Struktur.

Wenn du beispielsweise eine Tabellenspalte auswählst, sind die verfügbaren Schaltflächen Select, Where und Order By.Klicke auf eine der Schaltflächen, um die zugehörige Klausel zu deiner SQL-Anweisung hinzuzufügen.

Wenn deine SQL-Anweisung Parameter enthält, definiere ihre Werte im Parameter-Bereich, indem du auf die Plus-Schaltfläche (+) klickst und den Namen des Parameters und den Standardwert eingibst (der Wert, den der Parameter annehmen soll, wenn kein Laufzeitwert zurückgegeben wird).

Wenn die SQL-Anweisung Parameter enthält, stelle sicher, dass die Spalte Standardwert des Parameter- felds gültige Testwerte enthält.

Die Seitenparameter ermöglichen es dir, Standardwerte für Laufzeitwert-Referenzen in der SQL anzugeben, die du schreibst.Die folgende SQL-Anweisung wählt beispielsweise einen Mitarbeiterdatensatz basierend auf dem Wert der Mitarbeiter-ID aus.Du kannst diesem Parameter einen Standardwert zuweisen und so sicherstellen, dass immer ein Laufzeit- wert zurückgegeben wird.In diesem Beispiel bezieht sich FormFieldName auf ein Formularfeld, in das der Benutzer eine Mitarbeiter-ID eingibt:

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

Das Dialogfeld Seitenparameter hinzufügen würde eine Name-Wert-Zuordnung enthalten, die etwa so aussieht:

Spry-QuickInfo

Standardwerte

Formularfeldname

0001

Der Laufzeitwert ist normalerweise ein URL- oder Formularparameter, den ein Benutzer in ein HTML-Formularfeld eingibt.

Klicke auf Test, um eine Verbindung zur Datenbank herzustellen und eine Instanz des Recordsets zu erstellen.

Wenn die SQL-Anweisung Laufzeit-Referenzen enthält, stelle sicher, dass die Spalte Standardwert des Felds Seitenparameter gültige Testwerte enthält, bevor du auf Test klickst.

Bei erfolgreichem Abschluss wird eine Tabelle angezeigt, die die Daten in deinem Recordset zeigt.Jede Zeile enthält einen Datensatz und jede Spalte stellt ein Feld in diesem Datensatz dar.Klicke auf OK, um das Recordset zu löschen.

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

Parameter in einer SQL-Anweisung definieren (ColdFusion)

Definiere Parameter in einer SQL-Anweisung; der Standardwert ist der Wert, den der Parameter verwenden soll, wenn kein Laufzeitwert zurückgegeben wird.

Wählen Sie im Popup-Menü „Name“ einen Parameternamen aus.
Gib einen Standardwert für den Parameter in das Feld Standardparameter ein und klicke auf OK.

Parameter in einer SQL-Anweisung definieren (PHP)

Definiere Parameter in einer SQL-Anweisung; der Standardwert ist der Wert, den der Parameter verwenden soll, wenn kein Laufzeitwert zurückgegeben wird.

Geben Sie im Feld „Name“ einen Namen für den Parameter ein.
Gib einen Standardwert für den Parameter in das Feld Standardparameter ein.
Gib einen Laufzeitwert für einen Parameter in das Feld Laufzeitwert ein und klicke auf OK.

SQL-Abfragen mit dem Datenbankeinträge-Baum erstellen

Anstatt SQL-Anweisungen manuell in das SQL-Feld einzugeben, kannst du die Point-and-Click-Oberfläche der Datenbankeinträge verwenden, um komplexe SQL-Abfragen zu erstellen.Der Datenbankeinträge-Baum ermöglicht es dir, Datenbankobjekte auszuwählen und sie mit den SQL-Klauseln SELECT, WHERE und ORDER BY zu verknüpfen.Nachdem du eine SQL-Abfrage erstellt hast, kannst du alle Variablen im Bereich Variablen des Dialogfelds definieren.

Die nächsten beiden Beispiele beschreiben zwei SQL-Anweisungen und die Schritte zum Erstellen mithilfe des Datenbankeinträge-Baums im erweiterten Recordset-Dialogfeld.

Beispiel: Tabellen auswählen

Dieses Beispiel wählt den gesamten Inhalt der Tabelle Employees aus.Die SQL-Anweisung, die die Abfrage definiert, wird folgendermaßen angezeigt:

SELECT * FROM Employees

Um diese Abfrage zu erstellen, führe diese Schritte aus.

Erweitere den Tables-Zweig, um alle Tabellen in der ausgewählten Datenbank anzuzeigen.
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.

Beispiel: Auswählen bestimmter Zeilen aus einer Tabelle und Anordnen der Ergebnisse

Das folgende Beispiel wählt zwei Zeilen aus der Employees-Tabelle aus und wählt den Jobtyp mithilfe einer Variablen aus, die du definieren musst. Die Ergebnisse werden dann nach Mitarbeiternamen sortiert.

SELECT emplNo, emplName

FROM Employees

WHERE emplJob = 'varJob'

ORDER BY emplName

Erweitere den Tables-Zweig, um alle Tabellen in der ausgewählten Datenbank anzuzeigen; erweitere dann die Employees-Tabelle, um die einzelnen Tabellenzeilen anzuzeigen.
Stellen Sie die SQL-Anweisung folgendermaßen zusammen:
  • Wähle emplNo aus und klicke auf die Schaltfläche Auswählen.

  • Wähle emplName aus und klicke auf die Schaltfläche Auswählen.

  • Wähle emplJob aus und klicke auf die Schaltfläche Where.

  • Wähle emplName aus und klicke auf den Button „Sortieren nach".

Platziere den Einfügepunkt nach WHERE emplJob im SQL-Textbereich und gib ='varJob' ein (inklusive Gleichheitszeichen).
Definiere die Variable 'varJob', indem du auf den Plus-Button (+) im Bereich Variablen klickst und die folgenden Werte in den Spalten Name, Standardwert und Laufzeitwert eingibst: varJob, CLERK, Request("job").
Klicken Sie auf „OK“, um die Datensatzgruppe dem Bedienfeld „Bindungen“ hinzuzufügen.

URL-Parameter definieren

URL-Parameter speichern von Anwendern eingegebene Informationen.Bevor du anfängst, stelle sicher, dass du ein Formular oder einen URL- Parameter an den Server übergibst.Nachdem du die URL-Variable definiert hast, kannst du ihren Wert in der aktuell ausgewählten Seite verwenden.

Öffne im Dokumentfenster die Seite, die die Variable verwenden wird.
Wähle Fenster > Bindungen, um das Bedienfeld Bindungen anzuzeigen.
Klicke im Bedienfeld Bindungen auf den Plus-Button (+) und wähle eine der folgenden Optionen aus dem Popup-Menü:

Dokumenttypen

Menübefehl im Bedienfeld „Bindungen“ für URL-Variable

ASP

Anforderungsvariable > Request.QueryString

ColdFusion

URL-Variable

PHP

URL-Variable

Gib im Dialogfeld URL-Variable den Namen der URL-Variable in das Feld ein und klicke auf OK.

Der Name der URL-Variable ist normalerweise der Name des HTML-Formularfelds oder -objekts, das zum Abrufen seines Werts verwendet wird.

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

Formularparameter definieren

Formularparameter speichern abgerufene Informationen, die in der HTTP-Anfrage für eine Web-Seite enthalten sind.Wenn du ein Formular erstellst, das die POST-Methode verwendet, werden die vom Formular übermittelten Daten an den Server weitergegeben. Bevor du beginnst, stelle sicher, dass du einen Formularparameter an den Server übergibst. Nachdem du den Formularparameter als Content-Quelle definiert hast, kannst du seinen Wert auf deiner Seite verwenden.

Öffne im Dokumentfenster die Seite, die die Variable verwenden soll.
Wähle Fenster > Bindungen, um das Bedienfeld Bindungen anzuzeigen.
Klicke im Bedienfeld Bindungen auf den Plus-Button (+) und wähle eine der folgenden Optionen aus dem Popup-Menü:

Dokumenttypen

Menübefehl im Bedienfeld „Bindungen“ für Formularvariable

ASP

Anforderungsvariable > Request.Form

ColdFusion

Formularvariable

PHP

Formularvariable

Gib im Dialogfeld Formularvariable den Namen der Formularvariable ein und klicke auf OK. Der Formularparametername ist normalerweise der Name des HTML-Formularfelds oder -objekts, das zur Erfassung seines Werts verwendet wird.

Der Formularparameter wird im Bedienfeld „Bindungen“ angezeigt.

Bedienfeld „Bindungen“ mit angezeigten Formularvariablen im Bereich „Form“
Bedienfeld „Bindungen“ mit angezeigten Formularvariablen im Bereich „Form“

Sitzungsvariablen definieren

Du kannst Session-Variablen verwenden, um Informationen zu speichern und anzuzeigen, die für die Dauer eines Benutzerbesuchs (oder einer Session) aufrechterhalten werden. Der Server erstellt für jeden Benutzer ein anderes Session-Objekt und behält es für einen festgelegten Zeitraum bei oder bis das Objekt explizit beendet wird.

Bevor du Session-Variablen für eine Seite definierst, musst du sie im Quellcode erstellen. Nachdem du eine Session-Variable im Quellcode der Web-Anwendung erstellt hast, kannst du Dreamweaver verwenden, um ihren Wert abzurufen und in einer Web-Seite zu verwenden.

Erstelle eine Session-Variable im Quellcode und weise ihr einen Wert zu.

Dieses ColdFusion-Beispiel instanziiert beispielsweise eine Session mit dem Namen username und weist ihr den Wert Cornelius zu:

<CFSET session.username = Cornelius>

Wähle Fenster > Bindungen aus, um das Bedienfeld Bindungen anzuzeigen.
Klicke auf den Plus-Button (+) und wähle Session-Variable aus dem Popup-Menü aus.
Gib den Namen der Variable ein, die du im Quell-Code der Anwendung definiert hast, und klicke auf OK.

Anwendungsvariablen für ASP und ColdFusion definieren

In ASP und ColdFusion kannst du Anwendungsvariablen verwenden, um Informationen zu speichern und anzuzeigen, die für die Lebensdauer der Anwendung gespeichert werden und von Benutzer zu Benutzer bestehen bleiben. Nachdem du die Anwendungsvariable definiert hast, kannst du ihren Wert auf einer Seite verwenden.

Anmerkung

In PHP gibt es keine Anwendungsvariablenobjekte.

Öffnen Sie ein dynamisches Dokument im Dokumentfenster.
Wähle Fenster > Bindungen aus, um das Bedienfeld Bindungen anzuzeigen.
Klicke auf den Plus-Button (+) und wähle Anwendungsvariable aus dem Popup-Menü aus.
Gib den Namen der Variable ein, wie er im Quell-Code der Anwendung definiert wurde, und klicke auf OK.

Die Anwendungsvariable wird im Bedienfeld Bindungen unter dem Symbol Anwendung angezeigt.

Bedienfeld „Bindungen“ mit angezeigten Anwendungsvariablen im Bereich „Application“
Bedienfeld „Bindungen“ mit angezeigten Anwendungsvariablen im Bereich „Application“

Eine Variable als Datenquelle für ein ColdFusion-Recordset verwenden

Wenn du ein Recordset für eine Seite im Bedienfeld Bindungen definierst, gibt Dreamweaver den Namen der ColdFusion-Datenquelle im cfquery-Tag auf der Seite ein. Für mehr Flexibilität kannst du einen Data Source Name in einer Variable speichern und die Variable im cfquery-Tag verwenden. Dreamweaver bietet eine visuelle Methode zur Angabe einer solchen Variable in deinen Recordsets.

Stelle sicher, dass eine ColdFusion-Seite im Dokumentfenster aktiv ist.
Klicke im Bedienfeld Bindungen auf den Plus-Button (+) und wähle Data Source Name-Variable aus dem Popup-Menü aus.

Das Dialogfeld „DSN-Variable“ wird eingeblendet.

Definieren Sie eine Variable und klicken Sie auf „OK“.
Wähle beim Definieren des Recordsets die Variable als Datenquelle für das Recordset aus.

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

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

Dreamweaver initialisiert die Variable nicht für dich, damit du sie so und dort initialisieren kannst, wo du möchtest. Du kannst die Variable im Seiten-Code (vor dem cfquery-Tag), in einer Include-Datei oder in einer anderen Datei als Session- oder Anwendungsvariable initialisieren.

Servervariablen definieren

Du definierst Servervariablen als Quellen für dynamische Inhalte zur Verwendung innerhalb einer Web-Anwendung. Servervariablen variieren von Dokumenttyp zu Dokumenttyp und umfassen Formularvariablen, URL-Variablen, Session-Variablen und Anwendungsvariablen.

Server-Variablen können von allen Clients, die auf den Server zugreifen, und von allen Anwendungen, die auf dem Server ausgeführt werden, aufgerufen werden. Die Variablen bleiben bestehen, bis der Server angehalten wird.

ColdFusion-Servervariablen definieren

Öffne das Bedienfeld Bindungen (Fenster > Bindungen). Gib im Dialogfeld Server-Variable den Namen der Server-Variablen ein und klicke auf OK.
Klicke auf den Plus-Button (+) und wähle die Server-Variable aus dem Popup-Menü aus.
Geben Sie den Namen der Variablen ein und klicken Sie auf „OK“. Die ColdFusion Server-Variable wird im Bedienfeld Bindungen angezeigt.

Die folgende Tabelle listet die integrierten ColdFusion-Server-Variablen auf:

Variable

Beschreibung

Server.ColdFusion.ProductName

ColdFusion-Produktname.

Server.ColdFusion.ProductVersion

ColdFusion-Versionsnummer.

Server.ColdFusion.ProductLevel

ColdFusion-Edition (Enterprise, Professional).

Server.ColdFusion.SerialNumber

Seriennummer der aktuell installierten Version von ColdFusion.

Server.OS.Name

Name des Betriebssystems, das auf dem Server ausgeführt wird (Windows XP, Windows 2000, Linux).

Server.OS.AdditionalInformation

Zusätzliche Informationen über das installierte Betriebssystem (Service Packs, Updates).

Server.OS.Version

Version des installierten Betriebssystems.

Server.OS.BuildNumber

Build-Nummer des installierten Betriebssystems.

Lokale ColdFusion-Variablen definieren

Lokale Variablen sind Variablen, die mit dem CFSET- oder CFPARAM-Tag innerhalb einer ColdFusion-Seite erstellt werden. Die definierte lokale Variable wird im Bedienfeld Bindungen angezeigt.

Im Dialogfeld „Lokale Variable" gibst du den Namen der lokalen Variablen ein und klickst auf „OK".

ASP-Servervariablen definieren

Du kannst die folgenden ASP-Server-Variablen als Quellen für dynamische Inhalte definieren: Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables und Request.ClientCertificates.

Bindings-Bedienfeld öffnen (Fenster > Bindings).
Klicke auf den Plus-Button (+) und wähle Variable anfordern aus dem Popup-Menü aus.
Wähle im Dialogfeld Variable anfordern eine der folgenden Anfrage-Sammlungen aus dem Popup-Menü Typ aus:

Die QueryString-Sammlung

Ruft Informationen ab, die an die URL der sendenden Seite angehängt werden, z. B. wenn die Seite ein HTML-Formular mit der GET-Methode hat. Die Abfragezeichenfolge besteht aus einem oder mehreren Name-Wert-Paaren (z. B. last=Smith, first=Winston), die mit einem Fragezeichen (?) an die URL angehängt werden. Wenn die Abfragezeichenfolge mehr als ein Name-Wert-Paar enthält, werden sie mit Und-Zeichen (&) kombiniert.

Die Formular-Sammlung

Ruft Formularinformationen ab, die im Hauptteil der HTTP-Anfrage von einem HTML-Formular mit der POST-Methode enthalten sind.

Die ServerVariables-Sammlung

ruft die Werte von vordefinierten Umgebungsvariablen ab. Die Sammlung enthält eine lange Liste von Variablen, einschließlich CONTENT_LENGTH (die Länge des in der HTTP-Anfrage übermittelten Inhalts, womit du prüfen kannst, ob ein Formular leer ist) und HTTP_USER_AGENT (liefert Informationen über den Browser des Benutzers).

Zum Beispiel enthält Request.ServerVariables("HTTP_USER_AGENT") Informationen über den sendenden Browser, wie z. B. Mozilla/4.07 [en] (WinNT; I), was einen Netscape Navigator 4.07 Browser kennzeichnet.

Eine vollständige Liste der ASP-Serverumgebungsvariablen findest du in der online-Dokumentation, die mit Microsoft Personal Web Server (PWS) oder Internet Information Server (IIS) installiert wird.

Die Cookies-Sammlung

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

Die ClientCertificate-Sammlung

Ruft die Zertifizierungsfelder aus der HTTP-Anfrage ab, die vom Browser gesendet wurde.Die Zertifizierungsfelder sind im X.509-Standard spezifiziert.

Gib die Variable in der Sammlung an, auf die du zugreifen möchtest, und klicke auf OK.

Wenn du beispielsweise auf die Informationen in der Variable Request.ServerVariables("HTTP_USER_AGENT") zugreifen möchtest, gib das Argument HTTP_USER_AGENT ein.Wenn du auf die Informationen in der Variable Request.Form("lastname") zugreifen möchtest, gib das Argument lastname ein.

Die Request-Variable wird im Bindungen-Bedienfeld angezeigt.

PHP-Servervariablen definieren

Definiere Server-Variablen als Quelle für dynamische Inhalte für PHP-Seiten.Die PHP-Server-Variablen werden im Bindungen-Bedienfeld angezeigt.

Öffne das Bindungen-Bedienfeld (Fenster > Bindungen).
Klicke auf den Plus-Button (+) und wähle die Variable aus dem Popup-Menü aus.
Gib im Dialogfeld Request-Variable den Namen der Variable ein (zum Beispiel REQUEST_METHOD) und klicke auf OK.

Für weitere Informationen suche nach dem Keyword $_SERVER in der PHP-Dokumentation.

ColdFusion-Clientvariablen definieren

Definiere eine ColdFusion-Clientvariable als Quelle für dynamische Inhalte für die Seite.Die neu definierten ColdFusion Client-Variablen werden im Bindungen-Bedienfeld angezeigt.

Gib im Dialogfeld Client-Variable den Namen der Variable ein und klicke auf OK.

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

Client-Variablen sind Variablen, die im Code erstellt werden, um Daten mit einem bestimmten Client zu verknüpfen.Client-Variablen erhalten den Status der Anwendung aufrecht, während der User von Seite zu Seite innerhalb der Anwendung navigiert sowie von Session zu Session.

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

Variable

Beschreibung

Client.CFID

Eine fortlaufende ID für jeden Client, der sich mit dem Server verbindet.

Client.CFTOKEN

Eine zufällig generierte Nummer, die zur eindeutigen Identifizierung eines bestimmten Clients verwendet wird.

Client.URLToken

Eine Kombination aus CFID und CFTOKEN, die zwischen Templates weitergegeben wird, wenn keine Cookies verwendet werden.

Client.LastVisit

Zeichnet den Zeitstempel des letzten Besuchs eines Clients auf.

Client.HitCount

Die Anzahl der Seitenanfragen, die mit einem einzelnen Client verknüpft sind (verfolgt über CFID und CFTOKEN).

Client.TimeCreated

Zeichnet den Zeitstempel auf, wann CFID und CFTOKEN erstmals für einen bestimmten Client erstellt wurden.

Cookie-Variablen werden im Code erstellt und greifen auf Informationen zu, die in Cookies enthalten sind, die von einem Browser an den Server übertragen werden. Die definierte Cookie-Variable wird im Bindings- Bedienfeld angezeigt.

Gib im Dialogfeld Cookie-Variable den Namen der Cookie-Variable ein und klicke auf OK.

ColdFusion-CGI-Variablen definieren

Die definierte CGI-Variable wird im Bindings- Bedienfeld angezeigt.

Gib im Dialogfeld CGI-Variable den Namen der Variable ein und klicke auf OK.

Möchtest du beispielsweise auf die Informationen in der CGI.HTTP_REFERER Variable zugreifen, gib HTTP_REFERER ein.

Die folgende Tabelle listet die häufigsten ColdFusion CGI-Variablen auf, die auf dem Server erstellt werden:

Variable

Beschreibung

SERVER_SOFTWARE

Der Name und die Version der Informations- server-Software, die die Anfrage beantwortet (und das Gateway ausführt). Format: Name/Version.

SERVER_NAME

Der Hostname, DNS-Alias oder die IP- Adresse des Servers, wie sie in selbstreferenzierenden URLs angezeigt wird.

GATEWAY_INTERFACE

Die Revision der CGI-Spezifikation, der dieser Server entspricht. Format: CGI/Version.

SERVER_PROTOCOL

Der Name und die Revision des Informations- protokolls, mit dem diese Anfrage eingegangen ist. Format: Protokoll/Revision.

SERVER_PORT

Die Port-Nummer, an die die Anfrage gesendet wurde.

REQUEST_METHOD

Methode, mit der die Anforderung durchgeführt wurde. Bei HTTP kann dies „Get“, „Head“, „Post“ usw. sein.

PATH_INFO

Die zusätzlichen Pfad-Informationen, wie sie vom Client angegeben wurden. Skripte können über ihren virtuellen Pfadnamen aufgerufen werden, gefolgt von zusätzlichen Informationen am Ende dieses Pfads. Die zusätzlichen Informationen werden als PATH_INFO gesendet.

PATH_TRANSLATED

Der Server stellt eine übersetzte Version von PATH_INFO zur Verfügung, die den Pfad nimmt und jede virtuelle-zu-physische Zuordnung darauf anwendet.

SCRIPT_NAME

Ein virtueller Pfad zum ausgeführten Skript; wird für selbstreferenzierende URLs verwendet.

QUERY_STRING

Die Abfrage-Informationen, die dem Fragezeichen (?) folgen folgen.

REMOTE_HOST

Name des Hosts, der die Anforderung durchführt. Wenn der Server diese Information nicht hat, setzt er REMOTE_ADDR und setzt REMOTE_HOST nicht.

REMOTE_ADDR

Die IP-Adresse des entfernten Hosts, der die Anfrage stellt.

AUTH_TYPE

Wenn der Server Benutzer-Authentifizierung unterstützt und das Skript geschützt ist, ist dies die protokollspezifische Authentifizierungs- methode, die zur Validierung des Benutzers verwendet wird.

REMOTE_USER AUTH_USER

Wenn der Server Benutzer-Authentifizierung unterstützt und das Skript geschützt ist, ist dies der Benutzername, unter dem sie sich authentifiziert haben.(Auch als AUTH_USER verfügbar.)

REMOTE_IDENT

Wenn der HTTP-Server RFC 931-Identifikation unterstützt, wird diese Variable auf den entfernten Benutzernamen gesetzt, der vom Server abgerufen wurde. Verwenden Sie diese Variable nur zur Protokollzwecken.

CONTENT_TYPE

Für Abfragen mit angehängten Informationen, wie HTTP POST und PUT, ist dies der Content-Typ der Daten.

CONTENT_LENGTH

Die Länge des Inhalts, wie sie vom Client angegeben wurde.

Die folgende Tabelle führt die häufigsten CGI-Variablen auf, die vom Browser erstellt und an den Server übertragen werden:

Variable

Beschreibung

HTTP_REFERER

Das verweisende Dokument. Das ist das Dokument, das verknüpft ist oder Formulardaten gesendet hat.

HTTP_USER_AGENT

Der Browser, den der Client derzeit verwendet, um die Anfrage zu senden. Format: Software/Version Bibliothek/Version.

HTTP_IF_MODIFIED_SINCE

Zeitpunkt der letzten Änderung der Seite. Diese Variable wird nach Ermessen des Browsers gesendet, normalerweise als Reaktion darauf, dass der Server den LAST_MODIFIED HTTP-Header gesendet hat. Sie kann verwendet werden, um browserseitiges Caching zu nutzen.

Inhaltsquellen zwischenspeichern

Du kannst Quellen dynamischer Inhalte in einer Design-Notiz cachen – oder speichern. So kannst du an einer Website arbeiten, auch wenn du keinen Zugriff auf die Datenbank oder den Anwendungsserver hast, die die Quellen dynamischer Inhalte speichern. Caching kann auch die Entwicklung beschleunigen, indem wiederholte Zugriffe über ein Netzwerk auf die Datenbank und den Anwendungsserver vermieden werden.

Klicke auf den Pfeilbutton in der oberen rechten Ecke des Bindungen-Bedienfelds und schalte Cache im Popup-Menü um.

Wenn du Änderungen an einer der Inhaltsquellen vornimmst, kannst du den Cache aktualisieren, indem du auf den Aktualisieren-Button (das Kreispfeil-Symbol) in der oberen rechten Ecke des Bindungen-Bedienfelds klickst. (Erweitere das Bedienfeld, wenn du den Button nicht siehst.)

Inhaltsquellen bearbeiten oder löschen

Du kannst jede vorhandene Quelle dynamischer Inhalte ändern oder löschen – das heißt, jede Inhaltsquelle, die im Bindungen-Bedienfeld aufgeführt ist.

Das Ändern oder Löschen einer Inhaltsquelle im Bindungen-Bedienfeld ändert oder löscht keine Instanz dieses Inhalts auf der Seite. Es ändert oder löscht sie lediglich als mögliche Inhaltsquelle für die Seite.

Ändere eine Inhaltsquelle im Bindungen-Bedienfeld

Doppelklicke im Bindungen-Bedienfeld (Fenster > Bindungen) auf den Namen der Inhaltsquelle, die du bearbeiten möchtest.
Nehmen Sie die gewünschten Änderungen im angezeigten Dialogfeld vor.
Wenn Sie mit dem Ergebnis zufrieden sind, klicken Sie auf „OK“.

Lösche eine Inhaltsquelle aus dem Bindungen-Bedienfeld

Wähle im Bindungen-Bedienfeld (Fenster > Bindungen) die Inhaltsquelle aus der Liste aus.
Klicken Sie auf die Schaltfläche mit dem Minuszeichen (–).

Kopiere ein Recordset von einer Seite zu einer anderen Seite

Du kannst ein Recordset von einer Seite zu einer anderen innerhalb einer definierten Website kopieren.

Wähle das Recordset entweder im Bindungen-Bedienfeld oder im Server-Verhalten-Bedienfeld aus.
Klicke mit der rechten Maustaste auf das Recordset und wähle Kopieren aus dem Popup-Menü.
Öffnen Sie die Seite, auf die Sie die Datensatzgruppe kopieren möchten.
Klicke mit der rechten Maustaste auf das Bindungen-Bedienfeld oder die Server-Verhalten-Symbolleiste und wähle Einfügen aus dem Popup-Menü.