Öffne eine ColdFusion-Seite in Dreamweaver.
Zuletzt aktualisiert am
25. April 2024
Anmerkung
Die Unterstützung für ColdFusion wurde aus Dreamweaver und späteren Versionen entfernt.
ColdFusion-Komponenten
ColdFusion-Komponenten-Dateien (CFC) ermöglichen es dir, Anwendungs- und Geschäftslogik in eigenständige, wiederverwendbare Einheiten zu kapseln.CFCs bieten außerdem eine schnelle und einfache Möglichkeit, Webservices zu erstellen.
Eine CFC ist eine wiederverwendbare Software-Einheit, die in ColdFusion Markup Language (CFML) geschrieben wurde, wodurch es einfach wird, deinen Code wiederzuverwenden und zu warten.
Sie können CFCs in Dreamweaver bearbeiten. Informationen zu CFC-Tags und Syntax findest du in der ColdFusion-Dokumentation in Dreamweaver (Hilfe > ColdFusion verwenden).
Anmerkung
CFCs können nur mit ColdFusion MX oder späteren Versionen eingesetzt werden. CFCs werden in ColdFusion 5 nicht unterstützt.
CFCs sollen eine einfache aber dennoch mächtige Möglichkeit für Entwickler bieten, Elemente ihrer Websites zu kapseln.Grundsätzlich solltest du Komponenten für Anwendungs- oder Geschäftslogik verwenden.Verwende benutzerdefinierte Tags für Präsentationselemente wie personalisierte Begrüßungen, dynamische Menüs und so weiter.
Wie bei vielen anderen Arten der Konstruktion können dynamische Sites oft von austauschbaren Teilen profitieren.Beispielsweise führt eine dynamische Website möglicherweise wiederholt dieselbe Abfrage aus oder berechnet den Gesamtpreis von Warenkorbseiten und berechnet ihn jedes Mal neu, wenn ein Artikel hinzugefügt wird.Diese Aufgaben können von Komponenten bewältigt werden. Du kannst eine Komponente reparieren, verbessern, erweitern und sogar ersetzen mit minimalen Auswirkungen auf den Rest deiner Anwendung.
Angenommen, ein Onlinestore berechnet Versandkosten basierend auf dem Preis der Bestellungen.Für Bestellungen unter 20 $ beträgt die Versandgebühr 4 $; für Bestellungen zwischen 20 $ und 40 $ beträgt die Versandgebühr 6 $ und so weiter.Du könntest die Logik für die Berechnung der Versandgebühren sowohl auf der Warenkorb-Seite als auch auf der Checkout-Seite einfügen, aber das würde HTML-Präsentationscode und CFML-Logikcode vermischen und den Code generell schwer wartbar und wiederverwendbar machen.
Du entscheidest dich, eine CFC namens Pricing zu erstellen, die unter anderem eine Funktion namens ShippingCharge hat.Die Funktion nimmt einen Preis als Argument und gibt eine Versandgebühr zurück.Wenn beispielsweise der Wert des Arguments 32,80 ist, gibt die Funktion 6 zurück.
Sowohl auf der Warenkorb-Seite als auch auf der Checkout-Seite fügst du einen speziellen Tag ein, um die ShippingCharge-Funktion aufzurufen.Wenn die Seite angefordert wird, wird die Funktion aufgerufen und eine Versandgebühr an die Seite zurückgegeben.
Später kündigt der Store eine besondere Promotion an: kostenloser Versand für alle Bestellungen über 100 $.Du machst die Änderung an den Versandtarifen an einem Ort – der ShippingCharge-Funktion der Pricing-Komponente – und alle Seiten, die die Funktion verwenden, erhalten automatisch korrekte Versandgebühren.
Überblick über das Bedienfeld „CF-Komponenten“ (ColdFusion)
Verwende das Komponenten-Bedienfeld (Fenster > Komponenten), um ColdFusion-Komponenten anzuzeigen und zu bearbeiten, und füge Code auf der Seite hinzu, der die Funktion aufruft, wenn die CFM-Seite angefordert wird.
Anmerkung
Das Bedienfeld Komponenten ist nur verfügbar, wenn du eine ColdFusion-Seite in Dreamweaver anzeigst.
CFCs in Dreamweaver erstellen oder löschen
Mit Dreamweaver können Sie CFCs und die zugehörigen Funktionen interaktiv definieren. Dreamweaver erstellt eine .cfc-Datei und fügt die erforderlichen CFML-Tags für dich ein.
Anmerkung
Je nach Komponente muss ein Teil des Codes möglicherweise manuell fertig gestellt werden.
Wähle im Bedienfeld Komponenten (Fenster > Komponenten) CF Components aus dem Popup-Menü aus.
Klicke auf den Plus-Button (+), fülle das Dialogfeld Komponenten erstellen aus und klicke auf OK.
a) Geben Sie im Bereich „Komponente“ Details zu der Komponente ein. Es folgt eine unvollständige Liste der verfügbaren Optionen:
Name legt den Dateinamen der Komponente fest. Der String darf nur alphanumerische Zeichen und Unterstriche (_) enthalten. Lassen Sie bei der Eingabe des Namens die Dateierweiterung .cfc weg.
Komponentenverzeichnis gibt an, wo die Komponente gespeichert wird. Wählen Sie den Stammordner der Webanwendung aus (wie z. B. „\Inetpub\wwwroot\meineAnwendung\“) oder einen seiner Unterordner.
b.Um eine oder mehrere Funktionen für die Komponente zu definieren, wähle Funktionen aus der Bereichsliste aus, klicke auf den Plus-Button (+) und gib die Details der neuen Funktion ein.
Im Feld „Rückgabetyp“ müssen Sie den Typ des Werts angeben, der von der Funktion zurückgegeben wird.
Anmerkung
Wenn Sie im Menü „Zugriff“ die Option „remote“ auswählen, steht die Funktion als Webdienst zur Verfügung.
c.Um ein oder mehrere Argumente für eine Funktion zu definieren, wähle Argumente aus der Bereichsliste aus, wähle die Funktion aus dem Popup- Menü aus, klicke auf den Plus-Button (+) und gib die Details des neuen Arguments auf der rechten Seite ein.
Wenn du einen Remote-Entwicklungsserver verwendest, lade die CFC-Datei und alle abhängigen Dateien (wie die zur Implementierung einer Funktion verwendeten oder Include-Dateien) auf den Remote-Server hoch.
Das Hochladen der Dateien stellt sicher, dass Dreamweaver-Funktionen wie Live-Ansicht und Vorschau im Browser ordnungsgemäß funktionieren.
Dreamweaver schreibt eine CFC-Datei und speichert sie in dem von dir angegebenen Ordner. Die neue Komponente erscheint auch im Bedienfeld Komponenten (nach Klicken auf Aktualisieren).
Wenn du einen Remote-Entwicklungsserver verwendest, lade die CFC-Datei und alle abhängigen Dateien (wie die zur Implementierung einer Funktion verwendeten oder Include-Dateien) auf den Remote-Server hoch.
CFCs in Dreamweaver anzeigen
In Dreamweaver können Sie die im Site-Ordner oder auf dem Server definierten ColdFusion-Komponenten (CFCs) interaktiv überprüfen. Dreamweaver liest die CFC-Dateien und zeigt Informationen über sie in einer einfach zu navigierenden Baumansicht im Bedienfeld Komponenten an.
Dreamweaver sucht nach den Komponenten auf deinem Test-Server (siehe Verbindung zur Datenbank in Dreamweaver). Wenn Sie CFCs erstellen oder vorhandene CFCs ändern, müssen Sie die CFC-Dateien zum Textserver hochladen, damit sie im Bedienfeld „Komponenten“ richtig angezeigt werden.
Um Komponenten auf einem anderen Server anzuzeigen, ändern Sie die Einstellungen für den Testserver.
Über die CF-Komponenten können Sie folgende Informationen anzeigen:
Alle auf dem Server definierten ColdFusion-Komponenten auflisten.
Wenn Sie ColdFusion MX 7 oder eine spätere Version ausführen, können Sie die Liste filtern, damit nur die CFCs im Site-Ordner angezeigt werden.
Die Funktionen und Argumente der einzelnen Komponenten untersuchen.
Die Eigenschaften der Funktionen überprüfen, die Webdienste zur Verfügung stellen.
Anmerkung
Um CFCs im Stammordner des Servers mithilfe von Dreamweaver zu überprüfen, während Sie gleichzeitig Ihre Site-Dateien im Stammordner einer anderen Website verwalten, können Sie zwei Dreamweaver-Sites definieren. Richten Sie die erste Site so ein, dass Sie auf den Stammordner des Servers verweist, und die zweite so, dass Sie auf den Stammordner der Website verweist. Mithilfe des Popupmenüs im Bedienfeld „Dateien“ können Sie schnell zwischen den beiden Sites wechseln.
Um CFCs in Dreamweaver anzuzeigen, führen Sie die folgenden Schritte aus:
Öffnen Sie eine ColdFusion-Seite in Dreamweaver CC.
Wähle im Bedienfeld Komponenten (Fenster > Komponenten)
CF-Komponenten aus dem Popup-Menü aus.
Klicke auf den Button Aktualisieren im Bedienfeld, um die
Komponenten abzurufen.
Das Komponentenpaket wird auf dem Server angezeigt. Ein Komponentenpaket ist ein Ordner, der CFC-Dateien enthält.
Falls vorhandene Komponenten-Pakete nicht angezeigt werden, klicke auf den Button Aktualisieren in der Symbolleiste des Bedienfelds.
Um nur die CFCs anzuzeigen, die sich in deinem Bereichsordner befinden,\nklicke auf den Button „Nur CFCs der aktuellen Website anzeigen" in der\nSymbolleiste des Bedienfelds „Komponenten".
Anmerkung
Diese Funktion ist nur verfügbar, wenn du einen Computer mit ColdFusion MX 6 oder höher als Test-Server für Dreamweaver definiert hast.
Anmerkung
Wenn der aktuelle Bereich in einem virtuellen Ordner auf dem Remote-Server aufgelistet ist, funktioniert die Filterung nicht.
Klicke auf den Plus-Button (+) neben dem Paketnamen, um die im Paket gespeicherten Komponenten anzuzeigen.
Um die Funktionen einer Komponente aufzulisten, klicke auf den Plus-Button (+) neben dem Komponentennamen.
Um die Argumente zu sehen, die eine Funktion verwendet, sowie den Typ der Argumente und ob sie erforderlich oder optional sind, öffne den Zweig der Funktion in der Baumansicht.
Funktionen, die keine Argumente verwenden, haben keinen Plus-Button (+) neben sich.
Um die Details eines Arguments, einer Funktion, einer Komponente oder eines Pakets schnell anzuzeigen, wähle das Element in der Baumansicht aus und klicke auf den Button Details abrufen in der Symbolleiste des Bedienfelds.
Du kannst auch mit der rechten Maustaste (Windows) oder bei gedrückter Strg-Taste (Macintosh) auf das Element klicken und aus dem Kontextmenü Details abrufen auswählen.
Details über das Element werden in einem Meldungsfeld angezeigt.
CFCs in Dreamweaver bearbeiten
Dreamweaver bietet einen optimierten Weg zur Bearbeitung des Codes der ColdFusion-Komponenten, die für deinen Bereich definiert sind. Du kannst zum Beispiel beliebige Komponentenfunktionen hinzufügen, ändern oder löschen, ohne Dreamweaver zu verlassen.
Um diese Funktion zu verwenden, muss deine Entwicklungsumgebung wie folgt eingerichtet sein:
ColdFusion muss lokal ausgeführt werden.
Im erweiterten Dialogfeld Bereichsdefinition in Dreamweaver muss der Zugriffstyp, der in der Kategorie Testserver angegeben ist, Lokal/Netzwerk sein.
Im erweiterten Dialogfeld Bereichsdefinition muss der Pfad deines lokalen Stammordners derselbe sein wie der Pfad des Testserver- Ordners (zum Beispiel c:\Inetpub\wwwroot\cf_projects\myNewApp\). Du kannst diese Pfade überprüfen und ändern, indem du Site > Sites bearbeiten auswählst.
Die Komponente muss im lokalen Bereichsordner oder einem seiner Unterordner auf deiner Festplatte gespeichert werden.
Öffne eine beliebige ColdFusion-Seite in Dreamweaver und zeige die Komponenten im Bedienfeld Komponenten an. Um die Komponenten anzuzeigen, öffne das Bedienfeld Komponenten (Fenster > Komponenten), wähle CF-Komponenten aus dem Popup-Menü des Bedienfelds aus und klicke im Bedienfeld auf die Schaltfläche Aktualisieren.
Da ColdFusion lokal läuft, zeigt Dreamweaver Komponentenpakete auf deiner Festplatte an.
Um eine Komponente zu bearbeiten, führen Sie die folgenden Schritte aus:
Öffne eine beliebige ColdFusion-Seite in Dreamweaver und zeige die Komponenten im
Komponenten-Bedienfeld an (Fenster > Komponenten).
Wähle CF-Komponenten aus dem Pop-up-Menü des Bedienfelds aus und
klicke auf den Aktualisieren-Button im Bedienfeld.
Da ColdFusion lokal läuft, zeigt Dreamweaver Komponentenpakete auf deiner Festplatte an.
Anmerkung
Um das CFC-Recordset visuell zu bearbeiten, doppelklicke darauf im Bindungen-Bedienfeld.
Um eine Komponentendatei allgemein zu bearbeiten, öffne das Paket
und doppelklicke auf den Komponentennamen in der Baumansicht.
Die Komponentendatei wird in der Codeansicht geöffnet.
Um eine bestimmte Funktion, ein Argument oder eine Eigenschaft zu bearbeiten, doppelklicke
auf das Element in der Baumansicht.
Nehmen Sie die Änderungen in der Codeansicht manuell vor.
Speichern Sie die Datei („Datei“ > „Speichern“).
Um neue Funktionen im Komponenten-Bedienfeld zu sehen, aktualisiere
die Ansicht, indem du auf den Aktualisieren-Button in der Symbolleiste des Bedienfelds klickst.
Webseiten erstellen, die CFCs verwenden
Sie können eine Komponentenfunktion beispielsweise in Ihren Webseiten verwenden, indem Sie Code in die Seite schreiben, der die Funktion aufruft, wenn die Seite angefordert wird. Du kannst Dreamweaver verwenden, um dir beim Schreiben dieses Codes zu helfen.
Anmerkung
Für andere Möglichkeiten der Komponentenverwendung siehe die ColdFusion-Dokumentation in Dreamweaver (Hilfe > ColdFusion verwenden).
Öffne in Dreamweaver die
ColdFusion-Seite, die die Komponentenfunktion verwenden wird.
Wechseln Sie zur Codeansicht („Ansicht“ > „Code“).
Öffne das Komponenten-Bedienfeld (Fenster > Komponenten)
und wähle CF-Komponenten aus dem Pop-up-Menü des Bedienfelds aus.
Finde die gewünschte Komponente und füge sie mit einer der
folgenden Techniken ein:
Ziehe eine Funktion aus der Baumansicht auf die Seite. Code zum Aufrufen der Funktion wird in die Seite eingefügt.
Wähle die Funktion im Bedienfeld aus und klicke auf den Button Einfügen in der Symbolleiste des Bedienfelds (der zweite Button von rechts). Dreamweaver fügt den Code an der Einfügestelle in die Seite ein.
Wenn du eine Funktion einfügst, die Argumente hat, vervollständige
den Argumentcode von Hand.
Weitere Informationen findest du in der ColdFusion-Dokumentation in Dreamweaver (Hilfe > ColdFusion verwenden).
Speichere
die Seite (Datei > Speichern).
Datensatzgruppen in CFCs definieren
Dreamweaver unterstützt Sie beim Definieren einer Datensatzgruppe (auch als ColdFusion-Abfrage bezeichnet) in einer ColdFusion-Komponente (CFC). Wenn Sie eine Datensatzgruppe in einer CFC definieren, müssen Sie die Datensatzgruppe nicht auf jeder Seite definieren, auf der sie benötigt wird. Sie definieren die Datensatzgruppe einmal in der CFC und nutzen die CFC dann auf verschiedenen Seiten.
Anmerkung
Diese Funktion ist nur verfügbar, wenn Sie Zugriff auf einen Computer besitzen, auf dem ColdFusion MX 7 oder eine spätere Version ausgeführt wird. Weitere Informationen finden Sie unter ColdFusion-Erweiterungen aktivieren.
Erstellen oder öffnen Sie in Dreamweaver eine CFC-Datei.
Klicke im Bedienfeld Bindungen (Fenster > Bindungen) auf
den Plus-Button (+) und wähle Recordset (Abfrage) aus dem
Popup-Menü.
Das Dialogfeld „Datensatzgruppe“ wird angezeigt. Du kannst entweder in den einfachen oder erweiterten Recordset-Dialogfeldern arbeiten.
Um eine vorhandene Funktion im CFC zu verwenden, wähle die Funktion
aus dem Popup-Menü Funktion aus und springe zu Schritt 5.
Die Datensatzgruppe wird in der Funktion definiert.
Um eine neue Funktion im CFC zu definieren, klicke auf den Button Neue Funktion,
gib einen Namen für die Funktion in das angezeigte Dialogfeld ein
und klicke dann auf OK.
Der Name darf nur alphanumerische Zeichen und Unterstriche (_) enthalten.
Um ein Recordset für die Funktion zu definieren, fülle die
Optionen des Recordset-Dialogfelds aus.
Die neue Funktion wird in das CFC eingefügt, das das Recordset definiert.
Verwende ein CFC-Recordset als Quelle für dynamische Inhalte
Sie können eine ColdFusion-Komponente (CFC) als Quelle dynamischer Inhalte für Ihre Seiten verwenden, wenn die Komponente eine Funktion enthält, die eine Datensatzgruppe definiert.
Anmerkung
Diese Funktion ist nur verfügbar, wenn Sie Zugriff auf einen Computer besitzen, auf dem ColdFusion MX 7 oder eine spätere Version ausgeführt wird. Weitere Informationen finden Sie unter „ColdFusion-Erweiterungen aktivieren“.
Öffnen Sie in Dreamweaver eine ColdFusion-Seite.
Klicke im Bedienfeld Bindungen (Fenster > Bindungen) auf
den Plus-Button (+) und wähle Recordset (Abfrage) aus dem
Popup-Menü.
Das Dialogfeld „Datensatzgruppe“ wird angezeigt. Du kannst entweder im einfachen oder erweiterten Recordset-Dialogfeld arbeiten.
Klicken Sie auf die Schaltfläche „CFC-Abfrage“.
Fülle das CFC-Abfrage-Dialogfeld aus, klicke auf OK und dann
nochmals auf OK, um das CFC-Recordset zur Liste der verfügbaren
Inhaltsquellen im Bedienfeld Bindungen hinzuzufügen.
Verwende das Bedienfeld Bindungen, um das Recordset an verschiedene
Seitenelemente zu binden.
Weitere Informationen findest du unter Dynamische Inhalte zu Seiten hinzufügen.
Definiere dynamische Inhalte mithilfe eines CFC
Du kannst ein Recordset als Quelle für dynamische Inhalte in Dreamweaver definieren, indem du ein CFC verwendest, das eine Recordset-Definition enthält.
1.Gib im Feld Name einen Namen für das CFC-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: rsPressRelease.
Datensatzgruppennamen dürfen nur alphanumerische Zeichen und Unterstriche (_) enthalten. Sonderzeichen und Leerzeichen sind nicht zulässig.
2.Wähle ein Package aus den bereits auf dem Server definierten aus.
Wenn das Paket nicht im Popupmenü angezeigt wird, können Sie die Liste der Pakete aktualisieren, indem Sie auf die Schaltfläche „Aktualisieren“ neben dem Popupmenü klicken.
Stellen Sie sicher, dass Sie die CFCs zunächst zum Testserver hochladen. Es werden nur CFCs auf dem Testserver angezeigt.
3.Wähle eine Komponente aus den im aktuell ausgewählten Package definierten aus.
Wenn das Popupmenü „Komponenten“ keine oder keine der zuvor erstellten Komponenten enthält, müssen Sie die CFC-Dateien zum Testserver hochladen.
4.(Optional) Um eine Komponente zu erstellen, klicke auf den Button „Neue Komponente erstellen".
a) Geben Sie im Feld „Name“ einen Namen für die neue CF-Komponente ein. Der String darf nur alphanumerische Zeichen und Unterstriche (_) enthalten.
b.Gib im Feld Komponentenverzeichnis den Speicherort für deine CFC ein oder durchsuche die Ordner, um den Ordner zu finden.
Anmerkung
Der Ordner muss relativ zum Stammordner der Site angegeben werden.
5.Wähle aus dem Popup-Menü Funktion die Funktion aus, die die Recordset-Definition enthält.
Das Popupmenü „Funktionen“ enthält nur die Funktionen, die in der aktuell ausgewählten Komponente definiert sind. Wenn in diesem Popupmenü keine Funktion angezeigt wird oder Ihre letzten Änderungen in der Liste nicht berücksichtigt werden, überprüfen Sie, ob die betreffenden Änderungen gespeichert und zum Server hochgeladen wurden.
Anmerkung
Die Textfelder „Verbindung“ und „SQL“ sind schreibgeschützt.
6.Bearbeite jeden Parameter (Typ, Wert und Standardwert), der als Funktionsargument übergeben werden muss, indem du auf den Button Bearbeiten klickst.
a) Geben Sie einen Wert für den aktuellen Parameter ein, indem Sie den Wertetyp im Popupmenü „Wert“ auswählen und den Wert in das Feld auf der rechten Seite eingeben. Der Wertetyp kann ein URL-Parameter, eine Formularvariable, ein Cookie, eine Sitzungsvariable, eine Anwendungsvariable oder ein eingegebener Wert sein.
b) Geben Sie im Feld „Standardwert“ einen Standardwert für den Parameter ein. Wenn kein Laufzeitwert zurückgegeben wird, wird der Standardparameterwert verwendet.
c.Klicke auf OK.
Sie können die Datenbankverbindung und die SQL-Abfrage für die Datensatzgruppe nicht ändern. Diese Felder sind immer deaktiviert: Verbindung und SQL-Abfrage werden nur zu Informationszwecken angezeigt.
7.Klicke auf Test, um eine Verbindung zur Datenbank herzustellen und eine Instanz des Recordsets zu erstellen.
Wenn die SQL-Anweisung Seitenparameter enthält, muss die Spalte „Standardwert“ des Felds „Parameter“ gültige Testwerte enthalten, bevor Sie auf „Testen“ klicken.
Wenn die Abfrage erfolgreich ausgeführt wurde, wird eine Tabelle mit der Datensatzgruppe angezeigt. Jede Zeile enthält einen Datensatz und jede Spalte entspricht einem Feld in diesem Datensatz.
Klicken Sie auf „OK“, um die CFC-Abfrage zu löschen.
8.Klicke auf Ok.
Erstellen ansprechender Websites in Dreamweaver
Entwirf, code und verwalte dynamische Websites mit einem leistungsstarken All-in-one-Tool.
