ColdFusion in 21 Tagen. Der einfache Einstieg ins Web-Publishing. Mit CD-R-ROM 3827260175, 978-3-8272-6017-8 [PDF]

227

Variablen und If-Then-Anweisungen

8: 9: Richtig

10: Falsch

11: 12:

Beachten Sie, dass die Links true und false in den Zeilen 9 und 10 beide auf dieselbe Template-Seite verweisen, answer.cfm. In den Links habe ich außerdem die Variable reply definiert und für den Link Richtig auf True, für den Link Falsch auf False gesetzt.

Abbildung 9.1: Meine Beispielseite mit einer Frage.

Der Gedanke dahinter ist, dass ich, statt zwei Seiten anzulegen, die die beiden Antworten verarbeiten, ein einziges ColdFusion-Template nutze und darauf ein if-then-Konstrukt anlege, das beide Antworten abdeckt. Den Code für meine Antwortseite sehen Sie in Listing 9.2. Listing 9.2: answer.cfm 1: 2: 3: 4: 5: 6: 7: 8: 9:

228

Ihre Antwort war: #reply#

Das -Tag

10: 11: Oiiiiii....nein, Sie sollten vielleicht Ihre ➥Benutzerhandbücher noch einmal lesen. 12: 13: 14: 15: 16: 17: Richtig! Sie haben Ihre Hausaufgaben gemacht und werden ➥Ihre Elektronikerlizenz in etwa ➥4 bis 6 Wochen erhalten! 18: 19: 20: 21:

Diese Template-Seite macht drei Dinge. Erstens verwendet sie in Zeile 3 ein Tag vor der -Zeile, so dass ich den Wert der von der Frage-Seite übergebenen Variablen anzeigen kann. Zweitens verwendet sie in Zeile 9 mit einer qualifizierenden Anweisung, die feststellt, ob die Variable reply gleich true ist. In diesem Fall zeigt das Template den Text zwischen dem ersten -Tag in Zeile 9 und dem nächsten in Zeile 13 an. Falls die Anweisung keine Übereinstimmung feststellt, ignoriert sie den ersten Text und geht zum zweiten -Tag in Zeile 15. Ist die Variable reply gleich false, zeigt das Template den Text zwischen den -Tags in den Zeilen 15 und 19 an. Beachten Sie, dass ich in den IF-Anweisungen in den Zeilen 9 und 15 keine Doppelkreuze um die Variable reply angegeben habe. erkennt reply automatisch als Variable und handelt entsprechend. Beachten Sie auch, dass ich die Variablenwerte in einfache Anführungszeichen eingeschlossen habe, um zu kennzeichnen, dass der Text als solcher interpretiert werden soll. Wenn Sie schreiben, nimmt ColdFusion automatisch an, dass Sie dahinter einen Vergleich mit einer Variablen oder eine bedingte Anweisung verwenden wollen. Die Ergebnisse dieses Template sehen Sie in den Abbildungen 9.2 und 9.3.

229

Variablen und If-Then-Anweisungen

Abbildung 9.2: Die TemplateSeite answer.cfm für reply gleich false.

Abbildung 9.3: Die TemplateSeite answer.cfm für reply gleich true.

Das -Tag Das -Tag wird häufig in Kombination mit einem zweiten Tag verwendet, . Wie der Name schon sagt, wird verwendet, um damit auszudrücken »Falls etwas anderes zutrifft, dann...«. Das -Tag besagte »Wenn dies gilt, dann tu jenes«, und

230

Das -Tag

wenn man ihm ein folgen lässt, heißt das für ColdFusion »Falls es nicht zutraf, mache statt dessen jenes«. Um die Verwendung von zu demonstrieren, habe ich meine Frage-Seite so abgeändert, dass noch eine dritte Alternative angeboten wird, »Ich weiß nicht«, wie in Abbildung 9.4 gezeigt.

Abbildung 9.4: Meine neue und überarbeitete Frage-Seite mit drei möglichen Antworten.

Um die dritte Auswahl anzubieten, habe ich der ursprünglichen Frage-Seite den folgenden Text hinzugefügt: Ich weiß nicht

Dies ist ein weiterer Link, wobei die Variable reply auf dont_know gesetzt wurde. Beachten Sie, dass ich hier den Apostroph (don't) weggelassen habe, weil ColdFusion ihn bei der Übergabe an die Antwort-Seite als einfaches Anführungszeichen interpretieren könnte. Außerdem habe ich das Leerzeichen durch einen Unterstrich ersetzt. ColdFusion bietet einige Werkzeuge, die Zeichen wie Apostrophe verarbeiten können, wenn sie in Variablen auftauchen – einige davon werden später in diesem Kapitel noch vorgestellt. Um Zeit zu sparen, ist es jedoch immer am einfachsten, diese Zeichen wo immer möglich zu vermeiden. Auf meiner neuen Frage-Seite biete ich drei mögliche Ergebnisse für meine Antwort-Seite an, Richtig, Falsch und Ich weiß nicht. Ich könnte dafür drei separate -Anweisungen erzeugen, aber es gibt eine einfachere Methode.

231

Variablen und If-Then-Anweisungen

Der Kern meiner Frage war »Richtig oder Falsch: Man sollte Computer-Hardware nur bedienen, wenn man mit beiden Beinen barfuss in einer Pfütze steht.« Offensichtlich erwarten wir die Antwort Falsch, aber wenn jemand auf Richtig oder Ich weiß nicht klickt, ist das ein Alarmzeichen. Ich kann für die Antworten True und Ich weiß nicht dieselbe Reaktion verwenden, weil dieser Benutzer sich und andere gefährdet und dringend Hilfe braucht. Ich verwende , um damit auszudrücken »Falls irgendeine andere Antwort als Falsch gegeben wird, dann mach jenes«. Listing 9.3 zeigt, wie das in meinem Template answer.cfm realisiert ist. Listing 9.3: Der abgeänderte Ausgabeabschnitt von answer.cfm 1: 2: 3: 4: 5: Ihre Antwort war: #reply# 6: 7: 8: 9: 10: 11: Sie haben recht. Sie haben Ihre Hausaufgaben gemacht ➥und werden Ihre Elektronikerlizenz in ➥etwa 4 bis 6 Wochen erhalten. 12: 13: 14: 15: Verlassen Sie sofort Ihren Computer. ➥Ihre Antwort hat gezeigt, dass Sie nur unter Aufsicht Erwachsener ➥mit elektronischen Geräten arbeiten sollten. 16: 17: 18: 19:

ist Teil eines -Konstrukt, d.h. es erscheint immer zwischen den Tags und und kann nicht eigenständig verwendet werden.

Der Code in Listing 9.3 vergleicht den Wert der Variablen reply mit dem Wert false. Falls der Vergleich true ergibt, gibt sie den Text weiter, der vor dem -Tag steht.

232

Eine Applikation mit erstellen

Enthält die Antwort etwas anderes als das Wort false, gibt das Template statt dessen die zweite Zeichenkette weiter. Auf diese Weise habe ich drei mögliche Antworten mit einer -Anweisung abgedeckt.

9.3

Eine Applikation mit erstellen

Kommen wir zurück zu unserem Projekt für Gargantuan. Gargantuan will, dass die technischen Angestellten für jeden Eintrag ein Kennwort angeben. Und hier erkennen Sie vielleicht schon, wie praktisch sein kann. Sie denken, am besten wird der Kennwortschutz im Kapitel 7 erstellten Eingabe-Template untergebracht. Wenn der Angestellte jetzt Details zu einem verrückten Support-Anruf eingeben will, muss er auch das Kennwort für seinen Benutzernamen eingeben. Wird das Formular übergeben, wertet ColdFusion das Kennwort aus. Ist der Vergleich erfolgreich, wird die vom Benutzer vorgegebene Beschreibung des Anrufs in die Datenbank eingetragen. Andernfalls gibt ColdFusion eine Fehlermeldung zurück. Als erstes müssen Sie der Datenbank Kennwörter hinzufügen. Aus Kapitel 6 wissen Sie, dass die Namen aller Angestellten in der Tabelle techs der Datenbank von Gargantuan abgelegt sind. Falls Sie eine Kopie einer Datenbank auf Ihrem lokalen Server verwalten, achten Sie immer darauf, die existierende Datenbank des Kunden nicht mit einer älteren Version zu überschreiben. Öffnen Sie die Tabelle und fügen Sie das neue Feld ein, password, wie in Abbildung 9.5 gezeigt.

Abbildung 9.5: Die abgeänderte Tabelle techs in der Datenbank calls.mdb.

Für Testzwecke habe ich jedem Angestelltennamen ein Kennwort zugeordnet. Dazu habe ich einfach die Namen rückwärts geschrieben – kein erhöhtes Sicherheitsniveau, aber die Leute bei Gargantuan können sie später immer noch ändern.

233

Variablen und If-Then-Anweisungen

9.4

Die Seite für die Kennwortprüfung

Um die Kennwort-Seite zu erstellen, öffnen Sie zunächst das Eingabeformular, das Sie in Kapitel 7 angelegt haben, und nehmen ein paar Ergänzungen vor, um das Feld für die Eingabe des Kennworts anzulegen. Meine abgeänderte Seite sieht aus wie in Listing 9.4 gezeigt. Falls Sie die Einführung in ColdFusion Studio in Kapitel 8 gelesen haben, verwenden Sie Studio, um die Übungen in diesem Kapitel nachzuvollziehen. Andernfalls können Sie auch einen Standard-Texteditor verwenden. Listing 9.4: Die abgeänderte tech_calls.cfm 1: 8: 21:

SELECT password FROM techs WHERE tech_name = '#tech_who_took_call#'

2: 3: 4: SELECT password FROM techs 5: WHERE tech_name = '#tech_who_took_call#' 6: 7: 8: 29: 30: Return to List of Calls
31: 32: 33: 34:

238

Die Einfügeseite

Die -Anweisung in den Zeilen 11 bis 26 vergleicht die vom Benutzer übergebenen Kennwortdaten mit dem von der Abfrage zurückgegebenen Kennwort. Stimmen die beiden nicht überein, erhält der Benutzer die Fehlermeldung in Zeile 13. In allen anderen Fällen () wird der neue Datensatz in die Tabelle calls (Zeilen 17 bis 22) eingetragen und der Benutzer erhält eine Bestätigungsmeldung. Beachten Sie auch, dass ich dem -Tag eine Liste mit Formularfeldern hinzugefügt habe. Das war erforderlich, weil dieses Template jetzt mit einigen neuen Variablen arbeitet, form.password und get_pass.password, die ich nicht mit den anderen Anrufdetails in die Tabelle calls schreiben will. Sie wissen, dass standardmäßig versucht, alle Variablen zum Einfügen an die Datenbank zu senden. In diesem Fall hätte ich dann einen ColdFusion-Fehler erhalten, weil es in der Tabelle calls kein password-Feld gibt. In einem Browser sieht die abgeänderte insert.cfm wie in Abbildung 9.7 gezeigt aus.

Abbildung 9.7: Die Einfüge-Seite für Gargantuan, nachdem eine Kennwortüberprüfung eingeführt wurde.

Wenn ein Benutzer Anrufdaten in das Formular aus Abbildung 9.6 eingibt, sieht er die in Abbildung 9.8 gezeigte Bestätigung, falls er ein richtiges Kennwort eingegeben hat. Erzeugt das Kennwort keine Übereinstimmung, sieht er die in Abbildung 9.9 gezeigte Ausgabe.

239

Variablen und If-Then-Anweisungen

Abbildung 9.8: Wurde das Kennwort korrekt eingegeben, sehen Sie diese Bestätigung und die Daten werden in die Tabelle calls eingetragen.

Abbildung 9.9: Wird ein fehlerhaftes Kennwort eingegeben, erhalten Sie diese Fehlermeldung und es wird nichts in die Datenbank eingetragen.

240

Variablen mit definieren

9.6

Variablen mit definieren

Die zweite Änderung, die Gargantuan bestellt hat, ist ein Eintragszähler, so dass die Angestellten abhängig von der Anzahl der von ihnen protokollierten Anrufe an einem Wettbewerb teilnehmen können. Wenn ein Angestellter neue Informationen in die Datenbank einträgt, erlaubt ihm die Bestätigungsmeldung, den übertragenen Anruf seinem Gesamtzählerstand hinzuzufügen. Nach einer zuvor festgelegten Zeit belohnt Gargantuan den Angestellten mit den meisten erfassten Anrufen. ColdFusion bietet mehrere Methoden, Dinge zu »zählen«, aber für diese Aufgabenstellung wollen wir nur eine davon betrachten – das -Tag. bietet dem Entwickler die Möglichkeit, neue Variablen anzulegen, die nicht in Abfragen oder Formulardaten definiert sind. Mit können Sie beliebige Variablen anlegen, ihnen Werte zuweisen und sie an beliebiger Stelle in Ihrer Template-Datei verwenden. Um beispielsweise eine einfache Textvariable zu erzeugen, die meinen Namen anzeigt, verwende ich das -Tag wie folgt:

In diesem Template kann ich überall innerhalb von -Tags auf meinen Namen zugreifen, indem ich auf die Variable developer verweise. Ich habe beim Anlegen der Variablen keine Doppelkreuze verwendet, aber wenn ich später in einem Dokument auf die Variable verweise, muss ich die Doppelkreuze verwenden. Anders als einige Programmier- und Skriptingsprachen verwendet ColdFusion »typlose« Variablen, d.h. Sie müssen dem Programm nicht mitteilen, ob ein Variablenwert nummerisch, Text, Ja/Nein oder Zeit/Datum ist. Zugegeben, die Umwandlung eines Zwei-Wort-Namens in eine Ein-Wort-Variable wird Ihnen vielleicht nicht besonders viel Zeit sparen, aber lesen Sie weiter, um noch andere Einsatzmöglichkeiten für kennen zu lernen. Variablen, die mit erstellt werden, sind nicht immer dafür vorgesehen, dem Benutzer angezeigt zu werden. Es ist zwar möglich, aber häufig wird im Hintergrund verwendet, um Dinge bei der Seitenausgabe oder der Datenbankänderung zu steuern.

Der Zählmechanismus Um die Applikation für Gargantuan mit Hilfe eines Zählers auszubauen, lege ich mit einen Zählmechanismus an. Über eine Abfrage ermittle ich, wie viele Beiträge

241

Variablen und If-Then-Anweisungen

ein Angestellter produziert hat. Mit lege ich dann eine neue Variable an, deren Wert gleich dem vorherigen Wert plus 1 ist. Die neue Variable reflektiert den aktuellen Zähler für den Angestellten. Als erstes müssen Sie ein Feld in der Datenbank von Gargantuan anlegen, das den aktuellen Zähler für den Angestellten aufnimmt. Weil die Angestellten der Support-Abteilung alle in der Tabelle techs aufgelistet sind, ist das eine ideale Position für den Zähler. In Abbildung 9.10 habe ich der Tabelle techs das neue Feld submissions hinzugefügt und jeweils den Ausgangswert 0 eingetragen.

Abbildung 9.10: Die Tabelle techs in der Datenbank von Gargantuan, die jetzt einen Zähler für die Einträge der einzelnen Techniker beinhaltet.

Jetzt fügen Sie dem existierenden Template insert.cfm Text hinzu. Wenn ein Benutzer eine Bestätigung erhält, dass sein Beitrag in die Datenbank eingefügt wurde, sieht er gleichzeitig eine Schaltfläche oder einen Link, die bzw. der ihm ermöglicht, diesen Anruf zu »zählen« und somit an dem Wettbewerb teilzunehmen. Wenn der Benutzer auf die Schaltfläche klickt, werden sein Benutzername und der neue Zählerwert einer Aktionsseite übergeben, die die Datenbank mit Hilfe des -Tags aktualisiert. Ich dachte, eine Schaltfläche wäre für diesen Zweck ganz praktisch, deshalb habe ich insert.cfm ein kurzes Formular hinzugefügt, wie in Listing 9.7 gezeigt.

Listing 9.7: Bestätigung der Kennwortdaten und Eingabe von Details zu den Anrufen 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11:

242

48:

SELECT * FROM 8tracks ORDER BY artist







SELECT * from 8tracks ORDER BY artist

SELECT * from 8tracks ORDER by artist

4:

9:

10:

11:

Wenn der Benutzer die in Listing 11.1 erzeugte Seite sieht, erhält er eine Ausgabe wie in Abbildung 11.1 gezeigt. Wenn die Benutzer den Befehl QUELLTEXT ANZEIGEN für die Schiebereglerseite ausführen, sehen sie, was im Hintergrund passiert, wie in Listing 11.2 gezeigt. Listing 11.2: Der Quellcode, der im Browser des Benutzers für erscheint 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13:

277

Eingabeseiten mit grundlegenden -Tags

14: 15: Wählen Sie mit Hilfe des Schiebereglers eine Zahl zwischen 1 und 100: 16:

17: 18: 19: Ihr Browser muss Java unterstützen,
damit Sie Cold Fusion Java Applets ➥anzeigen können!
20: 21:

22:

23:

Abbildung 11.1: Wenn ein Benutzer den durch ein -Tag erzeugten Schieberegler bewegt, wird der Eingabewert innerhalb eines zuvor definierten nummerischen Wertebereichs entsprechend angepasst.

Lassen Sie sich von dem JavaScript in Listing 11.2 nicht abschrecken. Sie müssen nicht JavaScript beherrschen, um verwenden zu können, und genau das ist der Punkt – Sie verwenden -Elemente einfach, um eine Seite zu erstellen. ColdFusion erzeugt im Hintergrund das JavaScript, und der Benutzer sieht eine professionell formatierte Formularseite – in der Meinung, Sie hätten alles selbst codiert.

278

in der Praxis

Für Browser, die JavaScript nicht unterstützen oder es deaktiviert haben, erzeugt eine generische Fehlermeldung, die dem Benutzer mitteilt, dass ihm eine bestimmte Funktionalität fehlt, um die Seite anzeigen zu können. Mit Hilfe des NotSUPPORTED-Parameters, der im nächsten Abschnitt beschrieben wird, können Sie diese Nachricht Ihren Anforderungen anpassen. Jetzt betrachten wir die von verarbeiteten Parameter und codieren unter Verwendung dieses Tags und der entsprechenden Werkzeuge ein paar Beispielseiten.

11.2 in der Praxis Wie das HTML-Tag benötigt das ColdFusion-Tag einen »Aktions«-Parameter, um die Aktionsseite für das Formular zu definieren, und einen »Methoden«-Parameter, um festzulegen, wie die gesammelten Daten versendet werden. Um einen Formularabschnitt irgendwo auf einer ColdFusion-Template-Seite zu definieren, verwende ich etwa folgenden Text:

verarbeitet dieselben Parameter wie das -Tag von HTML, auch TARGET für die Verwendung mit Framesets und ENCTYPE, um die Methode festzulegen, wie das Formular codiert wird. Darüber hinaus akzeptiert auch zwei Java-spezifische Parameter, ENABLECAB und ONSUBMIT. Sie sind für die normale Formularverarbeitung nicht notwendig, können aber sehr praktisch für Java-Programmierer sein, die ihren Formularseiten benutzerdefinierte Funktionsmerkmale hinzufügen wollen. Nachdem in einer Template-Seite ein -Abschnitt definiert wurde, kann man die verschiedensten Eingabe- und Anzeigeelemente nutzen. Ich kann Standard-HTML-Formularelemente wie beispielsweise INPUT und TEXTAREA austauschbar oder in Kombination mit den komplexeren Werkzeugen von ColdFusion verwenden. Wir werden diese komplexeren Tags noch genauer betrachten. Zuvor möchte ich Sie jedoch darauf hinweisen, dass es einige gemeinsame Parameter dafür gibt, mit deren Hilfe Sie ihr Aussehen und ihre Arbeitsweise anpassen können – schließlich werden alle begleitenden Tags zu im Hintergrund von JavaScript gesteuert. Tabelle 11.1 beschreibt diese gemeinsamen Parameter. Falls Sie die Bedeutung eines dieser Parameter jetzt noch nicht verstehen, machen Sie sich keine Gedanken. Sie werden die Arbeitsweise verstehen, wenn wir die erweiterten Tags von genauer betrachten.

279

Eingabeseiten mit grundlegenden -Tags

Parameter

Funktion

NAME (zwingend erforderlich)

Für alle -Tags muss ein Name angegeben werden..

NotSUPPORTED

Die Meldung die angezeigt werden soll, wenn der Browser des Benutzers kein Java unterstützt. Falls Sie hier keine Meldung angeben, zeigt ColdFusion standardmäßig eine generische Meldung an.

ONVALIDATE

Der Name einer JavaScript-Funktion zur Auswertung von Benutzereingaben. Falls Sie keine solche Funktion angeben, verwendet ColdFusion seine eigenen Auswertungsmethoden, wenn der VALIDATE-Parameter in einem -Tag angegeben ist.

ONERROR

Eine JavaScript-Funktion, die ausgeführt wird, falls die Auswertung fehlschlägt. Auch dies übernimmt ColdFusion standardmäßig, Sie brauchen also nur diesen Parameter anzugeben, wenn Sie eine allgemeine vorgegebene Funktion nutzen wollen.

ALIGN

Entspricht den Standard-Ausrichtungsfunktionen von HTML, wird aber nur auf das -Element angewendet, für das der Parameter spezifiziert ist.

BOLD

Zeichnet den Text für das entsprechende -Element fett aus.

ITALIC

Zeichnet den Text für das entsprechende -Element kursiv aus.

FONT

Hier können Sie einen beliebigen von JavaScript unterstützten Schriftnamen angeben, um das Erscheinungsbild Ihres -Elements anzupassen.

FONTSIZE

Die Größe der zuvor festgelegten Schriftart.

HEIGHT

Die Höhe des -Elements, angegeben in Pixeln.

HSPACE

Horizontaler Abstand des -Elements.

VSPACE

Vertikaler Abstand des -Elements.

WIDTH

Die Breite des -Elements, angegeben in Pixel.

Tabelle 11.1: Gemeinsame Parameter der -Tags

11.3 Das -Tag ist dem Standard-Formular-Tag von HTML sehr ähnlich. Abhängig von den dafür angegebenen Parametern kann das Tag genutzt werden, um Benutzereingaben in Form von Textfeldern, Optionsfeldern, Kontrollkästchen oder Kennwortfeldern entgegenzunehmen.

280

Das -Tag

Einer der wichtigsten Vorteile von im Vergleich zu seinem HTML-Gegenstück ist, dass es Benutzereingaben auswerten kann – d.h. es kann den von einem Benutzer eingegebenen Text daraufhin überprüfen, ob er einem bestimmten Format entspricht, wie beispielsweise, ob es sich um eine fünfstellige Postleitzahl handelt, oder eine neunstellige Sozialversicherungsnummer. Falls keine Übereinstimmung festgestellt wird, wird der Benutzer angewiesen, seine Eingabe zu wiederholen und noch einmal zu senden. Angenommen, ein Kunde hat mich gebeten, eine einfache Online-Umfrage zu realisieren, was seine Benutzer über Kriminalität denken. Die Seite sollte etwa wie in Abbildung 11.2 gezeigt aussehen. Dieses Formular enthält zwei Fragen. Für die erste Frage habe ich ein Standard-Optionsfeld verwendet. Wenn ein Optionsfeld markiert ist, wird die Markierung aller anderen automatisch aufgehoben, um sicherzustellen, dass der Benutzer nur eine Antwort für die Frage auswählen kann. Optionsfelder können mit Standard-HTML-Code verarbeitet werden, deshalb kann ich hier sowohl als auch zur Realisierung der Frage verwenden. Der erste Teil meines Formulars wurde mit dem Code aus Listing 11.3 erzeugt. Listing 11.3: Optionsfelder erstellen 1: 2: Die Kriminalitätsumfrage 3: 4: 5: Die Kriminalitätsumfrage 6: Wir möchten Sie zu diesem heißen Thema befragen. Beantworten Sie bitte ➥unsere Fragen und klicken Sie auf die Senden-Schaltfläche. 7: 8: 11: 1. Was denken Sie über die Kriminalität in Ihrer Stadt?

12:

13: Ich bin dagegen.
14:

15: Ich bin dafür.
16:

17: Ich habe keine Meinung zu diesem Thema.
18:

19: Ich bin Verbrecher und sollte deshalb nicht an der Umfrage ➥teilnehmen. 20:

281

Eingabeseiten mit grundlegenden -Tags

Abbildung 11.2: Dieses Formular, das mit dem Tag erstellt wurde, sieht aus wie ein StandardHTML-Formular, enthält aber eine Funktion, die die Benutzereingaben auswertet.

Ich habe vier mögliche Antworten für die Frage angeboten und ihnen über den VALUE-Parameter Variablen zugewiesen. Die der Aktionsseite übergebene Variable ist for (Zeile 14), against (Zeile 12), no opinion (Zeile 16) und criminal (Zeile 18). Die zweite Frage auf dem Formular ermöglicht die Verwendung der Auswertungsfunktion von . Der Kunde will sehen, wie die Benutzer in unterschiedlichen Städten auf die Frage antworten, deshalb soll für jede Antwort eine Postleitzahl angegeben werden. Um sicherzustellen, dass der Benutzer wirklich eine fünfstellige Postleitzahl eingegeben hat, erzeuge ich mit Hilfe des Texts in Listing 114. die zweite Frage und schließe das Formular. Listing 11.4: Die zweite Hälfte des Eingabeformulars verwendet VALIDATE, um die Eingabe einer gültigen Postleitzahl zu überprüfen. 1:

SELECT * from 8tracks

Das -Tag

7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35:

Wählen Sie Ihr Lieblingsband aus meinem Auto!

Wählen Sie aus der folgenden Auswahl Ihr Lieblingsband:

#title#



SELECTED="yes"

25: 26:

27: 28:

29: 30:

Diese Methode wertet jede Zeile des Abfrageergebnisses aus, ob es sich um den Titel »Mambo Hits!« handelt. Wenn sie sie findet, fügt die -Anweisung genau dieser OPTION-Anweisung den Text SELECTED="yes" hinzu. Hier handelt es sich um ein relativ einfaches Formular mit nur einem Auswahlfeld, aber Sie sehen bereits, wie komplex Ihr Code werden könnte, wenn Sie mehrere davon auf einer Seite einsetzen. Und hier komm ins Spiel. Es unterstützt eine sehr viel kompaktere Methode, SELECT-Felder mit Abfragedaten zu füllen und bietet sogar noch praktische Möglichkeiten, wie beispielsweise die Auswahl eines bestimmten Datensatzes. Um für den Aufbau der Abstimmseite einzusetzen, mache ich zuerst das HTML--Tag zu . Ich verwende dieselbe Abfrage wie zuvor, aber mein Formularabschnitt sieht aus wie in Listing 11.7 gezeigt. Listing 11.7: Auswahl einer Standardvorgabe mit 1: 2: 3:

4:

5:

6: 7:

stellt eine viel einfachere Möglichkeit dar, das SELECT-Feld zu füllen. Es verwendet die Parameter NAME und VALUE, wie ein normales , beinhaltet aber auch noch einige weitere Funktionsmerkmale, wie in Tabelle 11.4 beschrieben. Parameter

Funktion

NAME (required)

Der Variablenname, der den ausgewählten Daten zugeordnet wird.

SIZE

Die Größe des Auswahlfelds, angegeben in Zeilen.

REQUIRED

Wenn dieser Parameter auf yes gesetzt ist, muss ein Wert ausgewählt werden, damit das Formular verarbeitet wird.

Tabelle 11.4: Parameter für

289

Eingabeseiten mit grundlegenden -Tags

Parameter

Funktion

MESSAGE

Der Text, der erscheint, falls REQUIRED auf yes gesetzt ist und beim Senden nichts ausgewählt war.

ONERROR

Der Name einer JavaScript-Funktion, die ausgeführt wird, wenn die Auswertung fehlschlägt.

MULTIPLE

Erlaubt dem Benutzer, mehrere Werte im Auswahlfeld auszuwählen.

QUERY

Der Name der Abfrage, mit der das Feld gefüllt wird.

SELECTED

Die Werte einer oder mehrere Einträge in VALUE, die als standardmäßig ausgewählt erscheinen.

VALUE

Das Abfragefeld, das der Aktionsseite als Variable übergeben wird.

DISPLAY

Das Abfragefeld, das in dem Auswahlfeld angezeigt wird.

Tabelle 11.4: Parameter für (Forts.)

Betrachten Sie noch einmal den Code in Listing 11.7. In meiner -Anweisung in Zeile 3 habe ich die Parameter NAME und VALUE für mein Auswahlfeld angegeben und mit dem Parameter SELECTED festgelegt, dass ein bestimmter VALUE als ausgewählt erscheinen soll. Sie wissen, dass das ID-Feld in meiner Datenbank der Primärschlüssel und damit für jeden Datensatz eindeutig ist, deshalb ist es für die Auswahl gut geeignet. Wenn ich in meine Datenbank sehe, erkenne ich, dass das Band »Mambo Hits!« die ID 6 hat, deshalb habe ich diesen Wert für SELECTED verwendet. SELECTED muss ein Wert sein, der im VALUE-Parameter angegeben ist. Im obigen

Beispiel habe ich das ID-Feld als Wert verwendet, weshalb ich einen gültigen ID-Wert als SELECTED-Datensatz angeben muss.

11.6 Das -Tag bietet keine besonderen Zeiteinsparungen wie , aber ist ganz praktisch für die Benutzer, um einen nummerischen Wert in einem Formular auszuwählen. Um das zu verdeutlichen, wollen wir annehmen, wir legen ein Formular an, in dem die Benutzer meine Bänder anhand einer Skala von 1 bis 10 beurteilen sollen. Betrachten Sie dazu Abbildung 11.6. Für die Verarbeitung von muss ein Browser unbedingt Java unterstützen. Wenn Sie davon ausgehen können, dass Ihre Benutzer Java nicht unterstützen, sollten Sie statt dessen ein Auswahlfeld verwenden.

290

Das -Tag

Abbildung 11.6:

ermöglicht den Benutzern, eine Zahl auszuwählen, indem sie eine JavaScript-Leiste über einen bestimmten Wertebereich ziehen.

Um diese Seite anzulegen, habe ich in einer einfachen Abfrage alle Bänder aus meiner Datenbank eingelesen und dann ein erzeugt, um die Ergebnisse anzuzeigen und Bewertungen dafür zu ermitteln. Listing 11.8 zeigt den Code. Listing 11.8: rate_tapes.cfm 1: ➥SELECT * from 8tracks ➥ 2: 3: Bewerten Sie meine Bänder 4: 5: Bewerten Sie meine Bänder durch Auswahl einer Zahl zwischen 1 und 10 ➥auf dem folgenden Schieberegler. 10 ist ein interessantes Band, 1 ist ein ➥Türstopper. 6: 7: #artist#: #title#
8: 9:

10:

11:

291

Eingabeseiten mit grundlegenden -Tags

12: 13:

Im -Tag habe ich wieder das ID-Feld als Namen verwendet, weil eindeutige Nummern eine gute Auswahl darstellen. Wenn der Benutzer auf seinem Formular auf die Senden-Schaltfläche klickt, übergibt er eine Folge von ID-Nummern mit Bewertungswerten für jede davon. verarbeitet die in Tabelle 11.5 gezeigten Parameter. Parameter

Funktion

LABEL

Eine Beschriftung, die oberhalb des Schiebereglers erscheint. Wenn Sie möchten, dass der aktuelle Wert des Schiebereglers in der Beschriftung angegeben wird, verwenden Sie die Variable %value% und setzen REFRESHLABLE auf yes.

REFRESHLABEL

Ist dieser Parameter auf yes gesetzt, wird die Beschriftung aktualisiert, während der Benutzer den Schieberegler bedient.

IMG

Eine Bilddatei, die für den Schieberegler verwendet wird.

IMGSTYLE

Legt fest, wie die IMG-Datei angezeigt wird. Mögliche Werte sind tiled, centered und scaled.

RANGE

Die Ober- und Untergrenzen für den Schieberegler, durch ein Komma voneinander getrennt. Beispielsweise erlaubt RANGE="1,10" dem Benutzer, eine Zahl zwischen 1 und 10 auszuwählen.

SCALE

Gibt die Inkrementschritte zwischen den Werten an. Wurde RANGE beispielsweise auf Zahlen zwischen 1 und 500 gesetzt, zeigt SCALE=100 nur die Zahlen 100, 200, 300 usw. an.

VALUE

Gibt die Vorgabeeinstellung des Schiebereglers an..

ONVALIDATE

Der Name einer JavaScript-Funktion, mit der die Eingabe ausgewertet wird.

MESSAGE

Text, der erscheint, falls die Auswertung fehlschlägt.

ONERROR

Eine Javascript-Funktion, die ausgeführt wird, wenn die Auswertung fehlschlägt.

GROOVECOLOR

Statt einer IMG-Datei können Sie den Schieberegler auch mit einer gültigen HEX-Farbe darstellen.

BGCOLOR

Die Hintergrundfarbe der Beschriftung für den Schieberegler.

TEXTCOLOR

Die Textfarbe der Beschriftung für den Schieberegler.

Tabelle 11.5: Parameter für

292

Zusammenfassung

11.7 Zusammenfassung Das -Tag von ColdFusion bietet zahlreiche Möglichkeiten, die Dateneingabe auf Ihrer Site an Ihre Bedürfnisse anzupassen und zu erweitern. Obwohl es mehr Funktionsmerkmale aufweist als das Standard--Tag von HTML, übergibt es die ermittelten Daten auf dieselbe Weise. Aus diesem Grund können die durch ColdFusion erweiterten Formulare mit bereits existierenden Aktionsseiten und CGI-Skripten verarbeitet werden. Mit ColdFusion erweiterte Formulare verwenden JavaScript, um die neuen Funktionsmerkmale im Browser der Benutzer zu erzeugen. Der Entwickler muss nicht Java sprechen, um diese Werkzeuge nutzen zu können. Sie verwenden einfach die erforderlichen Tags in Ihren Templates – den Rest übernimmt ColdFusion im Hintergrund für Sie. Mit den Tags und in erzeugen Sie Textfelder, die Benutzereingaben automatisch auswerten, um sicherzustellen, dass der Benutzer bei der Eingabe gültige Telefonnummern, Postleitzahlen, Sozialversicherungsnummern oder andere von Ihnen vorgegebenen Formate einhält. erlaubt Ihnen außerdem, die Darstellung der Eingabeelemente anzupassen, beispielsweise mit farbigen Schriften, Hintergrundfarben und fetten und kursiven Einträgen. Besonders praktisch für ColdFusion-Entwickler ist das -Tag, das die Aufgabe wesentlich vereinfacht, ein Auswahlfeld mit Abfrageergebnissen zu füllen. ermöglicht Ihnen, eine JavaScript-gesteuertes Auswahlwerkzeug für nummerische Werte bereitzustellen.

11.8 Workshop F&A F

Ich stelle eine reine HTML-Site auf ColdFusion um. Sollte ich alle meine Seiten durchlaufen und alle meine -Tags in -Tags umwandeln und sie auf Template-Seiten platzieren? A

Wenn es keine Probleme gibt, sollten Sie auch nichts ändern. Der Vorteil bei der Beibehaltung existierender HTML-Formulare ist, dass sie kein Java benötigen und damit schneller geladen und narrensicher für alle Benutzer sind. Wenn Sie jedoch ein Formular haben, das von den erweiterten Funktionsmerkmalen von profitieren könnte, sollten Sie eine Aktualisierung vornehmen.

293

Eingabeseiten mit grundlegenden -Tags

F

Was passiert, wenn meine Site sich an Benutzer wendet, die keine Java-kompatiblen Browser verwenden? A

F

Sie können alternative Formulare mit reinem HTML für Benutzer bereitstellen, die kein Java unterstützen, indem Sie die Fehlermeldung im Parameter NotSUPPORTED der -Abschnitte entsprechend anpassen.

Kann ich als erfahrener JavaScript-Programmierer das Verhalten von -Tags anpassen? A

Ja. -Tags erlauben, JavaScript-Funktionen anzugeben, die ausgeführt werden, wenn bestimmte Aktionen auftreten, wie beispielsweise eine erfolgreiche oder eine fehlgeschlagende Auswertung.

Quiz 1. Was passiert, wenn ein Benutzer mit einem Browser, der kein Java unterstützt, versucht, eine mit ColdFusion erweiterte Formularseite anzuzeigen? 2. Benennen Sie das wichtigste von unterstütze Leistungsmerkmal, das von dem Standard-HTML-Tag nicht unterstützt wird. 3. Was ist der Unterschied zwischen und ? 4. Was ist der wichtigste Vorteil von gegenüber der Standardform ? 5. Welcher Parameter wird von einem abfragegestützten verwendet, um festzulegen, welche Option standardmäßig als Vorgabe dargestellt werden soll? 6. Angenommen, Sie wollen einen mit den Werten 5, 10, 15, 20 usw. bis 100 anlegen. Welche beiden Parameter verwenden Sie für das Tag?

Antworten 1. Sie erhalten die Standardmeldung von ColdFusion, dass die Seite nicht unterstützt wird, oder einen von Ihnen im -Tag bereitgestellten Fehlertext. 2. unterstützt eine Textauswertung, bei der festgestellt werden kann, ob der Benutzer eine gültige Telefonnummer, eine Postleitzahl usw. eingegeben hat. 3. unterstützt auch Optionsfelder und Kontrollkästchen, während insbesondere auf Texteingaben ausgelegt ist. Darüber hinaus erzeugt die Felder mit Hilfe von JavaScript und nicht mit HTML, so dass Sie die Farbe von Feld und Schrift anpassen können. 4. vereinfacht es, Auswahlfelder mit Abfrageergebnissen zu füllen.

294

Workshop

5. Es überrascht nicht, dass dies der SELECTED-Parameter ist, der auf den Text aus dem Feld, das Sie als Ihren VALUE spezifiziert haben, verweisen muss. Wenn Sie das Abfragefeld title als Ihren VALUE verwenden, enthält Ihr SELECTED-Parameter den Text eines gültigen Titels in Ihrer Tabelle. 6. Der RANGE-Parameter wird auf 5,100 gesetzt, SCALE auf 5. Auf diese Weise kann der Benutzer Werte in Inkrementschritten von 5 auswählen, beginnend mit »5«.

Übungen 1. Legen Sie ein Formular an, in das Benutzer eine gültige Sozialversicherungsnummer (neunstellig, nur aus Ziffern bestehend) eingeben müssen. Passen Sie die Fehlermeldung so an, dass sie »Sie lernen es nie!« ausgibt, wenn der Benutzer einen ungültigen Wert eingibt. 2. Legen Sie ein Formular an, das Benutzereingaben in Textfeldern sammelt. Passen Sie mit die Farbe, die Schrift und die Größe der Felder an. 3. Legen Sie ein Formular an, in dem der Benutzer mehrere Werte aus einem Auswahlfeld auswählen kann. Erzeugen Sie mit und einer Abfrage Auswahlmöglichkeiten und legen Sie eine Vorgabe für die Auswahl fest. 4. Legen Sie mit Hilfe von einen Schieberegler an, der dem Benutzer erlaubt, einen Zeitraum zwischen 1900 und heute auszuwählen.

295

Erweiterte Formulartechniken zur Verwaltung von Eingaben

2 1

Erweiterte Formulartechniken zur Verwaltung von Eingaben

Sie haben bisher viel über Web-Formulare und wie sie Eingaben von Benutzern bearbeiten erfahren. In diesem Kapitel geht es um erweiterte Entwurfstechniken, mit deren Hilfe Sie mehr aus Ihren Formularen machen. Sie lernen, Eingaben, Aktualisierungen und Löschvorgänge vorzunehmen und Ihre Formulare zu kombinieren, damit sie einfacher zu verwalten sind, wenn sich die Datenbankstruktur Ihrer Site ändert. Das Kapitel führt außerdem zwei -Tags ein, die in Kapitel 11 nicht berücksichtigt wurden, und die neue Möglichkeiten unterstützen, komplexe Daten anzuzeigen und Benutzereingaben entgegenzunehmen. In diesem Kapitel geht es um die folgenden Dinge: 쐽

Mit SQL Datensätze aktualisieren, einfügen und löschen.

쐽

Mehrfunktionale Formularseiten.

쐽

Daten mit anzeigen und auswählen.

쐽

Daten mit und anzeigen und auswählen.

12.1 Aktualisieren, Einfügen und Löschen mit SQL In Kapitel 5 haben Sie erfahren, wie Sie mit den Tags und Datensätze in einer Datenbank bearbeiten und hinzufügen. Für einfache Sites sind diese Werkzeuge wunderbar geeignet – Sie ermöglichen Ihnen, Benutzerdaten aus einem Formular entgegenzunehmen und irgendeine Aktion dafür in Ihrer Datenbank vorzunehmen. Nachdem Sie jedoch mehr über ColdFusion gelernt haben und Ihre Applikationen immer komplexer werden, brauchen Sie vielleicht flexiblere Methoden für die Arbeit mit Ihrer Datenbank. Abbildung 12.1 zeigt ein grundlegendes Beispiel. Um diese Daten in eine Tabelle einzutragen, verwenden Sie beispielsweise die in Listing 12.1 gezeigte Aktionsseite. Listing 12.1: guestbook_submit.cfm 1: 2: 3: 4: 5: 6: 7: 8: 9: 10:

298



Danke für Ihren Eintrag

Aktualisieren, Einfügen und Löschen mit SQL

11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23:

Danke für Ihren Eintrag Ihr Text sieht wie folgt aus:

Ihr Name: #form.name#

Ihre E-Mail-Adresse: #form.email#

Ihr Nettoverdienst: #net_worth#



Abbildung 12.1: Ein grundlegendes Eingabeformular, das Daten vom Benutzer entgegennimmt.

Beachten Sie das -Tag in Zeile 1 von Listing 12.1 – hier werden die Benutzerdaten eingefügt. Weitere Informationen über und finden Sie in Kapitel 7.

ist ein ausgezeichnetes Werkzeug, wenn Sie nur mit Formulardaten arbeiten wollen, aber was machen Sie mit anderen Informationen, die Sie einfügen wollen – Informationen, die nicht aus dem Formular stammen? Nehmen wir beispielsweise an, Sie wol-

299

Erweiterte Formulartechniken zur Verwaltung von Eingaben

len die aktuelle Zeit und das Datum einfügen, wann der Benutzer der Datenbank Informationen hinzugefügt hat. Sie könnten eine spezielle ColdFusion-Funktion, Now(), auf Ihrer Aktionsseite ausführen, um die aktuelle Zeit und das Datum zu erzeugen, aber weil dieser Wert nicht über das Formular übergeben wird, »sieht« ihn nicht. Das -Tag erlaubt nur das Einfügen von Formularfeldern – diese Methode funktioniert also offensichtlich nicht. ColdFusion-Funktionen werden in Kapitel 14 genauer beschrieben. Hier müssen Sie nur wissen, dass #Now()# eine Variable erzeugt, die die aktuelle Zeit und das Datum enthält, die Ihr Web-Server bereitstellt. In solchen Situationen, wo Eingabedaten nicht direkt aus einem Formular kommen, können Sie alternative Methoden nutzen, um sie Ihrem Datenbankinhalt hinzuzufügen oder diesen zu bearbeiten. Diese Methoden sind die SQL-Anweisungen UPDATE, INSERT und DELETE. Alle werden im Kontext einer Standard-SQL-Abfrage anstelle der schon bekannten SELECT-Anweisung verwendet. Die nächsten Abschnitte beschreiben die drei Anweisungen detailliert, aber zuvor wollen wir einige Situationen betrachten, in denen Sie diese SQLMethoden anstelle ihrer einfacheren ColdFusion-Gegenstücke verwenden sollten: 쐽

Wenn Sie Daten einfügen wollen, die nicht aus einem Formular stammen.

쐽

Wenn Sie Daten in mehrere Tabellen einfügen wollen.

쐽

Wenn das Einfügen oder Aktualisieren zu kompliziert ist, um durch oder ausgeführt zu werden.

쐽

Wenn Sie einen oder mehrere Datensätze aus einer Tabelle löschen wollen.

Die SQL-Anweisung INSERT Am folgenden Beispiel sehen Sie, wie man Daten mit SQL einfügt. Die ACTION-Seite in Listing 12.1 enthielt die folgende Einfügefunktion:

Aber jetzt wollen Sie das aktuelle Datum und die Zeit in die Datenbank eintragen, die nicht über das Formular übergeben werden. Sie könnten die obige Anweisung durch eine SQL-Abfrage wie die folgende ersetzen:

INSERT INTO visitors(name,email,net_worth,date) VALUES('#name#',

300

Aktualisieren, Einfügen und Löschen mit SQL

'#email#', '#net_worth#', #Now()#)

Das Einfügen mit SQL ist viel flexibler als , weil Sie damit mehr Kontrolle darüber haben, wie und wo Daten eingefügt werden. Betrachten Sie die Anweisung noch einmal etwas genauer. Sie beginnt mit einem Standard--Tag, wobei aber kein NAME angegeben ist, weil diese Abfrage keine Daten ausgibt. Sie gibt den Namen einer Tabelle an, für die das INSERT INTO durchgeführt werden soll, gefolgt von einer Liste der Feldnamen, durch Kommas getrennt und in Klammern eingeschlossen. Die Reihenfolge dieser Feldnamen ist wichtig, weil sie genau der Reihenfolge der in VALUES aufgelisteten Daten entsprechen muss. Der Wert, der dann letztlich in INSERT ,#Now()# steht, trägt das aktuelle Datum und die Zeit wie vom Web-Server bereitgestellt in die Tabelle visitors ein, wenn der Benutzer das Formular aktualisiert. Diese spezielle Funktion wird nicht in einfache Anführungszeichen eingeschlossen, weil es sich nicht um eine Zeichenkette handelt – vielmehr haben wir hier ein Datum/Zeit-Objekt, worüber Sie in Kapitel 14 noch mehr erfahren werden. Angenommen, der Benutzer gibt typische Daten in das Formular ein, könnte meine Microsoft Access-Datenbank jetzt einen Datensatz wie in Abbildung 12.2 gezeigt enthalten. Beachten Sie, dass das ID-Feld von Access automatisch bereitgestellt wird, wenn neue Datensätze in die Tabelle eingetragen werden. Abbildung 12.2: Ein Datensatz, der mit der SQL-Anweisung INSERT eingefügt wurde und das Datum und die Zeit enthält, wann er eingefügt wurde.

Abhängig von Ihrer Datenbank-Software und dem Datentyp in Ihrer Tabelle müssen Datum/Zeit-Objekte wie beispielsweise Now() speziell formatiert werden, damit sie in einem INSERT in Ihre Datenbank eingefügt werden können. Wenn Sie Probleme mit dem oben gezeigten INSERT haben, versuchen Sie, für die Beispiele in diesem Kapitel Textdatentypen zu verwenden. Nachdem Sie in Kapitel 14 mehr über Datum/Zeit-Objekte erfahren haben, verwenden Sie ColdFusion-Funktionen, um Now() in ein Datumsformat umzuwandeln, das von Ihrer Datenbank verarbeitet werden kann.

301

Erweiterte Formulartechniken zur Verwaltung von Eingaben

Die SQL-Anweisung UPDATE Die Anweisung UPDATE ist INSERT ganz ähnlich, nimmt aber andere Parameter entgegen. Betrachten wir ein Beispiel. Angenommen, Sie wollen eine Seite erstellen, die dem Benutzer ermöglicht, fehlerhafte Einträge aus dem vorigen Beispiel zu korrigieren. Dazu verwenden Sie ein Formular, das einen bereits existierenden Datensatz aus der Datenbank lädt und zeigen ihn als VALUEs in einem Formular an, wie in Abbildung 12.3 gezeigt.

Abbildung 12.3: Ein Formular, in dem Benutzer zuvor gesendete Daten bearbeiten können.

Listing 12.2 zeigt den Code, mit dem dieses Formular erstellt wurde. Für die Seite muss das ID-Feld über den URL angegeben werden (oder möglicherweise über ein vorhergehendes Formular), um den Datensatz des Benutzers zu laden. Listing 12.2: guestbook_edit.cfm 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11:

302

SELECT * FROM visitors WHERE ID = #ID#

Benutzerinformation bearbeiten

Benutzerinformation bearbeiten

Aktualisieren, Einfügen und Löschen mit SQL

12: 13: Um Ihre Benutzerinformation zu bearbeiten, ändern Sie die Textfelder ➥und drücken auf die folgende Schaltfläche. 14: 15: 16: 17: Ihr Name:
18:

19: 20: Ihre E-Mail-Adresse:
21:

22: 23: Ihr Nettoeinkommen:
24: $

25: 26: 27: 28: 29: 30: 31: 32: 33:

Beachten Sie, dass in Listing 2.2 in Zeile 26 ein verborgenes Feld enthalten ist, das die ID für den betreffenden Datensatz enthält. Das ist wichtig, weil Sie sie auf der ACTION-Seite brauchen, um die Aktualisierung mit oder der SQL-Anweisung UPDATE durchzuführen. Das Formular ermöglicht den Benutzern, die existierenden Daten zu bearbeiten – Tippfehler korrigieren, Nettoverdienst erhöhen, usw. – und die neue Information dann in die Datenbank einzutragen, wo der alte Datensatz überschrieben wird. Dazu könnten Sie ein -Tag wie das folgende auf der ACTION-Seite verwenden:

ist in Kapitel 7 beschrieben.

Wenn Sie die ID (den Primärschlüssel der Tabelle) als verborgenes Feld übergeben, kann den Datensatz mit den vom Benutzer bearbeiteten Daten überschreiben. Angenommen, Sie wollen das Ganze etwas komplizierter machen und das existierende

303

Erweiterte Formulartechniken zur Verwaltung von Eingaben

Datumsfeld mit dem neuen Datum überschreiben, wenn der Benutzer seine bearbeiteten Daten einträgt. Wie bietet auch keine Möglichkeit, Daten zu aktualisieren, die nicht im Formular übergeben werden. Dazu brauchen Sie die SQLAnweisung UPDATE, wie in Listing 12.3 gezeigt, das die ACTION-Seite für das Formular zeigt. Listing 12.3: guestbook_edit_submit.cfm 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30:

UPDATE visitors SET name='#name#', email='#email#', net_worth='#net_worth#', visited=#Now()# WHERE ID=#ID#



Danke für Ihren Eintrag

Danke für Ihren Eintrag Sie haben folgenden Text eintragen:

Ihr Name: #form.name#

Ihre E-Mail-Adresse: #form.email#

Ihr Nettoverdienst: #net_worth#



Listing 12.3 enthält eine Abfrage, in der statt die SQL-Anweisung UPDATE verwendet wird. Es übergibt UPDATE den Namen einer Tabelle und gibt dann die Feldnamen und die Variablenwerte ein, die die alten Daten überschreiben. Beachten Sie, dass die Funktion #Now()# wie im letzten Abschnitt nicht in einfache Anführungszeichen eingeschlossen ist, weil es sich nicht um eine Zeichenkette handelt. Die UPDATE-Abfrage endet mit der zwingend erforderlichen Zeile: WHERE ID=#ID#

304

Aktualisieren, Einfügen und Löschen mit SQL

Daran erkennt ColdFusion, welchen Datensatz Sie ersetzen müssen – wenn Sie die Zeile nicht angeben, schlägt die Aktualisierung fehl und Sie erhalten eine Fehlermeldung.

Die SQL-Anweisung DELETE Anders als INSERT und UPDATE gibt es für die SQL-Anweisung DELETE kein äquivalentes ColdFusion-Tag. Wenn Sie also mit ColdFusion Daten aus einer Tabelle löschen wollen, müssen Sie immer die DELETE-Anweisung in einer SQL-Abfrage verwenden. Wenn Sie aus einer Datenbank Datensätze mit DELETE entfernen, sind diese unwiderruflich gelöscht. Sie können es sich also nicht anders überlegen. Deshalb sollten Sie bei der Erstellung von Seiten, auf denen Benutzer Informationen löschen können, extrem vorsichtig vorgehen. Abbildung 12.4 zeigt ein Beispiel für ein Formular, von dem aus Daten gelöscht werden können. Listing 12.4 zeigt den Code für Abbildung 12.4. Listing 12.4: guestbook_delete.cfm 1: 2: SELECT * FROM visitors 3: 4: 5: 6: 7: Benutzerinformation löschen 8: 9: 10: 11: Benutzerinformation löschen 12: 13: Um einen Benutzer zu löschen, wählen Sie den Namen und klicken auf die ➥Schaltfläche unten. 14: 15: 16: 17: 18: 19: 20: 21:

305

Erweiterte Formulartechniken zur Verwaltung von Eingaben

22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34:

#name#








Das ist eine ganz einfache Formularseite, aber es gibt ein paar Dinge zu beachten. Erstens, der Abfrageabschnitt in den Zeilen 1 bis 3 ermittelt die Daten für alle Benutzer der Tabelle visitors. Sie werden als OPTION-Werte im Auswahlfeld des Formulars angezeigt (Zeilen 18 bis 26). Beachten Sie, dass das Auswahlfeld zwar den Namen des Benutzers anzeigt, die übergebene Variable aber #ID# ist. Auch dies ist wichtig, weil Sie der ACTION-Seite, wo das eigentliche Löschen passiert, einen eindeutigen Wert übergeben müssen. Die ID ist optimal dafür geeignet, weil sie sicherstellt, dass Sie nicht den falschen Datensatz löschen. Listing 12.4 übergibt der ACTION-Seite guestbook_delete_action.cfm nur eine Variable, die ID des Datensatzes. Listing 12. 5 zeigt diese Seite. Listing 12.5: guestbook_delete_action.cfm 1: 2: DELETE FROM visitors 3: WHERE ID=#form.ID# 4: 5: 6: 7: 8: 9: 10: Eintrag gelöscht 11: 12: 13: 14: Danke für Ihren Eintrage 15: 16: Der Datensatz für die Benutzer-ID #form.ID# ➥wurde gelöscht. 17:

306

Mehrere Formularaktionen kombinieren

18:

19: 20: 21:

Abbildung 12.4: Ein Formular, von dem aus Benutzer Datensätze aus einer Datenbank löschen können.

Die SQL-Anweisung DELETE ist sehr einfach zu benutzen – und genau darin liegt die größte Gefahr. Man braucht ihm nur einen Parameter zu übergeben – in diesem Fall die #ID# aus dem vorherigen Formular. Man gibt einfach den Namen einer Tabelle an, aus der etwas gelöscht werden soll, und zack, ist der Datensatz weg. Wenn Sie Seiten erstellen, die DELETE verwenden, sollten Sie zum Ausprobieren eine Testtabelle oder -Datenquelle verwenden. Wenn Sie eine aktive Datenquelle verwenden, riskieren Sie den Verlust wertvoller Daten.

12.2 Mehrere Formularaktionen kombinieren In den vorigen Beispielen haben Sie drei verschiedene Formulare und ACTION-Seiten erstellt, die drei verschiedene Funktionen ausgeführt haben. In einer echten Web-Applikation wollen Sie zwei oder mehr dieser Aktionen auf einer einzigen Seite anbieten – womit

307

Erweiterte Formulartechniken zur Verwaltung von Eingaben

Sie Ihren Benutzern eine einfachere Navigation erlauben und sich selbst Zeit bei der Codierung ersparen. Betrachten Sie beispielsweise Abbildung 12.5.

Abbildung 12.5: Ein mehrfunktionales Administrationsformular mit zwei möglichen Aktionen.

Diese Seite unterstützt zwei verschiedene Aktionen: Einfügen und Aktualisieren. Beide führen zur selben ACTION-Seite, aber nur die edit-Funktion übergibt eine Variable. Listing 12.6 zeigt, was im Hintergrund passiert. Listing 12.6: user_admin.cfm 1: 2: SELECT * FROM visitors 3: 4: 5: 6: 7: Benutzerverwaltung 8: 9: Benutzerverwaltung 10: 11: Diese Seite erlaubt Gargantuan-Administratoren, Benutzerinformationen in ➥die Datenbank einzutragen und dort zu bearbeiten. 12: 13: 14: Benutzer hinzufügen 15: Hier klicken um einen neuen Benutzer einzutragen. 16:

308

Mehrere Formularaktionen kombinieren

17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37:

Benutzerinformationen bearbeiten Wählen Sie einen Benutzer aus der folgenden Liste


#name#





Die in Zeile 1 lädt alle Benutzer aus der Tabelle, um sie in der Dropdown-Liste mit den bearbeitbaren Einträgen anzuzeigen, wie im vorigen Abschnitt zur SQL-Anweisung UPDATE bereits beschrieben. Für das Hinzufügen ist nichts besonderes notwendig – nur ein Verweis auf die Seite user_edit.cfm. Auf der ACTION-Seite passiert die eigentliche Arbeit. Wenn ein Benutzer die Option »Hinzufügen« wählt, gelangt er auf die Seite user_edit.cfm und es wird keine Variable übergeben. Wählt er einen Namen aus der Bearbeitungsliste, gelangt er auf dieselbe Seite, aber die Variable #ID# wird vom Formular übergeben. Abhängig vom Vorhandensein der #ID#Variablen erkennt die ACTION-Seite, was passieren soll. Listing 12.7 zeigt, wie eine Seite beide Aktionen unterstützen kann. Listing 12.7: user_edit.cfm 1: 4: 5: 6: 7:

SELECT * FROM visitors WHERE ID=#form.ID#



Benutzerverwaltung

Benutzerinformationen hinzufügen oder bearbeiten:

Name: VALUE="#get_user.email#"

>

Net Worth: 61:

62: 63: 64: 65: 66: 67: 68:

Wie Sie sehen, wird es hier schon ein bisschen komplizierter, aber die Zeit, die Sie sich damit sparen, wird sich spätestens dann auszahlen, wenn Sie Ihr Formular oder Ihre Datenbank später ändern müssen. Betrachten wir den Code. Das erste Element auf der Seite verwendet eine spezielle Funktion, #IsDefined()#, um die Existenz der Variablen #ID# zu überprüfen. Auch über diese Funktion werden Sie in einem späteren Kapitel mehr erfahren – hier brauchen Sie nur zu wissen, dass #IsDefined()# prüft, ob die zwischen den Klammern angegebene Variable existiert. Wurde die Variable #ID# vom vorhergehenden Formular übergeben, erzeugt diese ACTIONSeite mit Hilfe von die Variable to_do und definiert sie in Zeile 3 als »edit«. Wurde keine Variable übergeben (weil der Benutzer vielleicht einen neuen Datensatz anlegt), wird to_do in Zeile 7 auf »add« gesetzt. Ist to_do gleich »edit«, verwendet die Seite das in den Zeilen 13 bis 15, um Daten für den ausgewählten Benutzer zu laden. Ist to_do als »add« definiert, wird die Abfrage nicht ausgeführt. Im Formularabschnitt ab Zeile 28 wird die Variable to_do wieder verwendet, um festzustellen, ob ein neuer Datensatz hinzugefügt oder ein bereits existierender Datensatz bearbeitet werden soll. Ist to_do gleich »edit«, wird jedem Formularfeld ein VALUE-Benutzer hinzugefügt, so dass die Benutzerinformation auf der Seite angezeigt wird. Ist to_do gleich »add«, ist kein VALUE angegeben und die Eingabefelder sind leer, so dass neue Informationen eingetragen werden können. Unmittelbar vor dem Schließen des Formulars wird in Zeile 61 ein verborgenes Feld mit der ID des Datensatzes hinzugefügt, falls to_do gleich »edit« ist. Für Aktualisierungen muss eine ID oder ein Primärschlüssel angegeben werden, deshalb müssen Sie diesen auf der nächsten Seite übergeben, falls Sie eine Aktualisierung vorhaben. Ist der Datensatz neu, muss keine ID übergeben werden.

311

Erweiterte Formulartechniken zur Verwaltung von Eingaben

Haben Sie das verstanden? Falls nicht, sollten Sie diesen Abschnitt noch einmal durchlesen. Es dauert ein bisschen, bis man verstanden hat, wie diese mehrfunktionalen Seiten funktionieren, aber der Aufwand wird sich irgendwann auszahlen. Das Ergebnis von Listing 12.7 ist, dass dem Web-Server eine von zwei Seiten angezeigt wird. Wählt der Benutzer auf dem vorhergehenden Formular »Benutzer hinzufügen«, sieht er leere Formularfelder. Wählt er »Benutzer bearbeiten«, sieht er Formularfelder mit den Daten des Benutzers, die hier bearbeitet werden können. Betrachten Sie jetzt die ACTION-Seite, user_update.cfm. Auch diese Seite muss eine von zwei Aktionen ausführen. Ist der Datensatz neu, fügt sie ihn ein und trägt die Benutzerdaten in die Tabelle ein. Handelt es sich um einen bereits existierenden Datensatz, der bearbeitet werden soll, muss die ACTION-Seite statt dessen aktualisieren. Diese Seite verwendet dieselbe Funktion #IsDefined()#, um zu überprüfen, ob eine IDVariable übergeben wurde. Listing 12.8 zeigt den zugehörigen Code. Listing 12.8: user_update.cfm 1: 4: 5: 6: 7:

12: 13:

18: 19:

26: 27: 2: 3: ➥SELECT FAQ_number,text FROM superview_faqs WHERE FAQ_number = ➥'#FAQ_number#' 4: 5: 13: 14: 15: Die Mail wurde versendet 16: 17: 18: 19:

SELECT * FROM users

#text#

#name# #email#




Wie bei jedem Werkzeug, das in der Lage ist, mehrere E-Mails gleichzeitig zu versenden, besteht die Gefahr des Spam-Missbrauchs mit . Sie sollten nicht berechtigte Benutzer fernhalten, indem Sie Seiten oder Abschnitte, die nur intern genutzt werden sollen, durch ein Kennwort schützen. Außerdem sollten Sie Ihren Kunden auf die Gefahren beim Versenden nicht angeforderter Mail hinweisen und ihm erklären, dass er nur -Applikationen erzeugen soll, die etwas an Benutzer schicken, die sich entweder in eine MailingListe eingetragen oder explizit Mail angefordert haben.

342

Eingehende Mail mit entgegennehmen

13.6 Eingehende Mail mit entgegennehmen Die leistungsfähige Ergänzung zu ist , das Mails empfängt und damit den Benutzern ermöglicht, eingehende Mail von einer ColdFusion-Template-Seite aus anzuzeigen und zu verwalten. arbeitet wie ein Mail-Client unter Verwendung des POP3-Mail-Protokoll. Es kann so angepasst werden, dass es die vielen Funktionen für POP3-Benutzer unterstützt. POP3 steht für Post Office Protocol, das ist ein gebräuchlicher Internet-Standard zum Empfangen von E-Mail. POP3-kompatible Mail-Server speichern die Mail der Benutzer, bis sie von einem POP3-kompatiblen Mail-Client abgerufen wird, wie beispielsweise Microsoft Outlook, Eudora oder Netscape Mail. Wenn Sie neue Nachrichten von Ihrem ISP (Internet Service Provider) herunterladen, verwenden Sie sehr wahrscheinlich POP3. Einer der Vorteile von POP3 gegenüber anderen Mail-Protokollen ist die Möglichkeit, nur Mail-Header zu laden – ohne die eigentliche Nachricht. Mit dieser Methode können POP3-cClient-Programme den Benutzern ermöglichen, ihre Mailboxen vorabzufragen und unerwünschte Nachrichten zu löschen, bevor sie sie herunterladen. beinhaltet diese Funktion ebenfalls. Der Header einer E-Mail ist der Teil der Nachricht, der definiert, von wem die Mail kommt, an wen sie geschickt werden soll, wann und wie sie versendet wurde, und andere Steuerdaten. Die andere Komponente einer E-Mail ist ihr Rumpf mit dem eigentlichen Text der Nachricht. Es gibt zwei Möglichkeiten, Parameter bereitzustellen: 쐽

Dynamisch, etwa von einer Formularseite oder einer Abfragevariablen.

쐽

Statisch durch die direkte Bereitstellung von Parametern im Template.

Sie übergeben Parameter mit dem Namen eines POP3-Mail-Servers, einem Benutzernamen und einem Kennwort. Wenn ein Benutzer eine Template-Seite mit dem -Tag lädt, lädt ColdFusion alle Nachrichten, die auf diesen Benutzer warten, oder alternativ nur deren Header. merkt sich die geladene Mail-Information so wie die Ergebnisse einer Datenbankabfrage speichert. Durch Verwendung spezieller Variablen wie #FROM#, #SUBJECT# und #BODY# in Kombination mit können Sie den Inhalt der Mail eines Benutzers als Ausgabe eines Template anzeigen.

343

E-Mail

Betrachten wir eine Beispielanwendung von in Listing 13.8. Angenommen, der Benutzer ist ein Angestellter im riesigen Hauptsitz von SuperView 2000. Alle Angestellten bei SuperView verwenden den Mail-Server pop.superview2000.com, um ihre eingehende Mail abzufragen. Listing 13.8: Mail-Header von einem POP3-Mail-Server abrufen 1:

From: #from#
Subject: #subject#

344

Mail mit löschen

Um die Ergebnisse eines Mail-Ladevorgangs mit anzuzeigen, verwende ich dieselbe Technik wie für eine Standard-. Ich gebe den Namen an und verwende dann die Variablen, die für den Benutzer ausgegeben werden, wenn er die Seite anzeigt. Anders als bei sind die von verwendeten Ausgabevariablen nicht definierbar. Um darauf zuzugreifen, müssen die von ColdFusion vorgegebenen Variablennamen verwenden werden. Tabelle 13.2 zeigt eine vollständige Liste der von zurückgegebenen Variablen. Variablenname

Inhalt

DATE

Enthält Zeit und Datum, wann die Nachricht gesendet wurde.

FROM

Der Name der Person, die die Nachricht gesendet hat.

TO

Die E-Mail-Adresse, an die die Nachricht gesendet wurde.

ATTACHMENTS

Falls der Nachricht Dateien angehängt wurden, werden diese hier durch Tabulatoren voneinander getrennt aufgelistet.

CC

Die Adresse anderer, denen der Absender eine Kopie der Mail zuschickt.

REPLYTO

Die E-Mail-Adresse, an die Antworten gesendet werden.

SUBJECT

Das Thema der Nachricht.

MESSAGENUMBER

Eine Nummer, die jeder empfangenen Nachricht zugeordnet wird. Diese Variable ist praktisch für Steueraufgaben, wie beispielsweise die Codierung einer Aktion, die Nachricht Nummer 5 zu löschen.

BODY

Wird nur zugewiesen, wenn die Aktion GETALL im -Tag verwendet wird. BODY enthält den eigentlichen Text der Nachricht.

Tabelle 13.2: Die von zurückgegebenen Variablennamen

Um den Inhalt einer dieser Variablen in einem -Abschnitt anzuzeigen, verweise ich so auf die Variable, wie ich eine Abfragevariable verwende, nämlich mit Doppelkreuzen: #subject# oder #from#.

13.7 Mail mit löschen Mit Hilfe der in diesem Kapitel beschriebenen Techniken kann ich mit ColdFusion einen vollständigen E-Mail-Client anlegen. Dazu würde ich auf meinen Template-Seiten verwenden, um die Nachrichten für den Benutzer zu laden und anzuzeigen, und , um ausgehende Mails zu senden. Bisher habe ich jedoch nur das Lesen und das Schreiben von Mail angesprochen – wie lösche ich die Mail vom Server, nachdem der Benutzer sie gelesen hat?

345

E-Mail

Ich verwende die dritte -Aktion, DELETE. Diese Aktion wird immer in Kombination mit dem Parameter MESSAGENUMBER verwendet, um die zu löschende Nachricht zu spezifizieren. Wenn Sie mit dem DELETE-Parameter von Nachrichten von einem Mail-Server löschen, können diese nicht wiederhergestellt werden. Wenn Sie ein wirklich gutes Verhältnis zum Systemadministrator des Mail-Servers haben, könnte er eine Nachricht aus einer Sicherungskopie wiederherstellen (falls es eine solche gibt), aber das ist eher unwahrscheinlich. Verwenden Sie DELETE also mit Vorsicht. Angenommen, ich habe bereits einen einfachen Mail-Client für die Angestellten von SuperView 2000 angelegt. Um ein Template zu erzeugen, die mir erlaubt, Nachrichten zu löschen, lege ich zunächst eine Formularseite an, die den Account-Namen und das Kennwort des Benutzers entgegennimmt und diese Daten mit Hilfe von einem Template übergibt, um die aktuellen Nachrichten des Benutzers abzufragen und anzuzeigen. Für weitere Funktionalitäten könnte ich die Mail des Benutzers in einzelnen Komponenten auf einem Formular anzeigen. Mit Hilfe von Kontrollkästchen oder Auswahlfeldern und der von zurückgegebenen #messagenumber# kann der Benutzer nicht mehr benötigte Nachrichten löschen. Falls Sie schon lange kein Formular mehr angelegt haben, finden Sie in Kapitel 11 einige Beispiele dafür. Abbildung 13.7 zeigt ein Beispielformular. Im Code für dieses Formular habe ich die Kontrollkästchen für die einzelnen Nachrichten mit der von der -Standardvariablen #messagenumber# zurückgegebenen Nummer definiert, etwa wie folgt:

Wenn der Benutzer eine zu löschende Nachricht kennzeichnet und das Formular sendet, ist die übergebene Variable gleich messagenumber=1, messagenumber=2 usw. Die Aktionsseite für das Formular verwendet und die Aktion DELETE, um die entsprechende Nachricht zu löschen, wie in Listing 13.10 gezeigt. Listing 13.10: delete_mail.cfm 1:

Geben Sie den Namen der Zieldatei ein:




Eine Datei löschen

Geben Sie den Namen der zu löschenden Datei ein:




Die folgenden Abschnitte betrachten die einzelnen -Abschnitte und die zugehörigen ACTION-Seiten genauer.

459

Dateien und Verzeichnisse

Abbildung 18.4: Diese Formularseite verwendet drei -Abschnitte, um drei verschiedene Aufgaben zur Dateiverwaltung zu realisieren.

Die ACTION-Seite für das Kopieren Betrachten Sie den Abschnitt für das Kopieren in Listing 18.5. Der Code sieht wie folgt aus:

Eine Datei umbenennen

Geben Sie den Namen der umzubenennenden Datei ein:

Geben Sie den neuen Dateinamen ein:




Listing 18.7 zeigt die ACTION-Seite für diesen -Abschnitt. Listing 18.7: copy.cfm 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16:

462

Ihre Datei wurde umbenannt!



DESTINATION="#FileDest#"

Ihre Datei wurde umbenannt!

Die Datei #FORM.FileSource# wurde in #FORM.FileDest# umbenannt.

Dateien mit kopieren, umbenennen und löschen

17: Sie können weiterarbeiten! 18: 19:

Listing 18.7 ist Listing 18.6 sehr ähnlich, bis auf die ausgeführte ACTION. Die ACTION rename nimmt ebenfalls SOURCE und DESTINATION entgegen, die von der Formularseite dynamisch übergeben werden. Der ATTRIBUTES-Parameter wurde ebenfalls auf SCHREIBGESCHÜTZT (ReadOnly) gesetzt.

Die ACTION-Seite zum Löschen Die ACTION-Seite für das Löschen, delete, ist die einfachste Aufgabe in , aber gleichzeitig auch die gefährlichste. Sie nimmt nur ein Attribut entgegen: den Namen der zu löschenden Datei. Der -Abschnitt aus Listing 18.5 sieht wie folgt aus:

2: 3: 4: 5: 33: 34: Ihr Auftrag wurde nicht verarbeitet. Unser Zahlungsprozess hat den ➥folgenden Fehler zurückgegeben:

37: 38: #MErrMsg# 39: 40: 41: 42:

Beispiel für CFABORT

Beispiel für CFABORT

Beispiel A: Die Anweisung wird vollständig ausgeführt

Der Wert von myVariable nach dem Hochzählen in der Schleife #Counter#mal ergibt: #myVariable#







575

ColdFusion-Tags

Der Wert von myVariable nach Inkrementierung in der Schleife #counter#mal ergibt: #myVariable#



B.16 CFAPPLET CFAPPLET erlaubt bei Verwendung in einem CFFORM den Verweis auf benutzerdefinierte Java-Applets, die zuvor mit dem ColdFusion-Administrator registriert wurden.

Um ein Java-Applet zu registrieren, öffnen Sie den ColdFusion Administrator und klicken auf die Schaltfläche APPLETS.

Syntax

APPLETSOURCE Zwingend erforderlich. Der Name des registrierten Applets. NAME Zwingend erforderlich. Der Formularvariablenname für das Applet. HEIGHT Optional. Die Höhe, angegeben in Pixel. WIDTH Optional. Die Breite, angegeben in Pixel. VSPACE Optional. Abstand oberhalb und unterhalb des Applets, angegeben in Pixel.

576

CFAPPLET

HSPACE Optional. Abstand an jeder Seite des Applets, angegeben in Pixel. ALIGN Optional. Ausrichtung. Gültige Werte sind: 쐽

Left

쐽

Right

쐽

Bottom

쐽

Top

쐽

TextTop

쐽

Middle

쐽

AbsMiddle

쐽

Baseline

쐽

AbsBottom

NOTSUPPORTED Optional. Der Text, den Sie anzeigen wollen, falls die Seite, die ein auf einem Java-Applet basierendes CFFORM-Steuerelement enthält, in einem Browser geöffnet wird, der Java nicht unterstützt oder die Java-Unterstützung deaktiviert hat. Ein Beispiel: NOTSUPPORTED="Der Browser muss Java unterstützen, damit ColdFusion Java Applets angezeigt werden können."

Falls keine Meldung angegeben ist, wird standardmäßig die folgende angezeigt: Der Browser muss Java unterstützen, damit
ColdFusion Java Applets angezeigt werden können!

paramn Optional. Der gültige Name eines registrierten Parameters für das Applet. Geben Sie nur dann einen Parameter an, wenn Sie die bereits mit dem ColdFusion Administrator definierten Parameterwerte überschreiben wollen.

Verwendung Weil Java-Applets vor der Verwendung registriert werden müssen, kann das CFAPPLET-Tag sehr einfach ausgelegt sein und die Standardparameterwerte so übernehmen, wie sie im Coldfusion Administrator registriert wurden. Sie können Parameter auch überschreiben, indem Sie sie direkt im CFAPPLET-Tag aufrufen.

Beispiel

Sitzungs- und Applikationsvariablen definieren

CFAPPLICATION Example

CFAPPLICATION definiert Gültigkeitsbereiche für eine ColdFusionApplikation und aktiviert oder deaktiviert das Speichern von Applikations- und Sitzungvariablen. Dieses Tag wird in der speziellen Datei Application.cfm abgelegt, die in einem Verzeichnis vor allen anderen CF-Templates ausgeführt wird.





E-Turtleneck berichtet stolz, dass heute #application.number# Rollkragenpullover verkauft wurden.





...

B.19 CFAUTHENTICATE Das Tag CFAUTHENTICATE authentifiziert einen Benutzer, indem es einen Sicherheitskontext für die Applikation einrichtet.

Syntax

SECURITYCONTEXT Zwingend erforderlich. Sicherheitskontext, in dem der angegebene Benutzer authentifiziert wird. Dieser Kontext muss zuvor im Sicherheitssystem definiert werden.

582

CFAUTHENTICATE

USERNAME Zwingend erforderlich. Der zu authentifizierende Benutzer. PASSWORD Zwingend erforderlich. Kennwort für den Benutzer . SETCOOKIE Optional. Der Standardwert ist Yes (Ja). Gibt an, ob ColdFusion einen Cookie setzt, in dem Authentifizierungsinformationen enthalten sind. Dieser Cookie ist verschlüsselt und er enthält den Benutzernamen, den Sicherheitskontext, die Browser-Remote-Adresse sowie den HTTP-Benutzeragenten. THROWONFAILURE Optional. Der Standardwert ist Yes (Ja). Gibt an, ob ColdFusion eine Ausnahme (des Typs SECURITY) abfangen soll, falls die Authentifizierung fehlschlägt.

Verwendung Tragen Sie dieses Tag in die Datei Application.cfm ein, um einen Sicherheitskontext für Ihre Applikation festzulegen. Rufen Sie die Funktion IsAuthenticated auf, um festzustellen, ob der Benutzer authentifiziert wurde. Falls Sie für SETCOOKIE den Wert No (Nein) angegeben haben, müssen Sie CFAUTHENTICATE für jede Seite der Applikation aufrufen (beispielsweise über die Datei Application.cfm). Falls Sie THROWONFAILURE auf Yes (Ja) gesetzt haben, können Sie CFAUTHENTICATE in einen CFTRY/ CFCATCH-Block einschließen, um mögliche Ausnahmen im Programm zu verarbeiten.

Beispiel

Authentifizierungsfehler



Ihr gewünschter Kurs wurde gefunden: #Number# #Descript#


Suchen...

584

CFCACHE



B.21 CFCACHE CFCACHE ermöglicht Ihnen, Ihren Seitenaufbau wesentlich zu beschleunigen, wenn der dynamische Inhalt nicht bei jedem Zugriff des Benutzers auf die Seite aufgerufen werden muss. Dazu legt es temporäre Dateien an, die das statische HTML enthalten, das bei einer bestimmten Ausführung der ColdFusion-Seite zurückgegeben wurde. CFCACHE kann sowohl für einfache URLs als auch für URLs mit URL-Parametern verwendet werden.

Syntax

ACTION Optional. Legt eine der folgenden Aktionen fest: 쐽

CACHE – Legt ein server-seitiges Caching fest. Der Standadwert ist CACHE.

쐽

FLUSH – Die im Cache befindliche Seite wird aktualisiert. Wenn Sie FLUSH vorgeben, können Sie auch die Attribute DIRECTORY und EXPIREURL verwenden.

쐽

CLIENTCACHE – Legt Browser-Caching fest.

쐽

OPTIMAL – Legt durch eine Kombination aus serverseitigem und Browser-Caching ein optimales Caching fest.

Weitere Informationen finden Sie im Abschnitt Verwendung. PROTOCOL Optional. Gibt das Protokoll an, mit dem Seiten aus dem Cache erzeugt werden. Geben Sie dafür HTTP:// oder HTTPS:// an. Der Standardwert ist HTTP://. TIMEOUT Optional. Datum und Uhrzeit, die die älteste noch verwendbare Cache-Seite angeben. Falls die Seite im Cache älter als angegeben ist, aktualisiert ColdFusion die Seite. Standardmäßig verwendet Cold-

585

ColdFusion-Tags

Fusion alle Seiten im Cache. Wollen Sie beispielsweise, dass nur Dateien verwendet werden, die nicht älter als 4 Stunden sind, schreiben Sie folgendes:

DIRECTORY Optional. Wird zusammen mit der Einstellung ACTION=FLUSH verwendet. Gibt den vollständigen Pfad zu einem Verzeichnis mit der Datei cfcache.map, die verwendet wird, wenn ACTION=FLUSH ist. Der Standardwert ist das Verzeichnis der aktuellen Seite. CACHEDIRECTORY Optional. Gibt den vollständigen Pfad zu dem Verzeichnis an, in dem die Seiten zwischengespeichert werden sollen. Der Standardwert ist das Verzeichnis deraktuellen Seite. EXPIREURL Optional. Wird zusammen mit der Einstellung ACTION=FLUSH verwendet. EXPIREURL nimmt eine URLReferenz mit Wildcards entgegen, die ColdFusion mit allen Zuordnungen in der Datei cfcache.mapvergleicht. Der Standard ist, alle Zuordnungen zu löschen. Beispielsweise erzeugt »foo.cfm« eine Übereinstimmung mit »foo.cfm«; »foo.cfm?*« erzeugt Übereinstimmungen mit »foo.cfm?x=5« und »foo.cfm?x=9«. PORT Optional. Die Portnummer des Web-Servers, von dem die Seite angefordert wird. Die Portnummer ist standardmäßig 80. Die Portnummer ist praktisch, weil CFCACHE-Code CFHTTP aufruft. Wenn die Portnummer im internen Aufruf von CFHTTP korrekt angegeben ist, wird der URL jedes der gefundenen Dokumente so aufgelöst, dass Links beibehalten werden.

Verwendung In seiner einfachsten Form geben Sie einfach nur oben auf der Seite an, für die ein Caching realisiert werden soll. Mit dem ACTION-Attribut können Sie ein server-seitiges Caching, ein Browser-Caching oder eine Kombination aus server-seitigem und Browser-Caching festlegen. Der Vorteil beim Browser-Caching ist, dass es keine ColdFusion-Ressourcen verbraucht, weil der Browser die Seiten in seinem eigenen Cache ablegt, wodurch die Leistung verbessert wird. Der Vorteil bei der Kombination der beiden Caching-Arten ist, dass damit die Leistung optimiert wird; wenn der Browser-Cache veraltet ist, kann der Server die zwischengespeicherten Daten aus seinem eigenen Cache abrufen. Neben den eigentlichen Dateien im Cache verwendet CFCACHE eine Zuordnungsdatei, um das Caching zu steuern. Sie heißt cfcache.map und verwendet ein ähnliches Format wie eine INI-Datei unter Windows. Die Zurodnung eines URL mit Parametern wird wie folgt realisiert. Angenommen, das Verzeichnis »c:\InetPub\wwwroot\dir1« enthält die CFM-Datei »foo.cfm«, die mit und ohne URL-Parameter aufgerufen werden kann. Die Einträge für foo.cfm in cfcache.map sehen wie folgt aus: [foo.cfm] Mapping=C:\InetPub\wwwroot\dir1\CFCBD.tmp SourceTimeStamp=08/31/1999 08:59:04 AM

586

CFCACHE

[foo.cfm?x=5] Mapping=C:\InetPub\wwwroot\dir1\CFCBE.tmp SourceTimeStamp=08/31/1999 08:59:04 AM [foo.cfm?x=9] Mapping=C:\InetPub\wwwroot\dir1\CFCBF.tmp SourceTimeStamp=08/31/1999 08:59:04 AM

Die Datei cfcache.map in einem bestimmten Verzeichnis speichert nur Zuordnungen für dieses Verzeichnis. Sobald sich der Zeitstempel der zugrundeliegenden Seite ändert, aktualisiert ColdFusion die Cache-Datei für nur diesen URL. ColdFusion verwendet das Feld SourceTimeStamp, um festzustellen, ob die aktuell im Cache befindliche Datei aktuell ist oder neu aufgebaut werden muss. Der Cache kann wie folgt aktualisiert werden: 쐽

TIMEOUT-Attribut – ColdFusion vergleicht den Zeitstempel der Datei im Cache mit dem TIMEOUTAttribut. Ist der Zeitstempel älter als TIMEOUT, wird die alte Datei gelöscht und eine neue wird angelegt. Sie können gegebenenfalls feste Zeitangaben vornehmen, aber es ist besser, relative Zeitangaben zu verwenden. Dies ist die bevorzugte Technik und sie kann für Sekunden, Stunden, Tage, Wochen, Jahre usw. verwendet werden.

쐽

ACTION=FLUSH – Mit ACTION=FLUSH erzwingen Sie, dass die Dateien aus dem Cache entfernt werden. Dafür stehen zwei Attribute zur Verfügung, DIRECTORY und EXPIREURL.

쐽

Manuell – Manuelles oder programmgesteuertes (mit CFFILE) Löschen der .tmp-Dateien. Das ist nicht zu empfehlen.

Hinweise zu CFCACHE: 쐽

CFCACHE setzt voraus, dass die Anzahl der von ColdFusion Server ausgehenden »gleichzeitigen

Anforderungen« größer als 1 ist. Wird eine Cache-Datei erzeugt, benötigt die angeforderte Seite zwei Verbindungen, um die Anforderung erfüllen zu können. Wird eine Datei im Cache gefunden, ist nur eine Anforderung nötig. 쐽

Debugging-Einstellungen haben keine Auswirkung auf CFCACHE, es sei denn, die Template aktiviert sie explizit. Wenn eine Datei im Cache angelegt wird, verwendet CFCACHE .

쐽

ColdFusion stellt keine Seiten in den Cache, die von anderen als den URL-Parametern abhängig sind.

쐽

Um CFCACHE in Kombination mit Secure Sockets Layer (SSL) zu verwenden, geben Sie PROTOCOL="http://" an. Falls Sie SSL benötigen, sollten Sie den ColdFusion-Server als DesktopApplikation ausführen. Beachten Sie jedoch, dass Allaire dringend emfpiehlt, ColdFusion Server als Dienst auszuführen. Weitere Informationen zu SSL finden Sie im Artikel #1096 der Knowledge Base unter http://www.allaire.com/Support/KnowledgeBase/ SearchForm.cfm.

쐽

Falls eine Template aus irgendeinem Grund einen Fehler zurückgibt, wird die Fehlerseite in den Cache gestellt.

587

ColdFusion-Tags

Example – cfcache



CFCOLLECTION

CFCOLLECTION

591

ColdFusion-Tags



Beispiel für CFCONTENT

Beispiel für CFCONTENT

593

ColdFusion-Tags



CFCONTENT Example 2

Beispiel 2 für CFCONTENT

Dieses Beispiel zeigt, wie das Reset-Attribut die Ausgabe für Text ändert.

RESET = "Yes ": 123456

Dieses Beispiel zeigt, wie das Reset-Attribut die Ausgabe für Text ändert.

RESET = "No ": 123456

Der letzte AOL-Besucher auf dieser Site war #Cookie.LastAOLVisitor#, am #DateFormat(COOKIE.TimeVisited)#



Beispiel für CFDIRECTORY

Beispiel für CFDIRECTORY

599

ColdFusion-Tags





B.27 CFERROR Bietet die Möglichkeit, benutzerdefinierte HTML-Seiten anzuzeigen, wenn Fehler auftreten. Auf diese Weise realisieren Sie ein konsistentes Look&Feel für Ihre Applikation, selbst wenn Fehler auftreten.

Syntax

TYPE Zwingend erforderlich. Der Fehlertyp, den diese benutzerdefinierte Fehlerseite verarbeiten soll: 쐽

Geben Sie EXCEPTION an, wenn Ausnahmen verarbeitet werden sollen.

쐽

Geben Sie VALIDATION an, wenn Fehler verarbeitet werden sollen, die beim Übersenden eines Formulars für die Dateneingabe entstehen. Eine Verarbeitungsroutine für Validierungsfehler ist nur dann sinnvoll, wenn sie in der Datei Application.cfm platziert wird.

쐽

Geben Sie MONITOR an, um eine Ausnahmeüberwachung einzurichten.

쐽

Geben Sie REQUEST an, um Fehler zu verarbeiten, die während der Verarbeitung einer Seite auftreten. Der Standardwert ist REQUEST.

Weitere Informationen zu Variablen und anderen Konstrukten in Templates, mit denen die verschiedenen Fehlertypen verarbeitet werden können, finden Sie unter CFERROR-Fehlerseitenvariablen. TEMPLATE Zwingend erforderlich. Der relative Pfad zu der benutzerdefinierten Fehlerverarbeitungsseite. Die folgende Tabelle beschreibt die Templates, die für die verschiedenen Fehlertypen verwendet werden.

600

CFERROR

Fehlertyp

Entsprechende benutzerdefinierte Fehlerseite

Exception

Ein Template zur Ausnahmeverarbeitung, das vom CFML-Sprachprozessor dynamisch aufgerufen wird, wenn er eine nicht verarbeitete Ausnahmebedingung erkennt. Templates zur Ausnahmeverarbeitung können als Teil einer Applikation oder über das Tag l angegeben oder über den ColdFusion Administrator gesetzt werden. Ein Template für die Ausnahmeverarbeitung kann den vollen Umfang der CFML-Tags verwenden. Deshalb stellt es ein leistungsfähigeres Werkzeug als dar. Dieses Template verfügt außerdem über Zugriff auf die Fehlervariablen in der Tabelle unter CFERROR-Fehlerseitenvariablen.

Request

Dieses Template enthält nur die Fehlervariablen, die in der Tabelle unter CFERROR-Fehlerseitenvariablen beschrieben sind. Es darf keine CFML-Tags enthalten. Es ist praktisch für Backup-Fehlerverarbeitungsroutinen bei Sites mit hohen Anforderungen an die Benutzerschnittstelle.

Validation

Eine Verarbeitungsroutine für Validierungsfehler. Sie verarbeitet Fehler bei der Dateneingabevalidierung, die auftreten, wenn ein Formular übertragen wird. Sie ist nur dann sinnvoll, wenn sie in der Datei Application.cfm platziert wird.

Monitor

Ein Template für die Ausnahmeüberwachtung wird dynamisch durch den CFML-Sprachprozessor aufgerufen, wenn er erstmals eine Ausnahmebedingung erkennt, und zwar bevor er nach /- oder -Verarbeitungsroutinen für die Ausnahmeverarbeitung sucht.

MAILTO Optional. Die E-Mail-Adresse des Administrators, der im Fehlerfall benachrichtigt werden soll. Dieser Wert steht für Ihre benutzerdefinierte Fehlerseite zur Verfügung, die die Mail-To-Eigenschaft des Fehlerobjekts verwendet, wie beispielsweise #Error.MailTo#. EXCEPTION Erforderlich, wenn der Fehlertyp als Exception oder Monitor angegeben wurde. Der Typ der Ausnahme.

Verwendung Das CFERROR-Tag wird normalerweise verwendet, um die Fehlermeldungen für alle Seiten einer Applikation anzupassen. Deshalb trägt man es in der Regel in die Datei Application.cfm ein. Um sicherzustellen, dass die Fehlerseiten korrekt angezeigt werden, sollten die mit CFERROR festgelegten Seiten nicht mit dem Dienstprogramm cfencode verschlüsselt werden.

601

ColdFusion-Tags

CFERROR-Fehlervariablen Das im TEMPLATE-Attribut des CFERROR-Tags angegebene Template für die Fehlerverarbeitung kann ein oder mehr Fehlervariablen enthalten, die von ColdFusion ersetzt werden, wenn ein Fehler anezeigt wird.

Fehlervariablen für die Fehlertypen Request, Exception und Monitor Die folgenden Fehlervariablen stehen zur Verfügung, wenn in CFERROR eines der Attribute TYPE="Request", TYPE="Exception" oder TYPE="Monitor" angegeben ist: Variablen für die Fehlertypen Request, Exception und Monitor Fehlervariable

Beschreibung

Error.Diagnostics

Detaillierte Fehlerdiagnose vom ColdFusion-Server.

Error.MailTo

E-Mail-Adresse des Administrators, der benachrichtigt werden soll (entspricht dem im MAILTO-Attribut von CFERROR gesetzten Wert).

Error.DateTime

Datum und Uhrzeit, wann der Fehler aufgetreten ist.

Error.Browser

Browser, der ausgeführt wurde, als der Fehler aufgetreten ist.

Error.GeneratedContent

Der erzeugte Inhalt der fehlgeschlagenen Anforderung.

Error.RemoteAddress

IP-Adresse des Remote-Clients.

Error.HTTPReferer

Seite, von der aus der Client auf die Verknüpfung zu der Seite zugriff, in der der Fehler auftrat.

Error.Template

Seite, die ausgeführt wurde, als der Fehler auftrat.

Error.QueryString

URL-Abfragezeichenkette der Client-Anfrage.

Hinweis Falls Sie TYPE="Exception" oder TYPE="Monitor" angegeben haben, können Sie statt Error das Präfix CFERROR verwenden, wenn Sie diese Notationsform bevorzugen, beispielsweise CFERROR. Diagnostics, CFERROR.Mailto oder CFERROR.DateTime.

Benutzerdefinierte Fehlerseiten mit TYPE="Validation" Folgende Fehlervariablen stehen zur Verfügung, wenn CFERROR TYPE="Validation" verwendet wird:

602

CFERROR

Fehlervariable

Beschreibung

Error.ValidationHeader

Text für die Kopfzeile der Validierungsmeldung.

Error.InvalidFields

Unsortierte Liste von aufgetretenen Validierungsfehlern.

Error.ValidationFooter

Text für die Fußzeile der Validierungsmeldung.

Beispiel



B.28 CFEXECUTE Ermöglicht ColdFusion-Entwicklern, beliebige Prozesse auf der Server-Maschine auszuführen.

Syntax

...

NAME Zwingend erforderlich. Der vollständige Pfadname der auszuführenden Applikation. Hinweis: Auf Windows-Systemen müssen Sie die Dateinamenerweiterung als Teil des Applikationsnamens angeben, beispielsweise .exe. ARGUMENTS Optional. Beliebige Befehlszeilenargumente, die dem Programm übergeben werden sollen. Falls ARGUMENTS als Zeichenkette übergeben wird, wird es wie folgt verarbeitet: 쐽

Auf Windows-Systemen wird die gesamte Zeichenkette der Windows-Prozesssteuerung zur Syntaxanalyse übergeben.

쐽

Auf UNIX-Systemen wird die Zeichenkette in ein Datenfeld mit Argumenten zerlegt. Das Standardtrennzeichen für die einzelnen Token ist das Leerzeichen; Argumente mit eingebetteten Leerzeichen können durch Anführungszeichen voneinander abgetrennt werden.

Falls ARGUMENTS als Datenfeld übergeben wird, wird es wie folgt verarbeitet: 쐽

604

Auf Windows-Systemen werden die Elemente des Datenfelds zu einer Zeichenkette aus Token verknüpft, die durch Leerzeichen voneinander getrennt werden. Diese Zeichenkette wird dann der Windows-Prozesssteuerung übergeben, wie oben bereits beschrieben.

CFEXECUTE

쐽

Auf UNIX-Systemen werden die Elemente des Datenfelds ARGUMENTS in ein entsprechendes Datenfeld von exec() Argumenten kopiert.

OUTPUTFILE Optional. Die Datei, in die die Ausgabe des Programms umgeleitet werden soll. Wird keine Datei angegeben, erscheint die Ausgabe auf der Seite, von der aus sie angefordert wurde. TIMEOUT Optional. Gibt an, wie viele Sekunden der Ausführungs-Thread von ColdFusion auf den angestossenen Prozess wartet. Die Angabe eines Timeout-Werts von 0 ist gleichbedeutend mit dem nicht-blockierenden Ausführungsmodus. Der Standardwert ist 0; der ColdFusion-Thread stösst also einen Prozess an und kehrt sofort zurück, ohne auf die Abarbeitung des Prozesses zu warten. Falls keine Ausgabedatei angegeben wurde und der Timeout-Wert gleich 0 ist, wird die Ausgabe des Programms in den Bit-Originalspeicherbereich umgeleitet.

Verwendung CFEXECUTE steht auf Windows NT 4.0- und UNIX-Plattformen zur Verfügung. Fügen Sie zwischen die CFEXECUTE-Tags keine anderen ColdFusion-Tags oder -Funktionen ein. CFECEXUTE-Tags können nicht verschachtelt werden.

Ausnahmen CFEXECUTE fängt die folgenden Ausnahmen ab: 쐽

Falls der Applikationsname nicht gefunden wird, wird die Ausnahme »Application File Not Found« gemeldet.

쐽

Falls die Ausgabedatei nicht geöffnet werden kann, wird die Ausnahme »Output File Cannot be opened« gemeldet.

쐽

Falls der tatsächliche Benutzer des aktuell ausgeführten ColdFusion-Threads keine Berechtigung zur Ausführung des Prozesses besitzt, wird eine Sicherheitsausnahme gemeldet.

쐽

Die Timeout-Werte müssen zwischen 0 und einer beliebigen höheren Zahl liegen.

Beispiel

Beispiel für CFEXIT

Beispiel für CFEXIT

CFEXIT kann für den Abbruch der Verarbeitung des aktuell ausgeführten benutzerdefinierten CFML-Tags verwendet werden. Die Ausführung wird unmittelbar nach dem Aufruf des benutzerdefinierten Tags auf der Seite fortgesetzt, auf der das Tag aufgerufen wurde. Verwendung von CFEXIT

CFEXIT wird hauptsächlich verwendet, um einen bedingten Abbruch der Verarbeitung in einem benutzerdefinierten Tag vorzunehmen. CFEXIT gibt die Steuerung an die Seite zurück, die das benutzerdefinierte Tag aufgerufen hat, oder falls ein Tag von einem anderen Tag aufgerufen wurde, an das aufrufende Tag.

Falls CFEXIT außerhalb eines benutzerdefinierten Tags verwendet wird, verhält es sich wie CFABORT. Beispielsweise wird der Text nach diesem Tag nicht verarbeitet:

Dieser Text wird nicht ausgeführt, weil davor das CFEXIT-Tag steht.

B.30 CFFILE Mit dem CFILE-Tag können Sie die gesamte Interaktion mit Dateien abwickeln. Die mit CFILE verwendbaren Attribute sind von dem Wert des ACTION-Attributs abhängig. Ist z.B. ACTION = "Write", erwartet ColdFusion die Attribute, die man normalerweise mit dem Schreiben einer Textdatei in Verbindung bringt. Weitere Informationen dazu, welche Attribute für welche ACTIONs gelten, entnehmen Sie bitte den einzelnen CFFILE-Hilfethemen.

608

CFFILE

Hinweis Die im ColdFusion-Server vorgenommenen Einstellungen zur Basissicherheit verhindern möglicherweise, dass CFFILE ausgeführt wird. Diese Einstellungen werden im ColdFusion-Administrator auf der Seite BASISSICHERHEIT verwaltet. Damit das CFFILE-Tag verarbeitet werden kann, muss es auf der Administratorseite BASISSICHERHEIT aktiviert werden. Falls Sie ColdFusion-Anwendungen entwickeln, die für die Ausführung auf einem von mehreren Kunden genutzten Server ausgelegt sind, müssen Sie auf die Sicherheit der Dateien achten, die durch CFFILE hochgeladen oder auf andere Weise manipuliert werden könnten.

CFFILE-Hilfethemen 쐽

CFFILEACTION="Upload"

쐽

CFFILEACTION="Move"

쐽

CFFILEACTION="Rename"

쐽

CFFILEACTION="Copy"

쐽

CFFILEACTION="Delete"

쐽

CFFILEACTION="Read"

쐽

CFFILEACTION="ReadBinary"

쐽

CFFILEACTION="Write"

쐽

CFFILEACTION="Append"

CFFILE ACTION-Attribute Abhängig von dem Wert, den Sie dem ACTION-Attribut von CFFILE zuweisen, gibt es weitere untergeordnete Attribute, die Sie einstellen können. In der nachfolgenden Tabelle wird gezeigt, welche Attribute Sie mit jeder CFFILE-Aktion verwenden können. CFFILE ACTION

Attribute

Upload

ACCEPT DESTINATION FILEFIELD NAMECONFLICT MODE ATTRIBUTES

Move

SOURCE DESTINATION ATTRIBUTES

609

ColdFusion-Tags

CFFILE ACTION

Attribute

Rename

SOURCE DESTINATION ATTRIBUTES

Copy

SOURCE DESTINATION ATTRIBUTES

Delete

FILE

Read

FILE VARIABLE

ReadBinary

FILE VARIABLE

Write

OUTPUT FILE MODE ADDNEWLINE ATTRIBUTES

Append

OUTPUT FILE MODE ADDNEWLINE ATTRIBUTES

CFFILE ACTION="Upload" Verwenden Sie CFFILE mit der Upload-Aktion, um eine in einem Formularfeld angegebene Datei in ein Verzeichnis auf dem Web-Server hochzuladen.

Hinweis: Das MODE-Attribut gilt nur für ColdFusion unter Solaris und HP-UX




Syntax

610

CFFILE

FILEFIELD Zwingend erforderlich. Der Name des Formularfelds, das zum Auswählen der Datei verwendet wurde. Aber Vorsicht: Verwenden Sie keine Doppelkreuze (#) für die Angabe des Feldnamens. DESTINATION Zwingend erforderlich. Der vollständige Pfad zu dem Zielverzeichnis auf dem Web-Server, auf dem die Datei gespeichert werden soll. Beim Datei-Upload muss an das Zielverzeichnis ein abschließender Schrägstrich angefügt werden. Verwenden Sie dazu unter Windows den umgekehrten Schrägstrich (\) und unter UNIX den normalen Schrägstrich (/). Das Verzeichnis muss nicht unbedingt im Stammverzeichnis des Web-Server-Dokumentverzeichnisses liegen. NAMECONFLICT Optional. Der Standardwert ist Error. Gibt an, wie die Datei behandelt werden soll, wenn ein Namenskonflikt auftritt (es wurde ein Name für eine Datei angegeben, die bereits im Verzeichnis vorhanden ist). Erlaubte Einträge sind: 쐽

Error – Standardwert. Die Datei wird nicht gespeichert. ColdFusion bricht die Verarbeitung der Seite ab und gibt einen Fehler zurück.

쐽

Skip – Die Datei wird weder gespeichert, noch wird ein Fehler ausgegeben. Mit dieser Einstellung kann ein benutzerdefiniertes Verhalten basierend auf einer Prüfung der FILE-Eigenschaften zugelassen werden.

쐽

Overwrite – Ersetzt eine bereits existierende Datei, wenn sie denselben Namen wie das CFFILEZiel verwendet.

쐽

MakeUnique – Erzeugt automatisch einen eindeutigen Dateinamen für den Upload. Dieser Name wird in der FILE-Objektvariablen ServerFile gespeichert. Sie können diese Variable verwenden, um den Namen aufzuzeichnen, der beim Speichern der Datei verwendet wurde.

ACCEPT Optional. Verwenden Sie ACCEPT, um einzuschränken, welche Dateitypen akzeptiert werden. Geben Sie einen bzw. mehrere durch Kommas voneinander getrennte MIME-Typen der Dateitypen ein, die Sie akzeptieren möchten. Um z.B. Uploads von GIF- und Microsoft Word-Dateien zuzulassen, geben Sie folgendes ein: ACCEPT="image/gif, application/msword"

Beachten Sie, dass der Browser den Dateityp anhand der Dateinamenerweiterung bestimmt. MODE Optional. Definiert Berechtigungen für eine hochgeladene Datei unter Solaris oder HP-UX. Wird unter Windows ignoriert. Gültige Einträge entsprechen den Oktalwerten (nicht symbolisch) des UNIX-Befehls chmod. Berechtigungen werden für Eigentümer, Gruppe bzw. Alle anderen zugewiesen. Beispiel: MODE=644

weist dem Eigentümer Lese-/Schreibberechtigungen und Gruppe/Alle anderen Leseberechtigungen zu. MODE=666

611

ColdFusion-Tags

Weist Lese-/Schreibberechtigungen für Eigentümer, Gruppe und Alle anderen zu. MODE=777

Weist allen Benutzern Lese-, Schreib- und Ausführungsberechtigungen zu. ATTRIBUTES Optional. Eine Liste der durch Kommas voneinander getrennten Dateiattribute, die für die hochzuladende Datei gesetzt werden. Die folgenden Dateiattribute werden unterstützt: 쐽

ReadOnly

쐽

Temporary

쐽

Archive

쐽

Hidden (Versteckt)

쐽

System

쐽

Normal

Falls ATTRIBUTES nicht verwendet wird, werden die Attribute der Datei beibehalten. Werden Normal sowie ein beliebiges anderes Attribut angegeben, setzt dieses andere Attribut Normal außer Kraft. Einzelne Attribute müssen explizit angegeben werden. Wenn Sie beispielsweise nur das ReadOnlyAttribut angeben, werden alle anderen Attribute überschrieben.

Beispiel Mit dem folgenden Beispiel wird ein eindeutiger Dateiname erstellt, wenn beim Hochladen der Datei unter Windows ein Namenskonflikt auftritt:

Hinweis Unter Windows müssen Sie nach dem Zielverzeichnisnamen einen umgekehrten Schrägstrich (\) einfügen. Unter UNIX müssen Sie am Ende des Zielverzeichnisnamens einen normalen Schrägstrich (/) einfügen. In diesem Beispiel ist das Zielverzeichnis »uploads«.

Ergebnisse eines Datei-Uploads auswerten Nachdem ein Datei-Upload abgeschlossen ist, können Sie mit Hilfe von Datei-Upload-Parametern Statusinformationen abrufen. Diese Statusinformationen enthalten eine Vielzahl von Informationen über die Datei, z.B. den Namen der Datei und das Verzeichnis, in dem sie abgelegt wurde. Datei-

612

CFFILE

Upload-Parameter verwenden das Präfix »File«, z.B. File.ClientDirectory. Die Dateistatus-Parameter können Sie überall dort verwenden, wo auch die Verwendung anderer ColdFusion-Parameter zulässig ist. Nach einem Upload stehen die folgenden Datei-Upload-Statusparameter zur Verfügung. Parameter

Beschreibung

AttemptedServerFile

Name, unter dem ColdFusion als erstes versucht hat, die Datei zu speichern, z.B. MeineDatei.txt.

ClientDirectory

Verzeichnisposition der aus dem Client-System hochgeladenen Datei.

ClientFile

Name der Datei, die aus dem Client-System hochgeladen wurde.

ClientFileExt

Dateinamenerweiterungen der Upload-Datei auf dem Client-System ohne Punkt, z.B. txt, nicht .txt.

ClientFileName

Dateiname der Upload-Datei aus dem Client-System ohne Dateinamenerweiterung.

ContentSubType

Untergeordneter Typ des MIME-Inhalts der gespeicherten Datei.

ContentType

Typ des MIME-Inhalts der gespeicherten Datei.

DateLastAccessed

Datum und Uhrzeit des letzten Zugriffs auf die Upload-Datei.

FileExisted

Gibt an (Yes oder No), ob die Datei bereits mit dem gleichen Pfad vorhanden war.

FileSize

Größe der Upload-Datei.

FileWasAppended

Gibt an (Yes oder No), ob ColdFusion die Upload-Datei an eine bestehende Datei angefügt hat.

FileWasOverwritten

Gibt an (Yes oder No), ob ColdFusion eine Datei überschrieben hat.

FileWasRenamed

Gibt an (Yes oder No), ob die Upload-Datei umbenannt wurde, um einen Namenskonflikt zu vermeiden.

FileWasSaved

Gibt an (mit Yes oder No), ob ColdFusion eine Datei gespeichert hat.

OldFileSize

Größe einer Datei, die während des Datei-Uploads überschrieben wurde.

ServerDirectory

Verzeichnis der Datei, die tatsächlich auf dem Server gespeichert ist.

ServerFile

Dateiname der Datei, die tatsächlich auf dem Server gespeichert ist.

ServerFileExt

Dateinamenerweiterung der Upload-Datei auf dem Server ohne Punkt, z.B. txt, nicht .txt.

ServerFileName

Dateiname der Upload-Datei auf dem Server ohne Erweiterung.

TimeCreated

Zeitpunkt der Erstellung der Upload-Datei.

TimeLastModified

Datum und Uhrzeit der letzten Bearbeitung der Upload-Datei.

613

ColdFusion-Tags

Tipp Verwenden Sie das Präfix »File«, um auf die obengenannten Variablen zu verweisen. Beispiel: #File.FileExisted#.

Hinweis Datei-Statusvariablen sind schreibgeschützt. Sie werden auf die Ergebnisse des aktuellen CFFILE-Vorgangs gesetzt. (Wenn zwei CFFILE-Tags ausgeführt werden, setzt eine nachfolgende CFFILE-Operation die Ergebnisse der ersten Operation außer Kraft.)

UNIX-Beispiele In den folgenden drei Beispielen wird die Verwendung des MODE-Attributs unter UNIX demonstriert. Das erste Beispiel erstellt die Datei /tmp/foo mit den Berechtigungen rw-r-r-- (owner=read/write, group/other=read).

In diesem Beispiel wird Text an die vorgegebene Datei angehängt und Lese-/Schreibberechtigungen (rw) für alle gesetzt.

Das nächste Beispiel führt den Upload einer Datei durch und erteilt die Berechtigungen rwx-rw-rw (owner/group/other=read/write). CFFILE ACTION="Upload" FILEFIELD="Feldname" DESTINATION="/tmp/programm.exe" MODE=755>

CFFILE ACTION="Move" Diese CFFILE-Aktion kann verwendet werden, um eine Datei von einer Speicherposition auf dem Server zu einer anderen zu verschieben. Syntax

614

CFFILE

SOURCE Zwingend erforderlich. Der vollständige Pfad zu der zu verschiebenden Datei. DESTINATION Zwingend erforderlich. Der vollständige Pfad zu dem Verzeichnis, in das die Datei verschoben wird. Wenn Sie keinen Dateinamen angeben, muss beim Verschieben einer Datei ein Schrägstrich an das Ende des Zielverzeichnisses angehängt werden. Verwenden Sie dazu unter Windows den umgekehrten Schrägstrich (\) und unter UNIX den normalen Schrägstrich (/). ATTRIBUTES Optional. Eine Liste der durch Kommas voneinander getrennten Dateiattribute, die für die verschobene Datei gesetzt werden. Die folgenden Dateiattribute werden unterstützt: 쐽

ReadOnly

쐽

Temporary

쐽

Archive

쐽

Hidden (Versteckt)

쐽

System

쐽

Normal

Wird ATTRIBUTES nicht verwendet, werden die Attribute der Datei beibehalten. Werden »Normal« und ein beliebiges anderes Attribut angegeben, setzt dieses andere Attribut »Normal« außer Kraft. Einzelne Attribute müssen explizit angegeben werden. Wenn Sie beispielsweise nur das ReadOnlyAttribut angeben, werden alle anderen Attribute überschrieben.

Beispiel Das folgende Beispiel verschiebt unter Windows die Datei wichtigesMemo.doc vom Verzeichnis c:\dateien\upload\ in das Verzeichnis c:\dateien\memo\:

Hinweis Unter Windows müssen Sie, falls Sie keinen Dateinamen angeben, nach dem Zielverzeichnisnamen einen umgekehrten Schrägstrich (\) einfügen. In diesem Beispiel ist das angegebene Zielverzeichnis »memo«.

615

ColdFusion-Tags

CFFILE ACTION="Rename" Verwenden Sie CFFILE mit der Rename-Aktion, um eine Datei umzubenennen, die bereits auf dem Server vorhanden ist.

Syntax

SOURCE Zwingend erforderlich. Der vollständige Pfad zu der Datei, die umbenannt werden soll. DESTINATION Zwingend erforderlich. Der vollständige Pfad zu der Datei, einschließlich ihres neuen Namens. ATTRIBUTES Optional. Eine Liste der durch Kommas voneinander getrennten Dateiattribute, die für die umzubenennende Datei gesetzt werden. Die folgenden Dateiattribute werden unterstützt: 쐽

ReadOnly

쐽

Temporary

쐽

Archive

쐽

Hidden (Versteckt)

쐽

System

쐽

Normal

Falls ATTRIBUTES nicht verwendet wird, werden die Attribute der Datei beibehalten. Wenn Normal und ein beliebiges anderes Attribut angegeben werden, setzt dieses andere Attribut Normal außer Kraft. Einzelne Attribute müssen explizit angegeben werden. Wenn Sie beispielsweise nur das ReadOnlyAttribut angeben, werden alle anderen Attribute überschrieben.

Beispiel Das folgende Beispiel nennt die Datei wichtigesMemo.doc in altesMemo.doc um:

616

CFFILE

CFFILE ACTION="Copy" Das CFFILE-Tag kann zum Kopieren einer Datei von einem Verzeichnis auf dem Server in ein anderes verwendet werden.

Syntax

SOURCE Zwingend erforderlich. Der vollständige Pfad zu der Datei, die kopiert werden soll. DESTINATION Zwingend erforderlich. Der vollständige Pfad zu dem Zielverzeichnis, in dem die Kopie der Datei abgelegt werden soll. Falls Sie keinen Dateinamen angeben, müssen Sie nach dem Zielverzeichnisnamen einen Schrägstrich einfügen. Verwenden Sie dazu unter Windows einen umgekehrten Schrägstrich (\). Verwenden Sie unter UNIX den normalen Schrägstrich (/). ATTRIBUTES Optional. Eine Liste der durch Kommas voneinander getrennten Dateiattribute, die für die zu kopierenden Datei gesetzt werden. Die folgenden Dateiattribute werden unterstützt: 쐽

ReadOnly

쐽

Temporary

쐽

Archive

쐽

Hidden (Versteckt)

쐽

System

쐽

Normal

Falls ATTRIBUTES nicht verwendet wird, werden die Attribute der Datei beibehalten. Wenn Normal und ein beliebiges anderes Attribut angegeben werden, setzt dieses andere Attribut Normal außer Kraft. Einzelne Attribute müssen explizit angegeben werden. Wenn Sie beispielsweise nur das ReadOnlyAttribut angeben, werden alle anderen Attribute überschrieben.

Beispiel Das folgende Beispiel speichert eine Kopie der Datei wichtigesMemo.doc im Verzeichnis c:\dateien\backup\:

617

ColdFusion-Tags

Hinweis Unter Windows müssen Sie, falls Sie keinen Dateinamen angeben, nach dem Zielverzeichnisnamen einen umgekehrten Schrägstrich (\) einfügen. In diesem Beispiel ist das angegebene Zielverzeichnis »backup«.

CFFILE ACTION="Delete" Das CFFILE-Tag kann dazu verwendet werden, eine Datei auf dem Server zu löschen.

Syntax

FILE Zwingend erforderlich. Der vollständige Pfad zu der Datei, die gelöscht werden soll.

Beispiel Im folgenden Beispiel wird die angegebene Datei permanent gelöscht:

CFFILE ACTION="Read" Sie können das CFFILE-Tag dazu verwenden, eine existierende Textdatei zu lesen. Die Datei wird in einen dynamischen Parameter eingelesen, den Sie dann an einer beliebigen Stelle auf der Anwendungsseite verwenden können. Sie könnten z.B. eine Textdatei einlesen und ihren Inhalt in eine Datenbank einfügen. Oder Sie lesen eine Textdatei und ändern den Inhalt mit Hilfe von Suchen&Ersetzen.

Syntax

FILE Zwingend erforderlich. Der vollständige Pfad zu der Textdatei, die gelesen werden soll.

618

CFFILE

VARIABLE Zwingend erforderlich. Der Name der Variablen, die den Inhalt der Textdatei enthält, nachdem sie eingelesen wurde.

Beispiel Im folgenden Beispiel wird eine Variable mit der Bezeichnung Nachricht erstellt, die den Inhalt der Datei nachricht.txt enthält.

Die Variable Nachricht kann auf der Anwendungsseite verwendet werden. So können Sie z.B. den Inhalt der Datei Nachricht.txt auf der fertigen Web-Seite anzeigen: #Nachricht#

ColdFusion unterstützt verschiedene leistungsfähige Funktionen zur Veränderung des Inhalts von Textdateien. Außerdem können Sie eine von einem CFFILE="Read" erstellte Variable in ArrayToListund ListToArray-Funktionen verwenden. In den Abschnitten Zeichenkettenfunktionen und Datenfeldfunktionen finden Sie weitere Informationen über die Verwendung von Zeichenketten und Datenfeldern.

CFFILE ACTION="ReadBinary" Mit Hilfe des CFFILE-Tags können Sie eine existierende Binärdatei, wie beispielsweise eine ausführbare Datei oder eine Grafikdatei, einlesen. Die Datei wird in einen binären Objektparameter eingelesen, den Sie auf der Seite wie jeden anderen Parameter an beliebiger Stelle verwenden können. Falls Sie diese Datei mit Hilfe eines der Web-Protokolle wie HTTP oder SMTP übertragen oder in einer Datenbank ablegen wollen, sollten Sie sie zuerst in Base 64 konvertieren (siehe ToBase64).

Syntax

FILE Zwingend erforderlich. Der vollständige Pfad zu der Datei, die eingelesen werden soll. VARIABLE Zwingend erforderlich. Der Name der Variable, die den Inhalt der Binärdatei aufnehmen soll, nachdem diese eingelesen wurde.

619

ColdFusion-Tags

Beispiel Im folgenden Beispiel wird eine Variable mit der Bezeichnung einBinaerObj erstellt, die den Inhalt der ausführbaren Datei in ColdFusion Server enthält.

Anschließend können Sie die Binärdatei in Base 64 konvertieren, so dass Sie sie mit Hilfe von FTP zum Upload auf eine andere Site übertragen können.

CFFILE ACTION="Write" Sie können das CFFILE-Tag verwenden, um dynamischem Inhalt in eine Textdatei zu schreiben. Sie könnten beispielsweise statische HTML-Dateien oder Protokollaktionen in einer Textdatei erstellen.

Syntax

FILE Zwingend erforderlich. Der vollständige Pfad zu der Datei, die erzeugt werden soll. OUTPUT Zwingend erforderlich. Der Inhalt der zu erstellenden Datei. MODE Optional. Definiert Berechtigungen für eine Datei unter Solaris oder HP-UX. Wird unter Windows ignoriert. Gültige Einträge entsprechen den Oktalwerten (nicht symbolisch) des Unix-Befehls chmod. Berechtigungen werden für Eigentümer, Gruppe bzw. Alle anderen zugewiesen. Beispiel: MODE=644

weist dem Eigentümer Lese-/Schreibberechtigungen und Gruppe/Alle anderen Leseberechtigung zu. MODE=666

Weist Lese-/Schreibberechtigung für Eigentümer, Gruppe und Alle anderen zu. MODE=777

Weist allen Benutzern Lese-, Schreib- und Ausführungsberechtigung zu.

620

CFFILE

ADDNEWLINE Optional. Yes oder No. Wird dieses Attribut auf Yes gesetzt, wird dem Text, der in die Datei geschrieben wird, ein Neue-Zeile-Zeichen (NL) hinzugefügt. Wird dieses Attribut auf No gesetzt, wird dem Text kein Neue-Zeile-Zeichen (NL) hinzugefügt. Der voreingestellte Wert ist Yes. ATTRIBUTES Optional. Eine Liste der durch Kommas voneinander getrennten Dateiattribute, die für die zu schreibende Datei gesetzt werden. Die folgenden Dateiattribute werden unterstützt: 쐽

ReadOnly

쐽

Temporary

쐽

Archive

쐽

Hidden (Versteckt)

쐽

System

쐽

Normal

Wird ATTRIBUTES nicht verwendet, werden die Attribute der Datei beibehalten. Wenn »Normal« und ein beliebiges anderes Attribut angegeben werden, setzt dieses andere Attribut »Normal« außer Kraft. Einzelne Attribute müssen explizit angegeben werden. Wenn Sie beispielsweise nur das ReadOnlyAttribut angeben, werden alle anderen Attribute überschrieben.

Beispiel Im folgenden Beispiel wird eine Datei mit den Informationen erstellt, die ein Benutzer in ein HTML-Einfügeformular eingegeben hat:

Angenommen, ein Benutzer übermittelt ein Formular, in dem folgende Angaben stehen: AktualisierungsTitel="Messebesuch" VollerName="Gerry Blue" Datum="30.10.98" Inhalt="Wir hatten eine wunderbare Zeit in Heidelberg."

ColdFusion erstellt die Datei Messebesuch.txt im Verzeichnis c:\dateien\updates\. Die Datei enthält den folgenden Text: Erstellt von: Gerry Blue Datum: 30.10.98 Wir hatten eine wunderbare Zeit in Heidelberg.

In den folgenden Beispielen wird die Verwendung des MODE-Attributs unter UNIX demonstriert. Im ersten Beispiel wird die Datei /tmp/foo mit den Berechtigungen rw-r--r-- (owner=read/write, group/other=read) erstellt

621

ColdFusion-Tags

In diesem Beispiel wird Text an die angegebene Datei angehängt und Lese-/Schreibberechtigungen (rw) für alle gesetzt.

Das nächste Beispiel lädt eine Datei hoch und erteilt die Berechtigungen rwx-rw-rw (owner/group/ other=read/write). CFFILE ACTION="Upload" FILEFIELD="Feldname" DESTINATION="/tmp/programm.exe" MODE=755>

CFFILE ACTION="Append" Das CFFILE-Tag mit der Append-Aktion kann dazu verwendet werden, Text am Ende einer bereits existierenden Textdatei einzufügen. Dies ist beispielsweise praktisch beim Erstellen von Protokolldateien.

Syntax

FILE Zwingend erforderlich. Der vollständige Pfad zu der Datei, an die der Inhalt des OUTPUT-Attributs angehängt wird. OUTPUT Zwingend erforderlich. Die an die im DESTINATION-Attribut angegebene Datei anzufügende Zeichenkette. ADDNEWLINE Optional. Yes oder No. Wird dieses Attribut auf Yes gesetzt, wird an den Text, der in die Datei geschrieben wird, ein Neue-Zeile-Zeichen (NL) angefügt. Wird dieses Attribut auf No gesetzt, wird dem Text kein Neue-Zeile-Zeichen (NL) hinzugefügt. Der voreingestellte Wert ist Yes.

622

CFFORM

ATTRIBUTES Optional. Eine Liste der durch Kommas voneinander getrennten Dateiattribute, die für die anzufügende Datei gesetzt werden. Die folgenden Dateiattribute werden unterstützt: 쐽

ReadOnly

쐽

Temporary

쐽

Archive

쐽

Hidden (Versteckt)

쐽

System

쐽

Normal

Wird ATTRIBUTES nicht verwendet, werden die Attribute der Datei beibehalten. Wenn »Normal« und ein beliebiges anderes Attribut angegeben werden, setzt dieses andere Attribut »Normal« außer Kraft. Einzelne Attribute müssen explizit angegeben werden. Wenn Sie beispielsweise nur das ReadOnlyAttribut angeben, werden alle anderen Attribute überschrieben.

Beispiel Im folgenden Beispiel wird die Zeichenkette »Alle Jahre wieder ohne Ende« an die Datei urlaub.txt angefügt:

B.31 CFFORM CFFORM ermöglicht es Ihnen, ein Formular mit benutzerdefinierten CFML-Steuerelement-Tags zu

erstellen, die mehr Funktionen bieten als Standard-HTML-Formulareingabeelemente.

Hinweis CFFORM bedingt, dass der Client ein Java-Applet herunterlädt. Das ist zeitaufwendig, deshalb kann die Verwendung von CFFORM etwas langsamer als die Verwendung eines einfachen HTML-Formulars sein. Darüber hinaus müssen die Browser Java-fähig sein, damit CFFORM korrekt arbeitet.

Syntax

...

NAME Optional. Der Name für das Formular, das Sie erstellen. ACTION Zwingend erforderlich. Der Name der ColdFusion-Seite, die bei der Übertragung des Formulars zur Verarbeitung ausgeführt wird. ENABLECAB Optional. Yes oder No. Ermöglicht Benutzern, die Microsoft-Installationsdateien (*.cab) herunterzuladen, die die für Java-Applet-basierte CFFORM-Steuerelemente benötigten Java-Klassen enthalten. Ist der Parameter auf Yes gesetzt, werden die Benutzer beim Öffnen der Seite gefragt, ob sie die CABDatei herunterladen möchten. ONSUBMIT Optional. JavaScript-Funktion, die nach der Rückgabe einer Eingabe-Validierung auszuführen ist. Verwenden Sie dieses Attribut, um JavaScript für die Vorverarbeitung von Daten auszuführen, bevor das Formular übermittelt wird. TARGET Optional. Der Name des Fensters oder des Fensterrahmens, an das bzw. den die Formularausgabe gesendet wird. ENCTYPE Optional. Der verwendete MIME-Typ zum Verschlüsseln von Daten, die mit der Methode POST übertragen werden. Der voreingestellte Wert ist Application/x-www-form-urlencoded. Es wird empfohlen, den voreingestellten Wert zu übernehmen. Dieses Attribut wird zur Kompatibilität mit dem HTML FORM-Tag zur Verfügung gestellt. PASSTHROUGH Optional. HTML-Attribute, die nicht explizit von CFFORM unterstützt werden. Wenn Sie ein Attribut und seinen Wert angeben, werden Attribut und Wert dem HTML-Code übergeben, der für das CFINPUT-Tag erzeugt wird. Im Abschnitt zur Verwendung des Tags finden Sie weitere Informationen zur Angabe von Werten.

Verwendung Die folgenden benutzerdefinierten Steuer-Tags stehen zur Verfügung: 쐽

624

CFINPUT – Erstellt ein Formulareingabe-Steuerelement (Optionsfeld, Textfeld oder Kontrollkästchen) und ist in der Lage, Formulareingaben zu validieren.

CFFORM

쐽

CFSELECT – Erstellt ein Dropdown-Listenfeld.

쐽

CFSLIDER – Erstellt ein Schieberegler-Steuerelement.

쐽

CFTEXTINPUT – Erstellt ein Texteingabefeld.

쐽

CFTREE – Erstellt ein Verzeichnisstruktur-Steuerelement.

쐽

CFGRID – Erstellt ein Raster-Steuerelement zum Anzeigen von Tabellendaten in einem Cold-

Fusion-Formular. 쐽

CFAPPLET – Bettet ein registriertes Java-Applet in ein ColdFusion-Formular ein. Applets werden

im ColdFusion-Administrator registriert. Mit Hilfe des PASSTHROUGH-Attributs können Sie Standardattribute und dynamische Attribute des HTML FORM-Tags und ihre Werte in das CFFORM-Tag einfügen. Diese Attribute und ihre Werte werden beim Erstellen eines Formulars über ColdFusion direkt dem Browser übergeben. Wenn Sie einen Wert in Anführungszeichen angeben, müssen Sie die Anführungszeichen maskieren, indem Sie sie verdoppeln. Beispiel: PASSTHROUGH= "readonly= " "YES " " "

Das ENABLECAB-Attribut wird nur von MS Internet Explorer-Clients unterstützt, auf denen Authenticode 2.0 installiert ist. Authenticode 2.0 kann von der Website http://www.microsoft.com/ie/ security/authent2.htm. heruntergeladen werden.

Hinweis Um die Dateisicherheit zu garantieren, werden CAB-Dateien mit Hilfe der IDs von VeriSign digital gekennzeichnet.

Verwendung von HTML FORM-Tags in einem CFFORM Mit CFFORM können Sie Ihre Formulare auch mit standardisiertem HTML-Code ergänzen. Es gibt zwei Möglichkeiten: 쐽

Sie können dem FORM-Tag standardisierte FORM-Tag-Attribute und deren Werte hinzufügen. Diese Attribute und Werte werden beim Erstellen eines Formulars über ColdFusion direkt dem Browser übergeben. Sie können z.B. FORM-Tag-Attribute wie TARGET verwenden, um Ihre CFFORMLeistungsmerkmale zu erweitern.

쐽

Darüber hinaus können HTML-Tags, die im allgemeinen in einem HTML FORM-Tag platziert werden, auch zwischen und -Tags platziert werden.

Sie verwenden beispielsweise ein Standard-HTML-INPUT-Tag, um die Schaltfläche AKTUALISIEREN in einem CFFORM zu erstellen:





B.33 CFGRID Wenn CFGRID innerhalb von CFFORM verwendet wird, kann damit ein Raster-Steuerelement in einem ColdFusion-Formular angelegt werden. Ein Raster-Steuerelement ist eine Tabelle mit Daten, die in Zeilen und Spalten gegliedert ist. CFGRID-Spaltendaten werden mit einzelnen CFGRIDCOLUMN-Tags erstellt. Weitere Informationen finden Sie in der Beschreibung der CFGRIDROW- und CFGRIDUPDATE-Tags.

Syntax

NAME Zwingend erforderlich. Ein Name für das Rasterelement.

638

CFGRID

HEIGHT Optional. Höhe des Raster-Steuerelements in Pixel. WIDTH Optional. Breite des Raster-Steuerelements in Pixel. VSPACE Optional. Vertikaler Randabstand über und unter dem Raster-Steuerelement in Pixel. HSPACE Optional. Horizontaler Randabstand links und rechts vom Raster-Steuerelement in Pixel. ALIGN Optional. Wert für die Ausrichtung. Gültige Einträge sind: Top, Left, Bottom, Baseline, Texttop, Absbottom, Middle, Absmiddle, Right. QUERY Optional. Der Name der Abfrage, die mit dem Raster-Steuerelement verknüpft ist. INSERT Optional. Yes oder No. Bei Yes können Endbenutzer neue Zeilendaten in das Raster einfügen. Standardwert No. DELETE Optional. Yes oder No. Bei Yes können Endbenutzer Zeilendaten im Raster löschen. Standardwert No. SORT Optional. Yes oder No. Bei Yes werden dem Raster-Steuerelement Sortierschaltflächen hinzugefügt. Werden diese Schaltflächen angeklickt, erfolgt eine einfache Textsortierung in der ausgewählten Spalte. Standardwert No. FONT Optional. Name der Schriftart, die für alle Spaltendaten im Raster-Steuerelement verwendet wird. FONTSIZE Optional. Schriftgrad für den Text im Raster-Steuerelement. Der Wert wird in Punkten angegeben. ITALIC Optional. Yes oder No. Yes stellt den gesamten Text des Raster-Steuerelements kursiv dar. Standardwert No. BOLD Optional. Yes oder No. Yes stellt den gesamten Text des Raster-Steuerelements fettgedruckt dar. Standardwert No.

639

ColdFusion-Tags

HREF Optional. URL, der mit dem Rasterelement oder einer Abfragespalte für ein Raster verknüpft werden soll, das aus einer Abfrage aufgefüllt wird. Falls HREF eine Abfragespalte ist, wird der angezeigte HREFWert von der Abfrage aufgefüllt. Falls HREF nicht als Abfragespalte erkannt wird, wird angenommen, dass der HREF-Text ein aktuelles HTML-HREF-Tag ist. HREFKEY Optional. Der Name einer gültigen Abfragespalte, falls das Raster eine Abfrage verwendet. Die angegebene Spalte wird zum Schlüssel, unabhängig davon, welcher Auswahlmodus für das Raster verwendet wird. TARGET Optional. Zielattribut für HREF-URL. APPENDKEY Optional. Yes oder No. In Verbindung mit HREF übergibt Yes die CFGRIDKEY-Variable zusammen mit dem Wert des ausgewählten Verzeichnisstrukturelements in dem URL an die Anwendungsseite, die im CFFORM ACTION-Attribut festgelegt ist. Standardwert Yes. HIGHLIGHTHREF Optional. Yes markiert Hyperlinks, die mit einem CFGRID verknüpft sind, mit einem HREF-Attributwert. No deaktiviert das Markieren. Standardwert Yes. ONVALIDATE Optional. Der Name einer gültigen JavaScript-Funktion, die für die Auswertung der Benutzereingabe verwendet wird. Das Formularobjekt, Eingabeobjekt und der Eingabeobjektwert werden an die angegebene Routine übergeben, die wahr zurückgibt, falls die Auswertung erfolgreich ist, und andernfalls falsch. ONERROR Optional. Der Name einer gültigen JavaScript-Funktion, die im Falle einer fehlgeschlagenen Auswertung ausgeführt werden soll. GRIDDATAALIGN Optional. Legt die Ausrichtung der Spalten im Raster mit Left, Right oder Center fest. Standardwert Left. GRIDLINES Optional. Yes oder No. Yes aktiviert eine Linie im Raster-Steuerelement, No unterdrückt Zeilen- und Spaltenlineale. Standardwert Yes. ROWHEIGHT Optional. Gibt die die Anzahl der Pixel für die Mindestzeilenhöhe für das Raster-Steuerelement an. In Kombination mit CFGRIDCOLUMN TYPE="Image" können Sie ROWHEIGHT dazu verwenden, ausreichend Platz für Grafiken einzuplanen, die in der Zeile erscheinen sollen.

640

CFGRID

ROWHEADER Optional. Yes oder No. Yes zeigt Zeilenbeschriftungen im Raster-Steuerelement an. Standardwert Yes. ROWHEADERALIGN Optional. Legt die Ausrichtung der Daten in einer Spaltenkopfzeile als Left, Right oder Center fest. Standardwert Left. ROWHEADERFONT Optional. Schriftart für die Zeilenbeschriftung. ROWHEADERFONTSIZE Optional. Schriftgrad für den Text der Zeilenbeschriftung im Raster-Steuerelement in Punkten. ROWHEADERITALIC Optional. Yes oder No. Yes stellt den Text der Zeilenbeschriftung kursiv dar. Standardwert No. ROWHEADERBOLD Optional. Yes oder No. Yes stellt den Text der Zeilenbeschriftung fettgedruckt dar. Standardwert No. ROWHEADERWIDTH Optional. Die Breite der Kopfzeilenspalte für die Zeilen in Pixel. COLHEADERS Optional. Yes oder No. Yes zeigt Spaltenkopfzeilen im Raster-Steuerelement an. Standardwert Yes. COLHEADERALIGN Optional. Legt die Ausrichtung der Daten in der Spaltenkopfzeile mit Left, Right oder Center fest. Standardwert Left. COLHEADERFONT Optional. Schriftart für die Spaltenkopfzeile im Raster-Steuerelement. COLHEADERFONTSIZE Optional. Größe der Schriftart für den Text der Spaltenkopfzeile im Raster-Steuerelement in Punkten. COLHEADERITALIC Optional. Yes oder No. Yes stellt den Text der Spaltenkopfzeile kursiv dar. Standardwert No. COLHEADERBOLD Optional. Yes oder No. Yes stellt den Text der Spaltenkopfzeile fettgedruckt dar. Standardwert No. BGCOLOR Optional. Wert für die Hintergrundfarbe des Raster-Steuerelements. Gültige Einträge sind: black, magenta, cyan, orange, darkgray, pink, gray, white, lightgray, yellow.

641

ColdFusion-Tags

Ein hexadezimaler Wert wird im folgenden Format eingegeben: BGCOLOR="##xxxxxx" 

steht für 0-9 oder A-F. Verwenden Sie entweder zweimal das Doppelkreuz oder kein Doppelkreuz.

SELECTCOLOR Optional. Hintergrundfarbe für ein ausgewähltes Element. Farboptionen siehe BGCOLOR. SELECTMODE Optional. Auswahlmodus für Elemente im Raster-Steuerelement. Gültige Einträge sind: 쐽

Edit – Benutzer können Rasterdaten bearbeiten.

쐽

Single – Benutzerauswahl ist auf die ausgewählte Zelle beschränkt.

쐽

Row – Benutzerauswahl wird automatisch auf die Zeile erweitert, die die ausgewählte Zelle enthält.

쐽

Column – Benutzerauswahl wird automatisch auf die Spalte erweitert, die die ausgewählte Zelle enthält.

쐽

Browse – Benutzer können Rasterdaten nur anzeigen.

Der Standardwert ist Browse. MAXROWS Optional. Gibt die Höchstzahl an Zeilen an, die Sie im Raster anzeigen möchten. NOTSUPPORTED Optional. Der anzuzeigende Text, wenn die Seite mit einem Java-Applet-basierten CFFORM-Steuerelement von einem Browser geöffnet wird, der Java nicht unterstützt oder dessen Java-Unterstützung deaktiviert ist. Beispiel: NOTSUPPORTED=" Der Browser muß Java unterstützen, um ColdFusion-Java-Applets anzeigen zu können."

Standardmäßig wird folgende Meldung angezeigt, wenn keine benutzerdefinierte Meldung angegeben ist: Der Browser muß Java unterstützen,
um ColdFusion-Java-Applets anzeigen zu können!

PICTUREBAR Optional. Yes oder No. Bei Yes werden für die Aktionen Einfügen, Löschen und Sortieren Bildschaltflächen anstelle von Textschaltflächen verwendet. Standardwert No. INSERTBUTTON Optional. Text für die Aktionsschaltfläche EINFÜGEN. Standardwert Einfügen. DELETEBUTTON Optional. Text für die Aktionsschaltfläche LÖSCHEN. Standardwert Löschen.

642

CFGRID

SORTASCENDINGBUTTON Optional. Text für die Schaltfläche SORTIEREN. Standardwert »A -> Z«. SORTDESCENDINGBUTTON Optional. Text für die Schaltfläche SORTIEREN. Standardwert »Z



B.47 CFLDAP CFLDAP stellt eine Schnittstelle zu LDAP-Verzeichnisservern (LDAP = Lightweight Directory Access Protocol) zur Verfügung, wie beispielsweise zum Netscape Directory Server.

Syntax

SERVER Zwingend erforderlich. Host-Name (»biff.upperlip.de«) oder IP-Adresse (»192.1.2.225«) des LDAPServers.

679

ColdFusion-Tags

PORT Optional. Standardmäßiger Port ist der LDAP-Port 389. USERNAME Optional. Wenn kein Benutzername angegeben wird, ist die LDAP-Verbindung anonym. PASSWORD Optional. Kennwort für den Benutzernamen. ACTION Optional. Kennzeichnet die LDAP-Aktion. Es gibt fünf mögliche Werte: 쐽

Query – (Standard) Gibt ausschließlich LDAP-Eintragsinformationen zurück. Setzt die Attribute NAME, START, ATTRIBUTES voraus. Weitere Informationen finden Sie im Abschnitt zur Verwendung dieses Tags.

쐽

Add – Fügt dem LDAP-Server LDAP-Einträge hinzu. Setzt ATTRIBUTES voraus.

쐽

Modify – Ändert LDAP-Eingaben auf einem LDAP-Server mit Ausnahme des Attributs für den charakteristischen Namen (»DN«). Setzt DN und ATTRIBUTES voraus. Zusätzliche Steuerungsmöglichkeiten bietet das MODIFYTYPE-Attribut, das weiter unten beschrieben wird.

쐽

ModifyDN – Ändert das DN-Attribut für LDAP-Einträge auf einem LDAP-Server. Setzt DN und ATTRIBUTES voraus.

쐽

Delete – Löscht LDAP-Eingaben auf dem LDAP-Server. Setzt DN voraus.

NAME Zwingend erforderlich für ACTION="Query". Der Name, den Sie der LDAP-Abfrage zuweisen. TIMEOUT Optional. Gibt die maximale Zeit in Sekunden an, die für die LDAP-Bearbeitung benötigt wird. Der Standardwert beträgt 60 Sekunden. MAXROWS Optional. Gibt die maximale Anzahl an Eingaben für LDAP-Abfragen an. START Zwingend erforderlich für ACTION="Query". Gibt den charakteristischen Namen (»DN«) des Eintrags an, der für den Start der Suche verwendet werden soll. SCOPE Optional. Gibt den Gültigkeitsbereich der Suche aus der Eingabe an, die im Start-Attribut für ACTION="Query" festgelegt ist. Es gibt drei mögliche Werte: 쐽

OneLevel – (Standard) Durchsucht alle Einträge auf genau einer Ebene unterhalb des Eintrags, der im START-Attribut festgelegt ist.

쐽

Base – Durchsucht ausschließlich die im START-Attribut angegebene Eingabe.

680

CFLDAP

쐽

Subtree – Durchsucht den im START-Attribut festgelegten Eintrag sowie alle Einträge in allen Ebenen darunter.

ATTRIBUTES Zwingend erforderlich für ACTION="Query", "Add", "ModifyDN" und "Modify". Legt bei Abfragen die CSV-Liste der Attribute fest, die für Abfragen zurückgegeben werden soll. Für Abfragen können Sie auch das Platzhalterzeichen »*« verwenden, um alle mit dem Eintrag verknüpften Attribute zu erhalten. Darüber hinaus kann es verwendet werden, um die Liste der zu aktualisierenden Spalten für ACTION="Add" oder ACTION="Modify" anzugeben. Trennen Sie mehrere Attribute durch Semikolons, wenn sie für ACTION="Add" und ACTION="Modify" verwendet werden. Wenn Attribute für ACTION="ModifyDN" verwendet werden, leitet sie ColdFusion an den LDAP-Server ohne Syntaxüberprüfung weiter. FILTER Optional. Legt die Suchkriterien für ACTION="Query" fest. Auf Attribute wird im Formular verwiesen: »(Attribut Operator Wert)«. Beispiel: »(sn=Schmidt)«. Die Standardeinstellung ist »objectclass=*«. Wenn Sie auch das FILTERFILE-Attribut angeben, wird der Filter nicht als Filter, sondern als Suchzeichenkette betrachtet. FILTERFILE Optional. Damit legen Sie den Namen einer Filterdatei und den Namen des Strophen-Tags innerhalb dieser Datei fest, das die Spezifikation für den LDAP-Filterstring enthält. Sie können zur Identifikation der Datei entweder einen absoluten Pfadnamen oder einen einfachen Dateinamen angeben. Wenn Sie einen einfachen Dateinamen verwenden, sucht CFLDAP im LDAP-Standardverzeichnis von ColdFusion nach diesem Namen. Das LDAP-Standardverzeichnis ist C:\cfusion\ldap. Die Filterdatei muss das LDAP-Filterdateiformat aufweisen, wie es in RCF-1558 definiert ist. SORT Optional. Kennzeichnet das Attribut oder die Attribute, nach dem/denen Abfrageergebnisse sortiert werden. Trennen Sie bei Angabe mehrerer Attribute die einzelnen Attribute durch Kommas. SORTCONTROL Optional. Hiermit legen Sie fest, wie Abfrageergebnisse sortiert werden sollen. Geben Sie »nocase« ein, wenn beim Sortieren die Groß-/Kleinschreibung nicht berücksichtigt werden soll. In der Voreinstellung wird bei Sortiervorgängen die Groß-/Kleinschreibung beachtet. Sie können auch mit »asc« eine aufsteigende Sortierreihenfolge und mit »desc« eine absteigende Sortierreihenfolge festlegen. Sie können aber auch eine Kombination aus diesen Einstellungen wählen, beispielsweise »nocase« zusammen mit »asc«. Die voreingestellte Sortierreihenfolge ist aufsteigend. DN Zwingend erforderlich für ACTION="Add", "Modify", "ModifyDN" und "Delete". Legt den charakteristischen Namen (»DN«) für Aktualisierungsaktionen fest. Beispiel: »cn=Barbara Jensen, o=Herbertz GmbH, c=DE«.

681

ColdFusion-Tags

STARTROW Optional. Wird in Verbindung mit ACTION="Query" verwendet. Gibt die erste Zeile der LDAP-Abfrage an, die in die ColdFusion-Abfrage eingefügt werden soll. Die Voreinstellung ist 1. Weitere Informationen zur Verwendung des Tags finden Sie im Abschnitt zu Abfrageobjekten und Abfragevariablen. MODIFYTYPE Optional. Hiermit geben Sie an, ob ein Attribut innerhalb einer Attributliste mit mehreren Werten hinzugefügt, gelöscht oder ersetzt werden soll: 쐽

Add – Das neue Attribut wird an vorhandene Attribute angehängt.

쐽

Delete – Das angegebene Attribut wird aus der Gruppe der vorhandenen Attribute gelöscht.

쐽

Replace (Voreinstellung) – Ein vorhandenes Attribut wird durch das angegebene Attribut (oder die angegebenen Attribute) ersetzt.

Beachten Sie, dass Sie bereits vorhandene Attribute oder Attribute, die eine leere Zeichenkette als Wert haben, nicht hinzufügen können. REBIND Optional. Yes oder No. Wenn Sie REBIND auf Yes setzen, versucht CFLDAP, den an den Client zurückgegebenen Verweis auf einen anderen Server (Referral) zu verfolgen, indem es das Callback-Objekt neu bindet und die Suchanfrage über die Adresse, auf die verwiesen wird, erneut stellt. Bei dieser neuen Anfrage verwendet CFLDAP die ursprünglichen Login-Identifikationsdaten. Die Voreinstellung ist No. Dies bedeutet, dass die auf andere Server weiterverwiesenen Client-Verbindungen anonym sind. REFERRAL Optional. Legt die Anzahl der Hops fest, die beim Weiterverweisen auf andere Server (Referral) zulässig sind. Gültige Werte sind ganze Zahlen größer oder gleich Null. Wenn Sie den Wert Null angeben, blockieren Sie damit die Fähigkeit von CFLDAP, Verweisadressen zu nutzen. In diesem Fall werden auch keine Daten zurückgegeben. SECURE Optional. Gibt an, welcher der beiden Sicherheitstypen – CFSSL_BASIC oder CFSSL_CLIENT_AUTH – benutzt werden soll, und stellt zusätzliche Informationen bereit, die vom angegebenen Sicherheitstyp benötigt werden. SECURE="CFSSL_BASIC,certificate_db"

oder SECURE="CFSSL_CLIENT_AUTH,certificate_db,certificate_name, key_db,key_password"

Diese Felder haben die folgenden Werte: certificate_db: Der Name der Datenbankdatei, in der die Zertifikatinformationen abgelegt sind (in Netscape Format cert7.db). Sie können zur Identifikation der Datei entweder einen absoluten Pfadnamen oder einen einfachen Dateinamen angeben. certificate_name: Der Name des Client-Zertifikats, das an den Server übertragen werden soll.

682

CFLDAP

key_db: Schlüsseldatenbank, in der das Paar aus öffentlichem/privatem Schlüssel abgelegt ist (in Netscape Format key3.db). Sie können zur Identifikation der Datenbank entweder einen absoluten Pfadnamen oder einen einfachen Dateinamen angeben. keyword_db: Das Kennwort für den Zugriff auf die Schlüsseldatenbank. Wenn Sie für certificate_db oder keyword_db einen einfachen Dateinamen verwenden, sucht CFLDAP nach dieser Datei im LDAP-Standardverzeichnis von ColdFusion. Das LDAP-Standardverzeichnis ist C:\cfusion\ldap. Weitere Informationen über die Unterschiede zwischen den beiden Sicherheitstypen CFSSL_BASIC und CFSSL_CLIENT_AUTH finden Sie im Abschnitt zur Verwendung. SEPARATOR Optional. Legt das Trennzeichen fest, das CFLDAP benutzt, um die einzelnen Attributwerte in Attributen mit mehreren Werten gegeneinander abzugrenzen. Dieses Trennzeichen wird von den Aktionsattributen QUERY, ADD und MODIFY benutzt, und dient CFLDAP zur Ausgabe von Attributen mit mehreren Werten. Die Voreinstellung für dieses Zeichen ist das Komma (,).

Verwendung Wenn Sie das Aktionsattribut QUERY verwenden, erzeugt CFLDAP ein Abfrageobjekt, das Ihnen den Zugriff auf die Informationen in den drei Abfragevariablen erlaubt, die in der folgenden Tabelle beschrieben sind. CFLDAP-Abfragevariable

Beschreibung

Abfragename.RecordCount

Die Gesamtzahl der Datensätze, die von der Abfrage ausgegeben werden.

Abfragename.CurrentRow

Die aktuelle Zeile der Abfrage, die von CFOUTPUT verarbeitet wird.

Abfragename.ColumnList

Die Liste der Spaltennamen in der Abfrage.

Der Sicherheitstyp CFSSL_BASIC stellt V2 SSL bereit, und der Sicherheitstyp CFSSL_CLIENT_AUTH unterstützt V3 SSL. V2 SSL bietet Verschlüsselung und Server-Authentifizierung. V3 SSL bietet zusätzlich noch eine zertifikatbasierende Client-Authentifizierung. Beide Sicherheitsformen verschlüsseln die Kommunikation zwischen Client und Server, und der Server überträgt stets ein digitales Zertifikat, um zu bestätigen, dass er der richtige Server ist. Für CFSSL_BASIC müssen Sie auch die CFLDAP-Attribute USERNAME und PASSWORD angeben, um sich selbst zu authentifizieren. V2 verschlüsselt dann das Kennwort vor der Übertragung. Für CFSSL_CLIENT_AUTH schicken Sie keinen Benutzernamen und kein Kennwort. Statt dessen führen Sie die Authentifizierung anhand eines digitalen Zertifikats durch, das Sie an den Server übertragen. Obwohl CFSSL_CLIENT_AUTH eine viel höhere Sicherheit bietet, ist dieses Sicherheitsverfahren schwierig zu verwalten, da alle Clients Zertifikate benötigen und der Server in der Lage sein muss, diese zu überprüfen. Zudem müssen mit allen Zertifikaten Schlüssel verknüpft sein, und diese Schlüssel müssen durch Kennwörter geschützt werden.

683

ColdFusion-Tags

Beispiel





Beispiel für CFLOCATION

Beispiel für CFLOCATION

CFLOCATION leitet den Browser zu einer bestimmten Web-Ressource um. Normalerweise wird dieses Tag dazu verwendet, um zu einer anderen CF-Vorlage oder zu einer HTML-Datei auf demselben Server zu gelangen. Mit dem ADDTOKEN-Attribut können Sie Clientinformationen an die Zielseite senden.

Mit dem folgenden Beispielcode gelangen Sie zurück zur CFDOCS-Homepage (wenn Sie die Kommentarzeichen entfernen, werden diese Informationen im Frame angezeigt):

685

ColdFusion-Tags



TIMEOUT Zwingend erforderlich. Legt fest, wie viele Sekunden maximal auf eine exklusive Sperre gewartet wird. Wird innerhalb des angegebenen Zeitraums eine exklusive Sperre erteilt, wird die Ausführung innerhalb des Tag-Blocks fortgesetzt. Andernfalls wird die weitere Vorgehensweise vom Wert des THROWONTIMEOUT-Attributs bestimmt.

686

CFLOCK

SCOPE Optional. Legt für den Gültigkeitsbereich eine der folgenden Einstellungen fest: Application, Server, oder Session. Dieses Attribut und das NAME-Attribut schließen sich gegenseitig aus. Im Abschnitt Scope finden Sie ausführliche Informationen. NAME Optional. Gibt den Namen der Sperre an. In einem CFLOCK-Tag mit einem bestimmten Namen kann jeweils nur eine Anfrage ausgeführt werden. Deshalb kann durch die Angabe des NAME-Attributs der Zugriff auf dieselben Ressourcen von unterschiedlichen Teilen einer Anwendung heraus synchronisiert werden. Die Namen von Sperren gelten global auf einem ColdFusion-Server. Sie werden von Anwendungen und Benutzersitzungen jedoch nicht auf mehreren Servern in einer Gruppe (sogenannten Clustern) verwendet. Dieses Attribut und das SCOPE-Attribut schließen sich gegenseitig aus. Geben Sie deshalb das SCOPE-Attribut nicht zusammen mit dem NAME-Attribut im gleichen Tag an. Beachten Sie, dass der Wert des NAME-Attributs keine leere Zeichenkette sein darf. THROWONTIMEOUT Optional. Yes oder No. Legt fest, wie Timeout-Bedingungen abgewickelt werden. Bei Yes wird eine Ausnahme erstellt, die über das Timeout benachrichtigt. Bei No wird die Ausführung nach dem -Tag fortgesetzt. Standardwert Yes. TYPE Optional. ReadOnly oder Exclusive. Gibt die Art der Sperre an: Read-only-Sperre (nur Leseberechtigung) oder exklusive Sperre. Die Voreinstellung ist Exclusive. Bei einer Read-only-Sperre können mehrere Abfragen gemeinsam genutzte Daten gleichzeitig lesen. Eine exklusive Sperre erlaubt nur jeweils einer einzigen Abfrage den Lese- oder Schreibzugriff auf gemeinsam genutzte Daten (siehe folgenden Hinweis).

Hinweis Begrenzen Sie den Gültigkeitsbereich von Code, der gemeinsam genutzte Daten aktualisiert. Exklusive Sperren sind erforderlich, um die Datenintegrität dieser Aktualisierungen sicherzustellen. Sie haben jedoch einen großen Einfluß auf die Systemleistung. Bei Read-only-Sperren ist der Durchsatz höher. Bei für die Systemleistung kritischen Anwendungen sollten Sie exklusive Sperren durch Readonly-Sperren ersetzen, wo immer dies möglich ist, beispielsweise beim Lesen gemeinsam genutzter Daten.

Verwendung ColdFusion-Server ist ein Multi-Thread-Web-Applikations-Server, der mehrere Seitenanfragen gleichzeitig verarbeiten kann. Verwenden Sie CFLOCK, um sicherzustellen, dass mehrere gleichzeitig ausgeführte Anfragen nicht gemeinsam genutzte Datenstrukturen, Dateien oder CFX auf inkonsistente Weise verändern. Beachten Sie folgendes: 쐽

Durch die Verwendung von CFLOCK bei CFML-Konstrukten, die gemeinsam genutzte Daten ändern, stellen Sie sicher, dass die Änderungen nacheinander und nicht alle gleichzeitig vorgenommen werden.

687

ColdFusion-Tags

쐽

Die Verwendung von CFLOCK mit Konstrukten zur Dateiänderung sorgt dafür, dass die Aktualisierung von Dateien, die von anderen Anwendungen oder ColdFusion-Tags geöffnet sind, nicht fehlschlägt.

쐽

Wenn Sie CFLOCK bei CFX-Aufrufen verwenden, können nicht Thread-sicher implementierte CFX von ColdFusion sicher aufgerufen werden. Dies gilt normalerweise nur für CFX, die mit C++ unter Verwendung von CFAPI entwickelt wurden. Alle mit C++ entwickelten CFX, die gemeinsam genutzte (globale) Datenstrukturen enthalten und ändern, müssen Thread-sicher sein, um problemlos mit ColdFusion verwendet werden zu können. Für das Schreiben von Thread-sicheren CFX mit C++ ist allerdings ein fundiertes Wissen erforderlich. Das CFX kann mit einem benutzerdefinierten CFML-Tag-Wrapper Thread-sicher gemacht werden.

Gültigkeitsbereich Verwenden Sie das SCOPE-Attribut immer dann, wenn Sie Variablen in einem der gemeinsam genutzten Gültigkeitsbereiche anzeigen, setzen oder aktualisieren. Zum Setzen des Gültigkeitsbereichs stehen Ihnen die drei Optionen Server, Application und Session zur Verfügung. Im ColdFusion Administrator können Sie im Abschnitt SERVER auf der Seite SPERRUNGEN unterschiedliche Funktionsmerkmale des Sperrschemas nach Gültigkeitsbereichen getrennt setzen. Der folgenden Tabelle entnehmen Sie, welche Merkmale für die Bereiche Server, Application und Session verfügbar sind. Funktionsmerkmale

Server

Applikation

Sitzung

keine automatische Überprüfung oder Sperre

ja

ja

ja

vollständige Überprüfung

ja

ja

ja

automatische Lesesperre

ja

ja

ja

Single-Thread-Sitzungen

ja

Jedes Funktionsmerkmal, das Sie wählen, hat auch Nachteile. 쐽

Keine automatische Überprüfung oder Sperre. Wenn Sie dieses Optionsfeld wählen, werden keine Lese- oder Schreibzugriffe gesperrt oder auf korrekten Schutz überprüft. Sie sollten diese Option nur dann wählen, nachdem Sie eine vollständige Überprüfung durchgeführt haben und wissen, dass keine Fehler behoben werden müssen und alle Sperren programmgesteuert abgewickelt werden. Bei dieser Option ist die Systemleistung am höchsten.

쐽

Vollständige Überprüfung. Wenn Sie dieses Optionsfeld wählen, werden alle nicht gesperrten Zugriffe gefunden. Sie sollten diese Option wählen, wenn Sie im Debug-Modus arbeiten. Bei dieser Option ist die Systemleistung herabgesetzt.

쐽

Automatische Lesesperre. Wenn Sie dieses Optionsfeld wählen, werden alle Lesezugriffe gesperrt, und nicht gesperrte Schreibzugriffe lösen eine Fehlerbedingung aus. Auch diese Option setzt die Systemleistung deutlich herab.

쐽

Single-Thread-Sitzungen. Wenn Sie dieses Optionsfeld wählen, muss die gesamte Abfrage beendet sein, bevor eine andere Abfrage für die gleiche Sitzung verarbeitet werden kann. Diese

688

CFLOCK

Option kann je nach Abfragemuster Auswirkungen auf die Systemleistung haben. So kann sich z.B. die Antwortzeit erhöhen, wenn eine Anwendung mehrere Frames aufweist, die sofort aktualisiert werden können, so dass mehrere Abfragen bis zu ihrer Verarbeitung in einer Warteschlange verbringen müssen.

Deadlocks CFLOCK verwendet Synchronisierungsobjekte auf Kernel-Ebene, die beim Timeout und/oder bei

einem vorzeitigen Abbruch des zugehörigen Threads automatisch freigegeben werden. Aus diesem Grund kann ColdFusion bei der Verarbeitung eines CFLOCK-Tags nicht auf unbestimmte Zeit blockiert werden. Sehr hohe Timeout-Werte können jedoch Anfrage-Threads längere Zeit blockieren und deshalb den Durchsatz drastisch verringern. Verwenden Sie deshalb immer den geringstmöglichen Timeout-Wert. Ein anderer möglicher Grund für blockierte Abfrage-Threads ist ein inkonsistentes Verschachteln von CFLOCK-Tags sowie eine nicht durchgängige Benennung von Sperren. Wenn Sie Sperren verschachteln, müssen Ihre und alle anderen Anwendungen (CF-Templates), die auf die gesperrten Variablen zugreifen, die CFLOCK-Tags durchgängig in der gleichen Reihenfolge verschachteln. Halten sich nicht alle Anwendungen, die auf gesperrte Variablen zugreifen, an diese Konventionen, kann ein Deadlock (gegenseitige Blockierung) auftreten. Ein Deadlock ist ein Zustand, in dem es keiner Abfrage möglich ist, den gesperrten Abschnitt der Seite auszuführen. Daher werden sämtliche an den geschützten Abschnitt der Seite gerichteten Abfragen solange blockiert, bis eine Zeitüberschreitung (Timeout) auftritt. In den folgenden Tabellen werden zwei Szenarios beschrieben, die zu Deadlocks führen. Deadlock-Szenario mit zwei Benutzern Benutzer 1

Benutzer 2

Sperrt den Sitzungs-Gültigkeitsbereich.

Sperrt den Anwendungs-Gültigkeitsbereich.

Deadlock
Versucht, den Anwendungs-Gültigkeitsbereich zu sperren; dieser Bereich ist jedoch bereits durch Benutzer 2 gesperrt worden.

Deadlock: Versucht, den Sitzungs-Gültigkeitsbereich zu sperren; dieser Bereich ist jedoch bereits durch Benutzer 1 gesperrt worden.

Deadlock-Szenario mit einem Benutzer Benutzer belegt den Sitzungs-Gültigkeitsbereich mit einer Lesesperre. Deadlock: Versucht, den Sitzungs-Gültigkeitsbereich mit einer exklusiven Sperre zu belegen, kann dies aber nicht tun, weil für diesen Bereich bereits eine Schreibschuz-Sperre (Read-only) festgelegt wurde.

Das folgende Deadlock-Szenario könnte eintreten, wenn Sie versuchen, eine Schreibsperre nach einer Lesesperre zu schachteln, wie im folgenden Code-Beispiel:

689

ColdFusion-Tags

...............

.........

Ist ein Deadlock einmal eingetreten, kann kein Benutzer diesen auflösen, da die Ausführung ihrer Abfragen solange blockiert bleibt, bis der Deadlock durch einen für die Sperre festgelegten Timeout aufgelöst werden kann. Sie vermeiden Deadlocks dadurch, dass Sie und alle anderen mit dem Verschachteln von Sperren beauftragten Personen dabei nach einer genau definierten Reihenfolge vorgehen und bei der Zuweisung von Namen an Sperren auf Konsistenz achten. Insbesondere müssen Sie beim Sperren des Zugriffs auf die Bereiche Server, Anwendung und Sitzung eine ganz bestimmte Reihenfolge einhalten. 1.

Sperren Sie den Sitzungsbereich. Kennzeichnen Sie im CFLOCK-Tag den Gültigkeitsbereich der Sperre, indem Sie für das SCOPE-Attribut den Wert »SESSION« angeben.

2.

Sperren Sie den Applikationsbereich. Kennzeichnen Sie im CFLOCK-Tag den Gültigkeitsbereich der Sperre, indem Sie für das SCOPE-Attribut den Wert »APPLICATION« angeben.

3.

Sperren Sie den Server-Bereich. Kennzeichnen Sie im CFLOCK-Tag den Gültigkeitsbereich der Sperre, indem Sie für das SCOPE-Attribut den Wert »SERVER« angeben.

4.

Heben Sie die Sperre des Server-Bereichs auf.

5.

Heben Sie die Sperre des Applikationsbereichs auf.

6.

Heben Sie die Sperre des Sitzungsbereichs auf.

Hinweis Sie können aus diesem Schema jedes beliebige aus Sperre aktivieren/Sperre deaktivieren zusammengesetzte Schrittpaar herausnehmen, falls die Sperre eines bestimmten Gültigkeitsbereichs nicht erforderlich ist. So können Sie beispielsweise die Schritte 3 und 4 auslassen, falls Sie den Serverbereich nicht sperren müssen. Ähnliche Regeln gelten für Sperren, denen Namen zugewiesen werden.

Beispiel







691

ColdFusion-Tags

Beispiel für CFLOCK



Beispiel für CFLOCK

Danke für Ihren Besuch im virtuellen Laden von E-Rollkragen. Heute haben Sie einen Rollkragen in der Größe #form.groesse# und in der Farbe #form.farbe# gewählt.





Der Schleifenindex lautet #ZaehlVar#.


695

ColdFusion-Tags

Die Ergebnisse werden in einem Browser wie folgt angezeigt: Der Der Der Der Der

Schleifenindex Schleifenindex Schleifenindex Schleifenindex Schleifenindex

lautet lautet lautet lautet lautet

1. 2. 3. 4. 5.

Schleife über eine Abfrage Eine Schleife über eine Abfrage wird für jeden Datensatz in der Abfragedatensatzgruppe wiederholt. Die CFLOOP-Ergebnisse sind einem CFOUTPUT ähnlich. Während jedes Durchlaufs der Schleife stehen die Spalten der aktuellen Zeile zur Ausgabe zur Verfügung. Der Vorteil von CFLOOP anstelle von CFOUTPUT liegt darin, dass Sie innerhalb eines CFLOOP-Tags jedes CFML-Tag verwenden können.

Syntax

QUERY Zwingend erforderlich. Gibt die Abfrage an, die die Schleife steuert. STARTROW Optional. Gibt die erste Zeile der Abfrage an, die in die Schleife aufgenommen wird. ENDROW Optional. Gibt die letzte Zeile der Abfrage an, die in die Schleife aufgenommen wird.

Beispiel 1 Im folgenden Beispiel wird ein CFLOOP-Tag gezeigt, das wie CFOUTPUT arbeitet und das QUERY-Attribut verwendet:

SELECT Kommentar_id FROM Kommentare

#Kommentar_ID#


696

CFLOOP

Beispiel 2 CFLOOP ermöglicht außerdem eine Wiederholung über jede Datensatzgruppe mit dynamischen Startund Stoppunkten. Sie können also beispielsweise in der zehnten Zeile eine Abfrage beginnen und an der zwanzigsten Zeile enden. Mit dieser einfachen Methode werden die nächsten n Datensatzgruppen aus einer Abfrage abgerufen.

Im folgenden Beispiel durchläuft die Schleife den Bereich der Datensätze von 10 bis 20, die von »MeineAbfrage« ausgegeben wurden:

#MeineAbfrage.MeinSpaltenname#


Die Schleife wird beendet, wenn keine weiteren Datensätze vorliegen oder der aktuelle Datensatz größer als der Wert des ENDROW-Attributs ist.

Beispiel 3 Der Vorteil, eine Schleife über eine Abfrage auszuführen, liegt darin, daß Sie CFML-Tags verwenden können, die in CFOUTPUT nicht zulässig sind. Im folgenden Beispiel werden die Seiten, die von einer Abfrage in einer Liste von Seitennamen ausgegeben werden, mit Hilfe des CFINCLUDE-Tags zu einem einzigen Dokument kombiniert.

SELECT VorlagenName FROM Vorlagen



Schleife über eine Liste Das Ausführen einer Schleife über eine Liste bietet die Möglichkeit, Elemente zu durchlaufen, die in einer Variablen enthalten sind, oder Werte, die über einen Ausdruck erhalten werden. Bei einer Listenschleife gibt das INDEX-Attribut den Namen einer Variablen an, die als nächstes Element der Liste empfangen werden soll. Das LIST-Attribut enthält eine Liste oder eine Variable, die eine Liste enthält.

697

ColdFusion-Tags

Syntax

INDEX Zwingend erforderlich. Bei einer Listenschleife gibt das INDEX-Attribut den Namen einer Variablen an, die als nächstes Element der Liste empfangen werden soll. Das LIST-Attribut enthält eine Liste oder eine Variable, die eine Liste enthält. LIST Zwingend erforderlich. Die Listenelemente in der Schleife, die entweder direkt oder in einer Variablen geliefert werden. DELIMITERS Optional. Gibt das Trennzeichen an, das zum Trennen der Elemente in der LIST verwendet wird.

Beispiel Die folgende Schleife zeigt die Namen aller Mitglieder der Beatles an:

#ListenElement#


Obwohl CFLOOP erwartet, dass die Elemente in einer Liste standardmäßig durch Kommas getrennt sind, können Sie in dem DELIMITER-Attribut andere Trennzeichen festlegen. Im folgenden wird die obenstehende Schleife erneut gezeigt. Dieses Mal verwendet CFLOOP Kommas, Doppelpunkte oder Schrägstriche als Trennzeichen für Listenelemente:

#ListenElement#


Trennzeichen müssen nicht in einer bestimmten Reihenfolge festgelegt werden. Beachten Sie, dass aufeinanderfolgende Trennzeichen als ein einziges Trennzeichen behandelt werden. Die beiden Doppelpunkte im obenstehenden Beispiel werden also als ein einziges Trennzeichen zwischen »George« und »Ringo« betrachtet.

698

CFLOOP

Schleife über eine COM-Sammlung oder Struktur Das CFLOOP COLLECTION-Attribut ermöglicht die Ausführung einer Schleife über eine Struktur oder ein COM/DCOM-Sammlungsobjekt. 쐽

Ein COM/DCOM-Sammlungsobjekt ist eine Menge ähnlicher Elemente, auf die als eine Gruppe und nicht einzeln verwiesen wird. So ist beispielsweise die Gruppe der offenen Dokumente in einer Anwendung eine Sammlung.

쐽

Eine Struktur kann entweder eine verwandte Gruppe von Objekten enthalten oder als assoziatives Datenfeld verwendet werden. Eine Schleife ist besonders praktisch, wenn eine Struktur als assoziatives Datenfeld verwendet wird.

Jedes Sammlungselement wird in CFLOOP über den Variablennamen angesprochen, den Sie im ITEMAttribut festlegen. Diese Art von Iteration wird normalerweise für den Zugriff auf Objekte in einer COM/DCOM-Sammlung oder auf Elemente in der Struktur verwendet. Die Schleife wird ausgeführt, bis auf alle Objekte zugegriffen wurde. Das COLLECTION-Attribut wird zusammen mit dem ITEM-Attribut in einem CFLOOP-Tag verwendet. Im folgenden Beispiel wird ITEM eine Variable mit der Bezeichnung datei2 zugewiesen, so dass mit jedem Durchlauf in CFLOOP auf jedes Objekt in der Sammlung verwiesen wird. Im CFOUTPUT-Abschnitt wird auf die Namenseigenschaft des Objekts datei2 für die Anzeige verwiesen.

Beispiele Im folgenden Beispiel wird ein COM-Objekt zur Ausgabe einer Dateiliste verwendet. In diesem Beispiel ist FFUNC eine Sammlung der Objekte in datei2.



#datei2.name#


Dieses Beispiel zeigt eine Schleife über eine Struktur (als assoziatives Datenfeld verwendet): ...

Dieses Beispiel zeigt die Verwendung von CFMAIL. Wenn Ihre CFAS-Maileinstellungen

702

CFMAILPARAM

korrekt konfiguriert und die Kommentare entfernt worden sind, können Sie mit diesem Code E-Mail versenden.

Beispiel für CFMAILPARAM

Beispiel für CFMAILPARAM

In diesem Beispiel wird CFMAILPARAM verwendet, um für eine Nachricht eine Kopfzeile festzulegen und zwei Dateien als Anhang zu benennen.

Dies ist der Code im benutzerdefinierten Tag.

Ausführen einer Schleife über alle Objekte in der Sammlung:


Nachname: #file2.lastname#


...

CFOBJECT Type="CORBA" CFOBJECT ermöglicht den Aufruf von Methoden in CORBA-Objekten. Diese CORBA-Objekte müs-

sen bereits existieren und zur Verwendung registriert sein.

711

ColdFusion-Tags

Syntax

CONTEXT Zwingend erforderlich. Legt eines der folgenden Objekte fest: 쐽

IOR -- ColdFusion verwendet die Interoperable Object Reference (IOR), um auf den CORBAServer zuzugreifen.

쐽

NameService -- ColdFusion verwendet den Namensdienst, um auf den Server zuzugreifen. Der Attributwert »NameService« ist nur zusammen mit einem Aufruf der getInitialContext-Methode eines VisiBroker ORB gültig.

CLASS Zwingend erforderlich. Gibt abhängig von der CONTEXT-Spezifikation unterschiedliche Informationen an: 쐽

CONTEXT = IOR – Gibt den Namen einer Datei an, die die Zeichenkettenversion der IOR enthält. Diese Datei muß von ColdFusion jederzeit gelesen werden können. Sie sollte auf dem ColdFusion-Server oder im Netzwerk in einem zugänglichen Verzeichnis gespeichert sein.

쐽

CONTEXT = NameService – Gibt einen durch Punkte begrenzten Namenskontext für den Namensdienst an, wie zum Beispiel Allaire.Department.Doc.empobject.

NAME Zwingend erforderlich. Geben Sie einen Namen für das Objekt ein. Ihre Applikation verwendet diesen Namen, um auf die Methoden und Attribute der CORBA-Objekte zu verweisen. LOCALE Optional. Setzt Argumente für einen Aufruf von init_orb(..). Die Verwendung dieses Attributs ist speziell für ORBs des Herstellers VisiBroker vorgesehen. Es ist derzeit für C++, Version 3.2 verfügbar. Der Wert sollte folgendes Format aufweisen: LOCALE=" -ORBagentAddr 199.99.129.33 -ORBagentPort 19000" Beachten Sie, daß jedes Typ-Wert-Paar mit einem führenden »-« beginnen muß.

Verwendung ColdFusion Enterprise, Version 4.0 und höher unterstützt CORBA über die Schnittstellenspezifikation Dynamic Invocation Interface (DII). Um CFOBJECT mit CORBA-Objekten verwenden zu können, benötigen Sie entweder den Namen der Datei, die die Zeichenfolgenversion der IOR enthält, oder den Namenskontext des Objekts im Namensdienst. Sie müssen weiterhin wissen, welche Attribute, Methodennamen und Methodensignaturen das Objekt verwendet.

712

CFOBJECT

Benutzerdefinierte Typen (z.B. Strukturen) werden nicht unterstützt.

Beispiel

CFOBJECT Type="JAVA" Mit CFOBJECT können Sie JAVA-Objekte und letztendlich auch EJB-Objekte erzeugen und einsetzen. Diese Funktion wird derzeit nur für NT unterstützt. In der nächsten Version ist auch die Erweiterung auf die Solaris-Plattform geplant.

Syntax

ACTION Zwingend erforderlich. Mit der Aktion »Create« wird das Java-Objekt oder das WebLogic Environment-Objekt erzeugt. TYPE Zwingend erforderlich. Gibt den Objekttyp an. In diesem Fall ist der Attributwert stets »Java«. CLASS Zwingend erforderlich. Gibt die Java-Klasse an. NAME Zwingend erforderlich. Der innerhalb von CFML benutzte Name für den Zugriff auf das Objekt.

Verwendung Damit Java-CFXs (CFXs = ColdFusion-Erweiterungen) oder Java-Objekte aufgerufen werden können, benutzt ColdFusion eine in den Prozess eingebettete JVM. Das Laden der JVM sowie Speicherort und Einstellungen für die JVM werden mit Hilfe der ColdFusion Administrator-Seiten konfiguriert.

713

ColdFusion-Tags

Jede in dem im ColdFusion Administrator angegebenen Klassenverzeichnis verfügbare Java-Klasse kann geladen und von ColdFusion aus mit Hilfe des CFOBJECT-Tags benutzt werden. Für den Zugriff auf Java-Methoden und -Felder gehen Sie nach den folgenden Schritten vor: 1.

Rufen Sie CFOBJECT auf, um die Klasse zu laden (siehe Beispiel).

2.

Verwenden Sie die Init-Methode mit geeigneten Argumenten, um einen Konstruktor explizit aufzurufen. Beispiel:

Das Aufrufen einer Public-Methode des Objekts ohne vorherigen Aufruf der Init-Methode führt zu einem impliziten Aufruf des Standardkonstruktors. Als Argumente und Rückgabewerte sind beliebige gültige Java-Typen (einfache Typen, Datenfelder, Objekte) möglich. ColdFusion führt die entsprechenden Konvertierungen durch, wenn Zeichenketten als Argumente übergeben werden. Dies gilt jedoch nicht, wenn die Zeichenketten als Rückgabewerte empfangen werden. Überladene Methoden werden unterstützt, falls die Anzahl der Argumente unterschiedlich ist. Im Zuge der geplanten Erweiterungen werden Sie künftig über cast-Funktionen (d.h. Funktionen für die Typumwandlung) verfügen, mit denen ein genauerer Aufbau von Methodensignaturen (Methodennamen und zugehörige Parametertypen) möglich ist.

EJBs aufrufen Verwenden Sie CFOBJECT zum Erzeugen und Aufrufen der entsprechenden EJB-Objekte. Im Code des zweiten Beispiels wird vorausgesetzt, daß zum Registrieren und Finden von Instanzen des EJBHome-Objekts Weblogic JNDI eingesetzt wird.

Beispiel für ein Java-Objekt





Share value = #value#

B.55 CFOUTPUT Zeigt die Ergebnisse einer Datenbankabfrage oder einer anderen Operation an. Wenn Sie CFOUTPUTTags verschachteln müssen, lesen Sie bitte die Informationen im Abschnitt »Verwendung«.

Syntax

QUERY Optional. Der Name der CFQUERY, aus der Sie die Daten für den Ausgabeabschnitt holen möchten. GROUP Optional. Gibt die Abfragespalte an, die benutzt werden soll, wenn Sie Datensätze zu Gruppen zusammenfassen. Verwenden Sie dieses Attribut, wenn Sie einen Datensatz abgerufen haben, der nach einer bestimmten Abfragespalte geordnet ist. Wenn Sie beispielsweise einen Datensatz haben, der nach »Kunden_ID« im CFQUERY-Tag geordnet ist, können Sie die Ausgabe nach »Kunden_ID« gruppieren. Das von der Groß-/Kleinschreibung abhängige GROUP-Attribut eliminiert aufeinanderfol-

715

ColdFusion-Tags

gende Duplikate, wenn die Daten nach dem angegebenen Feld sortiert werden. In der Syntaxbeschreibung zum GROUPCASESENSITIVE-Attribut finden Sie Informationen zum Angeben einer von der Groß-/Kleinschreibung unabhängigen Gruppierung. GROUPCASESENSITIVE Optional. Boolescher Wert, der angibt, ob beim Gruppieren die Groß-/Kleinschreibung berücksichtigt werden muß. Die Voreinstellung ist YES; d.h. die Groß-/Kleinschreibung wird beim Gruppieren berücksichtigt. Falls das QUERY-Attribut ein Abfrageobjekt angibt, das von einer SQL-Abfrage ohne Berücksichtigung der Groß-/Kleinschreibung generiert wurde, setzen Sie das GROUPCASESENSITIVE Attribut auf NO, damit der Datensatz intakt bleibt. STARTROW Optional. Legt die Zeile fest, ab der die Ausgabe beginnen soll. MAXROWS Optional. Legt die maximale Anzahl an Zeilen fest, die im Ausgabeabschnitt angezeigt werden sollen.

Verwendung Zum Verschachteln von CFOUTPUT-Blöcken müssen Sie die Attribute GROUP und QUERY auf der obersten Ebene und das GROUP-Attribut für alle inneren Blöcke außer dem innersten CFOUTPUT-Block angeben.

Beispiel

SELECT Abteilungs_ID, KursName, KursStufe FROM KursListe ORDER by Abteilungs_ID, KursStufe, KursName

CFOUTPUT

Beispiel für CFOUTPUT

CFOUTPUT teilt meinem ColdFusion-Server mit, die Verarbeitung zu beginnen und die Steuerung der Seitenerstellung daraufhin an den Webserver zurückzugeben.

Um beispielsweise das heutige Datum anzuzeigen, würden Sie #DateFormat("#Now()#") schreiben. Wenn Sie diesen Ausdruck in CFOUTPUT integrieren, erhalten Sie als Ergebnis #DateFormat(Now())#

716

CFPARAM

.

Mit CFOUTPUT können außerdem die Ergebnisse einer Abfrage oder ein Teilergebnis wie folgt angezeigt werden:

Die Abfrage enthält insgesamt #KurseAbfragen.recordCount# Datensätze. Mit dem MAXROWS-Parameter können wir die Anzeige auf 4 Zeilen beschränken.

#Abteilungs_ID# #KursName# #KursStufe#

CFOUTPUT kann auch die Ergebnisse eines komplexeren Ausdrucks anzeigen, wie zum Beispiel das Abrufen des Wochentages für das aktuelle Datum. Hierzu müssen wir als erstes die ganze Zahl, die den Wochentag darstellt, aus der Serverfunktion Now() extrahieren und das Ergebnis auf die DayofWeekAsString-Funktion anwenden:
Heute ist #DayofWeekAsString(DayofWeek(Now()))#
Heute ist #DayofWeekAsString(DayofWeek(Now()))#

B.56 CFPARAM CFPARAM testet, ob ein Parameter vorhanden ist. Als zusätzliche Option kann der Datentyp des Parameters überprüft und – falls nicht vorhanden – ein voreingestellter Typ zur Verfügung gestellt werden.

Syntax

DEFAULT="Wert">

NAME Der Name des Parameters, den Sie testen (wie beispielsweise »Client.E-Mail« oder »Cookie.HintergrundFarbe«). Wenn Sie das DEFAULT-Attribut weglassen, tritt bei einem angegebenen aber nicht vorhandenen Parameter ein Fehler auf.

717

ColdFusion-Tags

TYPE Optional. Der Typ des Parameters, der erforderlich ist. Der voreingestellte Wert ist »any«. Typwert

Beschreibung

any

ein beliebiger Wert

array

ein beliebiger Datenfeldwert

binary

ein binärer Wert

boolean

ein Boolescher Wert

date

ein Datum-Uhrzeit-Wert

numeric

ein nummerischer Wert

query

ein Abfrageobjekt

string

eine Zeichenkette oder ein einzelnes Zeichen

struct

eine Struktur

UUID

Ein Universally Unique Identifier (UUID) mit dem Format 'XXXXXXXX-XXXX-XXXXXXXXXXXXXXXXXXX', wobei 'X' für eine hexadezimale Ziffer steht (0-9 oder A-F). Siehe CreateUUID.

variableName

ein gültiger Variablenname

DEFAULT Optional. Standardwert, auf den der Parameter gesetzt wird, falls er nicht existiert.

Verwendung CFPARAM kann auf dreierlei Arten verwendet werden: 쐽

Zur Überprüfung, ob eine benötigte Variable vorhanden ist – Verwenden Sie CFPARAM nur mit dem NAME-Attribut, um zu festzustellen, ob eine benötigte Variable vorhanden ist. Falls die Variable nicht vorhanden ist, beendet der ColdFusion-Server die Verarbeitung der Seite, und es erscheint eine Fehlermeldung.

쐽

Zur Überprüfung, ob eine benötigte Variable existiert und zu welchem Typ sie gehört -- Verwenden Sie CFPARAM mit dem NAME- und dem TYPE-Attribut, um festzustellen, ob eine benötigte Variable vorhanden ist und den angegebenen Typ hat.

쐽

Zur Überprüfung, ob eine optionale Variable vorhanden ist – Verwenden Sie CFPARAM mit dem NAME- und dem DEFAULT-Attribut, um zu festzustellen, ob eine optionale Variable vorhanden ist. Falls die Variable existiert, wird die Verarbeitung fortgesetzt, und der Wert bleibt unverändert. Existiert die Variable nicht, wird sie erstellt und auf den Wert des DEFAULT-Attributs gesetzt.

718

CFPARAM

Beispiel





Beispiel für CFPARAM

Beispiel für CFPARAM

CFPARAM wird verwendet, um die Standardwerte so einzustellen, dass der Entwickler das Vorhandensein einer Variable nicht mit einer Funktion wie IsDefined feststellen muß.

Der Standardwert unserer Variablen tempVar lautet "#StoreTempVar# "

Beispiel für CFPOP

Beispiel für CFPOP

Mit CFPOP können Sie Mail in einer POP3-Mailbox abrufen und ändern. Dieses Beispiel zeigt, wie Sie ein Funktionsmerkmal eines Mail-Clients realisieren, mit der Sie die Mail-Kopfzeilen in einer POP3-Mailbox anzeigen können.

Entfernen Sie die Kommentar-Markierungen aus dem Code und führen Sie ihn auf einem mit Mail ausgestatteten ColdFusion-Server aus, um diese Funktion auszuprobieren.





Der Ausgabeparameterwert: '#foo#'


Ergebnisinformationen #NAME#,#DATE_COL#

Datensatzanzahl: #RS1.RecordCount#

Spalten: #RS1.ColumnList#

#col1#,#col2#,#col3#

Datensatzanzahl: #RS3.RecordCount#

Spalten: #RS3.ColumnList#

Der Rückgabecode für die gespeicherte Prozedur lautet: "#CFSTOREDPROC.STATUSCODE#"


...

B.60 CFPROCRESULT Das CFPROCRESULT-Tag ist in einem CFSTOREDPROC-Tag verschachtelt. Der NAME-Parameter dieses Tags gibt den Namen einer Ergebnismenge an, die von den ColdFusion-Tags CFOUTPUT und CFTABLE verwendet wird, um auf die Ergebnismenge zuzugreifen. Sie können damit auch wahlweise festlegen, welche der Ergebnismengen an die gespeicherte Prozedur zurückgegeben wird.

Syntax

727

ColdFusion-Tags

NAME Zwingend erforderlich. Der Name für die Abfrageergebnismenge. RESULTSET Optional. Geben Sie diesen Parameter an, um die gewünschte Ergebnismenge zu identifizieren, falls von der gespeicherten Prozedur mehrere Ergebnismengen zurückgegeben werden. Standardmäßig wird eine Zeile hinzugefügt. MAXROWS Optional. Gibt die maximale Anzahl an Zeilen an, die in der Ergebnisgruppe zurückgegeben werden. Standardmäßig werden alle Zeilen der Ergebnismenge zurückgegeben.

Verwendung Geben Sie mindestens ein CFPROCRESULT-Tag an, um den Zugriff auf die von der gespeicherten Prozedur zurückgegebenen Daten zu ermöglichen. RESULTSET muss im Bereich des CFSTOREDPROC-Tags eindeutig sein. Wenn Sie dieselbe Ergebnismenge zweimal angeben, wird die erste von der zweiten überschrieben.

Beispiel ...





Beispiel für CFQUERY

Beispiel für CFQUERY

732

CFQUERY

SELECT PARKNAME, REGION, STATE FROM Parks ORDER BY ParkName, State

Kursnummer: #Nummer#
Beschreibung: #Beschreibung#

Kursnummer: #Vorname# #Nachname# Beschreibung: #Abteilung#

Der Java-KlassenPfad-Wert lautet #RegWert#



CFREGISTRY ACTION="Set" Verwenden Sie CFREGISTRY mit der Set-Aktion, um einen Registrierungsschlüssel oder einen neuen Wert hinzuzufügen oder Wertdaten zu aktualisieren.

Syntax

BRANCH Zwingend erforderlich. Der Name des Registrierungszweigs, der den zu setzenden Schlüssel oder Wert enthält. ENTRY Zwingend erforderlich. Der zu setzende Schlüssel oder Wert. TYPE Optional. Der Datentyp, den Sie einstellen wollen. 쐽

String. Festlegen eines Zeichenkettenwerts (Standard).

쐽

DWord. Festlegen eines DWord-Werts.

쐽

Key. Erstellen eines Schlüssels.

742

CFREGISTRY

VALUE Optional. Die festzulegenden Wertdaten Wenn Sie dieses Attribut weglassen, erstellt CFREGISTRY die folgenden Standardwertdaten: 쐽

String. Der Standardwert ist eine leere Zeichenfolge: »«

쐽

DWord. Der Standardwert ist 0 (Null).

Verwendung CFREGISTRY erstellt den Schlüssel oder Wert nur dann, wenn er existiert.

Beispiel

CFREGISTRY ACTION="Set"

CFREGISTRY ACTION="Delete" Verwenden Sie CFREGISTRY mit der Delete-Aktion, um einen Registrierungsschlüssel oder -wert zu löschen.

Syntax

BRANCH Zwingend erforderlich. Legt eines der folgenden Objekte fest:

743

ColdFusion-Tags

쐽

Beim Löschen eines Schlüssels – Der Name des Registrierungsschlüssels, der gelöscht werden soll. Um einen Schlüssel zu löschen, geben Sie ENTRY nicht an.

쐽

Beim Löschen eines Wertes – Der Name des Registrierungszweigs, in dem der zu löschende Wert enthalten ist. Zum Löschen eines Werts müssen Sie ENTRY angeben.

ENTRY Wird zum Löschen eines Werts benötigt. Der zu löschende Wert.

Verwendung Wenn Sie einen Schlüssel löschen, werden mit CFREGISTRY auch die Werte und Unterschlüssel, die sich unterhalb des Schlüssels befinden, gelöscht.

Beispiel

Beispiel für CFREPORT

CFREPORT-Tag

CFREPORT ermöglicht, dass mit Crystal Reports Professional erstellte Berichte mit einer ColdFusion-Schnittstelle angezeigt werden können. Das CFREPORT-Tag setzt zur Ausführung den Namen des Berichts voraus. CFREPORT kann auch an die angezeigte Berichtdatei Informationen weitergeben, um die Ausgabebedingungen zu ändern.

Dieses Beispiel führt einen Bericht namens "gewinn.rpt" aus und übergibt ihm eine optionale Filterbedingung, um nur die Informationen einer bestimmten Untermenge des Berichts anzuzeigen.

745

ColdFusion-Tags

{Departments.Department} = "International"

Ersetzen Sie die in diesem Code enthaltenen Berichtfilter und Filter durch Ihre eigenen, und platzieren Sie mit CFREPORT existierende Crystal Reports-Berichte auf Webseiten.

B.65 CFRETHROW Gibt die aktuell aktive Ausnahmebedingung zurück. stellt die Ausnahmeinformationen bereit, die in den Abfangvariablen CFCATCH.TYPE und CFCATCH.TAGCONTEXT enthalten sind. Siehe auch CFTRY/CFCATCH.

Syntax

Verwendung Verwenden Sie das Tag innerhalb eines -Blocks. Dieses Tag leistet nützliche Dienste in Code für die Fehlerbehandlung, wenn die Fehlerbehandlungsroutine die ausgelöste Fehlermeldung nicht erfolgreich abwickeln kann.

Beispiel



746

CFSCHEDULE

SELECT * FROM Nachrichten



Beispiel für CFSCHEDULE

CFSCHEDULE-Beispiel

CFSCHEDULE bietet eine programmgesteuerte Schnittstelle zur ColdFusion-Planungs-Engine. Sie können eine bestimmte Seite in festgelegten Intervallen ausführen und wahlweise statische HTML-Seiten erstellen. Hierdurch haben Benutzer Zugriff auf Seiten, auf denen Daten, z.B. Berichte, veröffentlicht werden, ohne dass sie auf den Abschluß eines Datenbankvorgangs warten müssen, um ihre Daten auf der Seite eingeben zu können.



750

CFSCRIPT

B.67 CFSCRIPT Das CFSCRIPT-Tag schließt ein Codesegment ein, das CFScript enthält.

Syntax

Hier steht der CFScript-Code.

Verwendung Verwenden Sie CFSCRIPT, um die Verarbeitung in CFScript anstatt in CFML durchzuführen. Beachten Sie folgendes zu CFScript: 쐽

CFScript verwendet ColdFusion-Funktionen, -Ausdrücke und -Operatoren.

쐽

Sie können in CFScript ColdFusion-Variablen lesen und schreiben.

CFSCRIPT wird u.a. dazu verwendet, um eine Reihe von Zuordnungsfunktionen zu verpacken, für die sonst CFSET-Anweisungen verwendet werden müßten.

Beispiel



Beispiel für CFSEARCH

Beispiel für CFSEARCH







SELECT * FROM Nachrichten



Beispiel für CFSET

Beispiel für CFSET

CFSET ermöglicht Ihnen, lokale und globale Variablen innerhalb einer ColdFusion-Vorlage festzulegen und ihnen Werte zuzuordnen.

Zum Beispiel wurde die Variable AnzahlDatensaetze auf dieser Vorlage so deklariert, dass sie die von unserer Abfrage zurückgegebene Anzahl der Datensätze (#AnzahlDatensaetze#) aufnimmt.

CFSET kann auch dazu verwendet werden, um Variablen von anderen Seiten weiterzugeben , wie in diesem Beispiel, das den URL-Parameter "Test" aus der folgenden Verbindung übernimmt (Hier klicken), um eine Nachricht anzuzeigen:

#url.test#

Die Variable url.test wurde von keiner anderen Seite weitergegeben.

CFSET kann auch zur Auflistung von Umgebungsvariablen wie der Zeit, der IP-Adresse des Benutzers oder anderen in ColdFusion möglichen Funktionen und Ausdrücken verwendet werden.

764

CFSETTING

...

B.73 CFSETTING CFSETTING wird verwendet, um verschiedene Aspekte der Seitenverarbeitung zu steuern, beispiels-

weise die Ausgabe von HTML-Code in Ihren Seiten. Einer der Vorteile dieser Option liegt darin, dass Leerraum verarbeitet werden kann, der in ColdFusion-Ausgabeseiten vorhanden sein kann.

Syntax

ENABLECFOUTPUTONLY Zwingend erforderlich. Yes oder No. Bei Yes sperrt CFSETTING die Ausgabe des gesamten HTMLCodes, der sich außerhalb von CFOUTPUT-Tags befindet. SHOWDEBUGOUTPUT Optional. Yes oder No. Wenn SHOWDEBUGOUTPUT auf No eingestellt ist, werden am Ende der erstellten Seite keine Debugging-Informationen angezeigt. Standardwert Yes. CATCHEXCEPTIONSBYPATTERN Optional. Yes oder No. Wird dieses Attribut auf Yes gesetzt, hat diese Einstellung Vorrang vor der strukturierten Ausnahmebehandlung, die in Version 4.5 eingeführt wurde. Standardwert No.

Hinweis Aus der strukturierten Ausnahmebehandlung ergibt sich eine fast unmerkliche Aufwärtsinkompatibilität. In Version 4.0.x wurde eine Ausnahme durch den ersten CFCATCH-Block abgewickelt, der über eine Behandlungsroutine (einen Handler) für diesen Ausnahmetyp verfügte. In Version 4.5 sucht dagegen der Manager für strukturierte Ausnahmebehandlung nach dem CFCATCH-Handler, der sich am besten für diese Aufgabe eignet.

Verwendung Beim Verschachteln von CFSETTING-Tags muß jede Einstellung der Form ENABLECFOUTPUTONLY="Yes" genau einer Einstellung der Form ENABLECFOUTPUTONLY="No" entsprechen, damit normaler HTMLText für den Benutzer sichtbar ist. Wenn Sie z.B. fünf Anweisungen der Form ENABLECFOUTPUTONLY =Yes" haben, müssen als Entsprechung genau fünf Anweisungen der Form ENABLECFOUTPUTONLY="No" vorhanden sein, damit der HTML-Text erneut angezeigt wird.

765

ColdFusion-Tags

Wenn zu irgendeinem Zeitpunkt die Ausgabe von normalem HTML-Text aktiviert ist (gleichgültig, wie oft ENABLECFOUTPUTONLY="No" verarbeitet wurde), sperrt die erste ENABLECFOUTPUTONLY="Yes"Anweisung die Ausgabe.

Beispiel ...

Dieser Text wird nicht angezeigt.

Dieser Text wird nicht angezeigt.

Text innerhalb von CFOUTPUT wird immer angezeigt.

Text innerhalb von CFOUTPUT wird immer angezeigt.



B.74 CFSILENT CFSILENT unterdrückt alle Ausgaben, die von der CFML innerhalb des Gültigkeitsbereichs des Tags erzeugt werden (siehe auch CFSETTING).

Syntax

Beispiel

CFSILENT

CFSILENT



Beispiel für CFSLIDER

Beispiel für CFSLIDER

Wird CFSLIDER in einem CFFORM verwendet, erhalten Java-Browser zusätzliche Funktionalität.

Verschieben Sie den Schieberegler, um die Veränderung der Werte in Echtzeit anzuzeigen. Übermitteln Sie daraufhin das Formular, um zu zeigen, wie CFSLIDER den Wert an eine neue ColdFusion-Vorlage weiterleitet.

Der Schieberegler zeigt folgenden Wert an: #MeinSchieberegler# Versuchen Sie es noch einmal!

1 100

771

ColdFusion-Tags

B.76 CFSTOREDPROC Gespeicherte Prozeduren werden über eine ODBC- oder systemeigene Verbindung zu einer Serverdatenbank hauptsächlich mit Hilfe des CFSTOREDPROC-Tags ausgeführt. Legt Datenbankverbindungsinformationen und die gespeicherte Prozedur fest.

Syntax

PROCEDURE Zwingend erforderlich. Gibt den Namen der gespeicherten Prozedur auf dem Datenbankserver an. DATASOURCE Erforderlich. Der Name einer ODBC- oder systemeigenen Datenquelle, der auf die Datenbank zeigt, in der die gespeicherte Prozedur enthalten ist. USERNAME Optional. Falls angegeben, überschreibt USERNAME den im Datenquellen-Setup festgelegten Wert des Benutzernamens. PASSWORD Optional. Falls angegeben, überschreibt PASSWORD den im Datenquellen-Setup festgelegten Wert des Kennworts. DBSERVER Optional. Beim Einsatz systemeigener Datenbanktreiber wird der Name des Datenbankserver-Rechners angegeben. Falls angegeben, ersetzt DBSERVER den in der Datenquelle angegebenen Server. DBNAME Optional. Der Datenbankname (nur mit Sybase System 11-Treiber). Falls angegeben, ersetzt DBSERVER die in der Datenquelle angegebene Standarddatenbank. BLOCKFACTOR Optional. Gibt die maximale Anzahl an Zeilen an, die gleichzeitig vom Server abgerufen werden. Der Bereich liegt zwischen 1 (Standard) und 100. Der ODBC-Treiber kann den Blockfaktor während der Laufzeit dynamisch reduzieren.

772

CFSTOREDPROC

PROVIDER Optional. COM-Provider (nur bei OLE-DB). PROVIDERDSN Optional. Der Datenquellenname für den COM-Provider (nur bei OLE-DB). DEBUG Optional. Yes oder No. Legt fest, ob auf Anweisungen Debug-Informationen aufgelistet werden. Standardwert »No«. RETURNCODE Optional. Yes oder No. Legt fest, ob das Tag CFSTOREDPROC.STATUSCODE mit dem von der gespeicherten Prozedur zurückgegebenen Statuscode auffüllt. Standardwert »No«.

Verwendung Sie verwenden CFPROCRESULT und CFPROCPARAM innerhalb eines CFSTOREDPROC-Tags je nach Bedarf. Wenn Sie den ReturnCode-Parameter auf YES setzen, wird mit CFSTOREDPROC die Variable CFSTOREDPROC.STATUSCODE eingestellt, die den Statuscode für die gespeicherte Prozedur angibt. Der Statuscode von gespeicherten Prozeduren variiert je nach DBMS. In der Dokumentation zum jeweiligen DBMS werden die einzelnen Statuscodewerte beschrieben. CFSTOREDPROC gibt nicht nur einen Statuscode zurück, sondern setzt auch eine Variable namens CFSTOREDPROC.ExecutionTime. Diese Variable enthält die Anzahl der Millisekunden, die für die Aus-

führung der gespeicherten Prozedur benötigt wurden. Gespeicherte Prozeduren sind eine erweiterte Funktion professioneller Datenbank-Managementsystemen. Sie sollten sich vor der Implementierung dieser Tags mit gespeicherten Prozeduren und ihrer Verwendung vertraut machen.

Beispiel ...











782

CFTHROW

Beispiel für CFTEXTINPUT

Beispiel für CFTEXTINPUT CFTEXTINPUT kann zur einfachen Validierung von Textfeldern in CFFORM und zur Steuerung von Informationen über Textschriftarten für CFFORM-Textfelder verwendet werden. Das folgende Feld darf nicht leer bleiben. Es zeigt eine clientseitige Nachricht an.

Sie haben #form.MeineEingabe# ins Textfeld eingegeben.





B.80 CFTHROW Das CFTHROW-Tag löst eine vom Entwickler festgelegte Ausnahme aus, die mit den folgenden Einstellungen im TYPE-Attribut des CFCATCH-Tags aufgefangen werden kann: 쐽

CFCATCH TYPE= "benutzerdefinierter_typ"

쐽

CFCATCH TYPE= "APPLICATION"

쐽

CFCATCH TYPE= "ANY"

Syntax

783

ColdFusion-Tags

TYPE Optional. Ein benutzerdefinierter Typ oder der vordefinierte Typ APPLICATION. Keiner der anderen vordefinierten Typen sollte angegeben werden, da diese Typen von ColdFusion-Anwendungen nicht generiert werden. Wenn Sie den Ausnahmetyp APPLICATION angeben, erübrigt sich die Angabe eines Typs für CFCATCH, da der Typ APPLICATION für CFCATCH die Voreinstellung ist. MESSAGE Optional. Eine Nachricht zur Beschreibung des Ausnahmeereignisses. DETAIL Optional. Eine detaillierte Beschreibung des Ereignisses. Der ColdFusion-Server fügt die Position des Fehlers an diese Beschreibung an. Der Server benutzt dann diesen Parameter, falls ein Fehler nicht von Ihrem Code abgefangen wird. ERRORCODE Optional. Ein benutzerdefinierter Fehlercode, den Sie bereitstellen. EXTENDEDINFO Optional. Ein benutzerdefinierter Fehlercode, den Sie bereitstellen.

Verwendung Verwenden Sie CFTHROW innerhalb eines CFTRY-Blocks, um eine Fehlerbedingung auszulösen. Der CFCATCH-Block kann wie folgt auf alle begleitenden Informationen zugreifen: 쐽

auf Nachrichten mit Hilfe von CFCATCH.message,

쐽

auf Detailbeschreibungen mit Hilfe von CFCATCH.detail,

쐽

auf Fehlercodes mit Hilfe von CFCATCH.errorcode.

쐽

Sie erhalten zusätzliche Informationen, indem Sie die Punktnotation CFCATCH.TagContext verwenden. Die Variable TagContext erfaßt den Kontext der Ausnahme; d.h., Name und Position jedes Tags im Tag-Stapel und die vollständigen Pfadnamen der Dateien, in denen die Tags im Tag-Stapel vorkommen.

Hinweis Sie können sich die von TagContext zurückgegebenen Informationen (Tag-Stapel) anzeigen lassen, indem Sie im ColdFusion-Administrator die CFML-Stackverfolgung aktivieren. Aktivieren Sie hierzu im ColdFusion-Administrator auf der Seite Debugging die Option »CFML-Stapelverfolgung aktivieren«.

784

CFTHROW

Beispiel



Sie haben eine Fehlerbedingungausgelöst.< /H3>



Beispiel für CFTRANSACTION

Beispiel für CFTRANSACTION

CFTRANSACTION kann dazu verwendet werden, um mehrere mit CFQUERY erstellte Abfragen zu einem einzelnen Geschäftsereignis zu gruppieren. Ob die von diesen Abfragen angeforderten Datenänderungen in der Datenquelle tatsächlich vorgenommen werden, läßt sich mit Hilfe der Aktionen COMMIT und ROLLBACK in Abhängigkeit von Erfolg oder Mißerfolg der Abfrage entscheiden.

Nachfolgend finden Sie eine Beispielauflistung (siehe Code im rechten Fensterbereich):

787

ColdFusion-Tags









791

ColdFusion-Tags





CFTREE-Datenanzeige Klicken Sie auf die Ordner, um die verborgenen Informationen anzuzeigen.

CFTREEITEM wird zur Erstellung der Ebenen der Struktur verwendet.

...

B.83 CFTREEITEM Verwenden Sie CFTREEITEM, um ein mit CFTREE erstelltes Verzeichnisstruktur-Steuerelement mit einzelnen Einträgen aufzufüllen. Sie können die mit ColdFusion gelieferten IMG-Werte verwenden oder auf Ihre eigenen Symboldateien verweisen.

Hinweis CFTREEITEM verwendet ein Java-Applet, so dass ein Browser Java-fähig sein muss, damit CFTREEITEM richtig funktioniert.

793

ColdFusion-Tags

Syntax

VALUE Zwingend erforderlich. Übergebener Wert bei Übermittlung von CFFORM . Wenn ein CFTREE mit Daten aus einer CFQUERY aufgefüllt wird, werden die Reihen durch Kommas voneinander getrennt in einer Liste aufgeführt. VALUE="AbtID,AngestID"

DISPLAY Optional. Die Beschriftung für das Verzeichnisstruktur-Steuerelement. Standardwert VALUE. Beim Auffüllen von CFTREE mit Daten aus einer CFQUERY werden DISPLAY-Namen durch Kommas voneinander getrennt in einer Liste angegeben: DISPLAY="AbtName,AngestName"

PARENT Optional. Wert für den übergeordneten Eintrag des Verzeichnisstruktur-Steuerelements. IMG Optional. Grafikname oder Dateiname für das Verzeichnisstruktur-Steuerelement. Beim Auffüllen von CFTREE mit Daten aus CFQUERY werden Grafik- oder Dateinamen für jede Strukturebene in einem kommagetrennten Listenformat angegeben. Der Standardgrafikname ist »Folder«. Mit ColdFusion werden eine Reihe von Grafiken mitgeliefert, die nur durch Angabe des Grafiknamens (ohne Dateinamenerweiterung) angegeben werden können: 쐽

cd

쐽

computer

쐽

document

쐽

element

쐽

folder

쐽

floppy

쐽

fixed

쐽

remote

794

CFTREEITEM

Trennen Sie Grafiknamen entsprechend der Verzeichnisstruktur durch Kommata: IMG="folder,document" IMG=",document

Um eine benutzerdefinierte Grafik zu verwenden, geben Sie den Pfad und die Dateinamenerweiterung an: IMG="../images/Seite1.gif"

IMGOPEN Optional. Das für einen offenen Verzeichnisstruktureintrag gezeigte Symbol. Sie können die Symboldatei mit Hilfe eines relativen Pfades angeben. Wie bei IMG können Sie eine der mit ColdFusion gelieferten Grafiken verwenden. HREF Optional. Mit dem Verzeichnisstruktur-Steuerelement zu verknüpfender URL oder eine Abfragespalte für eine Verzeichnisstruktur, die aus einer Abfrage aufgefüllt wird. Wenn HREF eine Abfragespalte ist, wird der angezeigte HREF-Wert von der Abfrage aufgefüllt. Wenn HREF nicht als eine Abfragespalte erkannt wird, wird angenommen, daß der HREF-Text ein aktuelles HTML HREF-Tag ist. Beim Auffüllen von CFTREE mit Daten aus CFQUERY können HREFs in einer kommagetrennten Liste angegeben werden: HREF="http://abtlgs_server,http://angest_server"

TARGET Optional. Zielattribut für HREF URL. Beim Auffüllen von CFTREE mit Daten aus CFQUERY können Ziele in einer kommagetrennten Liste angegeben werden: TARGET="FRAME_Text,_leer"

QUERY Optional. Legt den Namen der Abfrage fest, aus der die Daten für das Verzeichnisstruktur-Steuerelement erzeugt werden. QUERYASROOT Optional. Yes oder No. Definiert die angegebene Abfrage als Stammebene. Wie in Beispiel 1 wird durch diese Option vermieden, ein weiteres übergeordnetes CFTREEITEM-Tag erstellen zu müssen. EXPAND Optional. Yes oder No. Bei Yes wird die Verzeichnisstruktur erweitert, um auch untergeordnete Struktureinträge anzuzeigen. Bei No werden die Struktureinträge minimiert dargestellt. Standard Yes.

795

ColdFusion-Tags

Beispiel



CFTREE-Datenanzeige Klicken Sie auf die Ordner, um die verborgenen Informationen anzuzeigen.

CFTREEITEM wird zur Erstellung der Ebenen der Struktur verwendet.

...

B.84 CFTRY – CFCATCH Wird das CFTRY-Tag zusammen mit CFCATCH-Tags verwendet, können Entwickler Ausnahmen in ColdFusion-Seiten feststellen und verarbeiten. Zu Ausnahmen zählen alle Ereignisse, die den normalen Fluss von Anweisungen auf einer ColdFusion-Seite stören, wie beispielsweise Datenbankvorgänge, fehlende Include-Dateien und von Entwicklern festgelegte Ereignisse.

797

ColdFusion-Tags

Syntax

... Fügen Sie hier Code ein.

... Fügen Sie hier Code zur Verarbeitung von Ausnahmen ein.

... Weitere CFCATCH-Blöcke werden hier eingefügt.

TYPE Optional. Legt den Ausnahmetyp fest, der vom CFCATCH-Block abgewickelt wird: 쐽

APPLICATION (Voreinstellung)

쐽

Database

쐽

Template

쐽

Security

쐽

Object

쐽

MissingInclude

쐽

Expression

쐽

Lock

쐽

Benutzerdefinierter_Typ

쐽

Any (Voreinstellung)

Verwendung Sie müssen in einem CFTRY-Block mindestens ein CFCATCH-Tag angeben. Geben Sie CFCATCH-Tags am Ende des CFTRY-Blocks ein. ColdFusion testet CFCATCH-Tags in der Reihenfolge, in der sie auf der Seite auftreten. Wenn Sie CFCATCH TYPE="ANY" angeben, sollten Sie dies stets im letzten CFCATCH-Tag tun, so daß alle anderen Tests zuerst ausgeführt werden.

Hinweis Wenn Sie TYPE="ANY" angeben, fängt der ColdFusion Application Server Ausnahmen von beliebigen CFML-Tags, Datenquellen oder externen Objekten auf, die Ihre Anwendung möglicherweise abwickeln kann. Anwendungen können zum Auslösen benutzerdefinierter Ausnahmen wahlweise das CFTHROW-Tag verwenden. Solche Ausnahmen werden mit einer der folgenden Typangaben abgefangen: 쐽

TYPE="Benutzerdefinierter_Typ

쐽

TYPE="APPLICATION"

쐽

TYPE="ANY".

798

CFTRY – CFCATCH

Benutzerdefinierter_Typ kennzeichnet den Namen eines vom Benutzer definierten Typs, der mit einem CFTHROW-Tag festgelegt wurde. CFCATCH verfügt über eine Verarbeitungsroutine, die einen benutzerdefinierten Ausnahmetyp durch Mustervergleich abfangen kann. Voraussetzung hierfür ist, daß dieser Typ ist als eine Folge von Strings definiert ist, die mit Punkten verkettet sind, wie in MeineApp.GeschäftsregelAusnahme.UngültigerAccount. CFCATCH beginnt beim Mustervergleich die Suche nach einem passenden benutzerdefinierten Typ beim String auf der untersten Ebene der TypDefinitionshierarchie und beendet sie beim String auf der obersten Ebene (d.h. die Suchrichtung verläuft vom Speziellen zum Allgemeinen). Sie könnten z.B. einen Typ folgendermaßen definieren:

CFCATCH sucht zuerst nach dem gesamten Typ-String, der im CFTHROW-Tag definiert ist:

Anschließend wird auf der nächsten allgemeineren Definitionsebene gesucht:

Zum Schluß wird auf der allgemeinsten Definitionsebene gesucht:

Die Reihenfolge, in der Sie CFCATCH-Tags codieren, die benutzerdefinierte Ausnahmetypen innerhalb einer Anwendung abfangen sollen, spielt keine Rolle. Bei einem CFCATCH-Tag ist die Suche nach benutzerdefinierten Ausnahmetypen vom Speziellen zum Allgemeinen gerichtet. Wenn Sie als Ausnahmetyp »APPLICATION« angeben, fängt das CFCATCH-Tag nur die benutzerdefinierten Ausnahmetypen ab, die im definierenden CFTHROW-Tag als Typ APPLICATION angegeben worden sind. Der Ausnahmetyp TYPE="TEMPLATE" wird von den Tags CFINCLUDE, CFMODULE und CFERROR ausgelöst. Eine in einem CFCATCH-Block ausgelöste Ausnahme wird nicht von dem CFTRY-Block verarbeitet, der unmittelbar an das CFCATCH-Tag grenzt. Sie können jedoch die aktuell aktive Ausnahme mit dem CFRETHROW-Tag erneut zurückgeben. Verwenden Sie die CFCATCH-Variable, um Ausnahmeinformationen abzurufen: 쐽

Type. Der Ausnahmetyp, wie er in CFCATCH festgelegt ist.

쐽

Message. Falls vorhanden, die Diagnosemeldung der Ausnahme. Falls keine Diagnosemeldung verfügbar ist, ist diese Zeichenkette leer.

쐽

Detail. Eine ausführliche Meldung vom CFML-Übersetzer. Diese Nachricht enthält HTMLFormatierungen und kann verwendet werden, um festzulegen, von welchem Tag die Ausnahme ausgelöst worden ist.

쐽

TagContext. Tag-Kontextstapel: Name und Position jedes Tags im Tag-Stapel sowie vollständiger Pfadname der Dateien, die die Tags im Tag-Stapel enthalten. Im Hinweis am Ende dieser Liste finden Sie weitere Informationen.

쐽

NativeErrorCode. Nur bei TYPE=Database. Der systemeigene Fehlercode für diesen Ausdruck. Datenbanktreiber erteilen Fehlercodes, um die Diagnose fehlgeschlagener Datenbankvorgänge zu erleichtern. Wenn kein Fehlercode angegeben wird, ist der Wert von NativeErrorCode gleich -1.

799

ColdFusion-Tags

쐽

SQLSTATE. Nur bei TYPE=Database. Der SQL-Status für diese Ausnahme. Datenbanktreiber erteilen Fehlercodes, um die Diagnose fehlgeschlagener Datenbankvorgänge zu erleichtern. Wenn kein SQL-Status angegeben wurde, lautet der Wert von SQLSTATE gleich -1.

쐽

ErrNumber. TYPE=Expression (ausschließlich). Fehlernummer für internen Ausdruck.

쐽

MissingFileName. TYPE=MissingInclude (ausschließlich). Der Name der nicht enthaltenen Datei.

쐽

LockName. TYPE=Lock (ausschließlich). Der Name der betroffenen Sperre (wird auf »'anonym« gestellt, wenn die Sperre nicht benannt wurde).

쐽

LockOperation. TYPE=Lock (ausschließlich). Die fehlgeschlagene Operation (auf Timeout, Create Mutex oder Unknown gesetzt).

쐽

ErrorCode. Nur bei TYPE=Benutzerdefinierter_Typ. Ein String-Fehlercode.

쐽

ExtendedInfo. Nur bei TYPE=APPLICATION und TYPE=Benutzerdefinierter_Typ. Eine benutzerdefinierte Fehlermeldung.

Hinweis Sie können sich den von der Variablen TagContext zurückgegebenen Tag- Stapel anzeigen lassen, indem Sie im ColdFusion-Administrator die CFML- Stackverfolgung aktivieren. Aktivieren Sie hierzu im ColdFusion Administrator auf der Seite DEBUGGING die Option CFML-STAPELVERFOLGUNG AKTIVIEREN.

Beispiel

#CFCATCH.message#

Es wurde eine Ausnahme vom Typ #CFCATCH.TYPE# abgefangen.

Der Tag-Stapel hat folgenden Inhalt:

Gesamte Liste anzeigen

Sie können den Inhalt dieses Datensatzes ändern und auf die Schaltfläche Abschicken klicken, um mit CFUPDATE die Datenbank zu ändern.

Kursnummer

Kursbeschreibung


#KursInfoAbrufen.Beschreibung#

CFWDDX-Tag

CFML-Daten werden serialisiert...

WDDX-Paket wird deserialisiert...

Die Daten der Datensatzgruppe lauten:...

#Nachrichten_ID# #Thread_ID# #Benutzername#

806

Stichwortverzeichnis Symbols .CFM 32

A

B 172

Abfrage 55, 150 –, sortieren 134 Abfrage-Generator 107 Abfragen 118 ACTION 438 Administratorkennwort 76 Aggregatfunktionen 480 Aktion 169 Aktualisieren –, SQL 298 ALIGN 280 AND 126 Anker 266 Ansicht 100, 491 Anweisung –, bedingte 227 Anwendung 402 Anwendungsseite 32 Anzeigefunktionen 358 append 468 Applets 576 Application.cfm 403, 491 application.log 560 APPLICATIONTIMEOUT 417 Applikation 402 Applikationsvariablen 417 Arrays 393 ArraySet 396 ATTACHMENTS 345 Ausgaben 56, 252 Ausgabevariablen 56 Ausnahmeverarbeitung 572 AutoRespond 333 AutoWert 51 AVG 484

Backend-Applikation 32 BCC 331 Bearbeitungsansicht 209 Bedingung –, zusammengesetzte 127 Benutzerberechtigungen 108 Berechtigungen 108 BETWEEN 129 BGCOLOR 261, 286, 292 BODY 345 BOLD 280 Boolesche Operatoren 125 Browser-Ansicht 210

C

CC 331, 345 CFABORT 574 CFAPPLET 576 CFAPPLICATION 578 CFASSOCIATE 581 CFAUTHENTICATE 582 CFBREAK 584 CFCACHE 585 cfcache.map 587 CFCASE 774 CFCATCH 797 CFCOL 588 CFCOLLECTION 438, 590 CFCONTENT 592 CFDEFAULTCASE 774 CFDIRECTORY 451, 470, 597 –, Attribute 470 CFELSE 231, 664 CFELSEIF 664 CFERROR 600 CFEXECUTE 604 CFEXIT 606 CFFILE 448, 608 –, lesen und schreiben 467

807

Stichwortverzeichnis CFFORM 172, 276, 623 –, Parameter 280 CFForm 201 CFFTP 627 CFGRID 319, 637 –, Parameter 320 CFGRIDCOLUMN 646 CFGRIDROW 651 CFGRIDUPDATE 321, 651 CFHEADER 654 CFHTMLHEAD 655 CFHTTP 656 CFHTTPPARAM 662 CFID 407, 411 CFIF 227, 664 CFIMPERSONATE 666 CFINCLUDE 41, 668 CFINDEX 438, 669 –, Parameter 439 CFINPUT 280, 672 CFINSERT 35, 111, 169, 180 CFLDAP 679 CFLOCATION 685 CFLOCK 686 CFLOOP 380, 388, 693 CFM 32 CFMAIL 328, 700 –, Parameter 331 CFML 43, 201 CFML-Tags –, Überblick 568 CFMODULE 705 CFOBJECT 708 CFOUTPUT 55, 56, 715 CFPARAM 413, 717 CFPOP 328, 343, 720 –, Mail löschen 345 CFPROCESSINGDIRECTIVE 724 CFPROCPARAM 725 CFPROCRESULT 727 CFQUERY 55, 729 CFQUERYPARAM 734 CFREGISTRY 738 CFREPORT 744 CFRETHROW 746 CFSCHEDULE 747

808

CFSCRIPT 751 CFSEARCH 435, 752 CFSELECT 286, 755 –, Parameter 289 CFSERVLET 758 CFSET 241, 382 CFSETTING 765 CFSILENT 766 CFSLIDER 277, 290, 767 –, Parameter 292 CFSTOREDPROC 496, 772 CFSWITCH 774 CFTABLE 253, 777 –, Textmodus 254 CFTEXTINPUT 285, 779 CFTEXTNPUT –, Parameter 286 CFTHROW 783 CFTOKEN 407, 411 CFTRANSACTION 786 CFTREE 313, 788 –, Parameter 316, 317 CFTREEITEM 313, 793 –, Parameter 317 CFTRY 797 CFUPDATE 169, 801 CFWDDX 804 CGI 37 CLIENT 411 Client 42 –, Gültigkeitsbereich 414 –, Statusverwaltung 407 –, Variablen 411, 578 Client/Server 43 CLIENTMANAGEMENT 408 ColdFusion –, einrichten 68 –, Fehler 156 –, Version 70 ColdFusion Administrator 77, 78 ColdFusion Express 73 ColdFusion Markup Language 43, 54 ColdFusion Server –, Varianten 73 ColdFusion Studio 69, 198 –, Komponenten 200

Stichwortverzeichnis

ColdFusion-Anmeldung 82 ColdFusion-Applikation 402 –, Aufbau 48 COLLECTION 393, 438 COLSPAN 261 Common Gateway Interface 37 COMPLETEPATH 317 Cookies 406, 418 COUNT 484 create 470 CreateDate() 369 CreateDateTime() 369 CreateTime() 369 creditcard 284 CRITERIA 435 CurrentRow 436 Custom1 436 Custom2 436

D DATE 345 date 284 DateFormat() 358 Dateien 448 Dateiobjektvariablen 466 Dateiverwaltung 573 Daten –, gruppieren 262 –, importieren 111 Datenausgabe 572 Datenbank 31, 92 –, Datentypen 102 –, Entwurf 99 –, Kommunikation 44 –, Kreuzverweis 51 –, Schlüssel 51 –, Sicherheit 108 –, Tabellen 49 –, Web-Verbindung 48 –, Zeilen 50 Datenbankbearbeitung 572 Datenbankfelder 101 Datenbankoperationen –, SQL 298 Datenbanksoftware 92 Datenbanksuche 44 Datenbearbeitung 352

Datenbeziehungen 51, 105 Dateneingaben 111 Datenfelder 393 Datenquelle 31, 52 –, aktualisieren 72 –, definieren 68 –, einrichten 146 –, überprüfen 83 Datenquellenname 81 Datensatz 50 Datumsfunktionen 369 DB-Verbindungen aufrechterhalten DB-Verbindungen begrenzen 82 Debugger –, interaktiver 558 Debugging 538 DecimalFormat() 360 DELETE 305 delete 470 DELIMITER 317 DESC 136 DESTINATION 453 DIRECTORY 470 DISPLAY 290 DISTINCT 136, 267 DollarFormat() 355, 360 Doppelkreuze 56 Drill-Down-Applikation 148 Druck-und-Fax-Formulare 526 DSN 52

82

E E-Commerce 502 –, Transaktionstypen 524 E-Commerce-Site 503 Einfügen –, SQL 298 Eingaben –, erweiterte 298 Eingabeseiten 276 Einkaufswagen 514 else 231 E-Mail 328 –, Header 343 –, Protokoll 328 E-Mail-Bestellung 525 ENABLECAB 279

809

Stichwortverzeichnis

810

G

ENCTYPE 279 Enterprise Edition 73 Entwicklungszuordnung 210 Entwurfsansicht 210 erlaubte SQL-Operationen 82 error 454 eurodate 284

GetClientVariablesList() 413 GetToken() 365 Großbuchstaben 366 GROUP 263, 332 GROUPCASESENSITIVE 332 Gültigkeitsbereiche 237, 414

F

H

FAQ 334 Fehler –, ColdFusion 156 –, Web-Server 156 Fehlerbeseitigung 538 Fehlermeldungen 539, 544 Felder 31, 50 Feldnamen 50 FILEFIELD 453 Find() 365 FindNoCase() 365 float 284 Flußsteuerung 573 FONT 280 FONTSIZE 280 Footer 39 FORM 276 Formatfunktionen 358 formfields 180 Formularaktionen –, kombinieren 307 Formulare 35, 172 Formular-Tags 571 Frame-Assistent 215 Frames 201 Freigabe 145 FROM 331, 345 FTP-Server 205 Funktion 352 –, Anzeige 358 –, Begrenzer 357 –, Format 358 –, verschachteln 357 Funktionseingabe 356 Funktionsnamen 357 Fußbereich 39, 153

Hash 56 Header 39, 343 HEIGHT 280 HIGHLIGHTREF 316 HitCount 411 Hochladen 448 HSPACE 280 HTML-Dokumente 31 HTML-Markup 43, 55 HTMLTABLE 255 HTMLTABLE-Modus 256 HTTPS 524

I if-then-Konstrukt 228 IMG 292 IMGSTYLE 292 IN 129 Index 427 Index-Link 266 –, dynamisch 267 INSERT 300 Insert() 366 Installation 75 –, Probleme 77 integer 284 International Search Pack 431 Internetprotokoll-Tags 573 Intranet 34 IP-Adressen –, verfolgen 406 IsAuthenticated 583 IsDefined() 413 ITALIC 280

Stichwortverzeichnis

J Java 573 Join –, Tabelle

484

MESSAGENUMBER 345 MIMEATTACH 331, 339 MIN 484 MULTIPLE 290

K

N

Kennwortschutz 234 Key 436 Kleinbuchstaben 366 Kommentar-Tags 149 Kopfbereich 39 Kreuzverweis 51

NAMECONFLICT 455 –, Attribute 454 NotSUPPORTED 280 Now() 300 NumberFormat() 360

L

ODBC 52, 94 –, Quelle 44 –, Treiber 81 Offset 380 ONERROR 280, 290, 292 ONSUBMIT 279 ONVALIDATE 280, 292 Open Database Connectivity Operatoren –, AND 126 –, Boolesche 125 –, logische 125 –, relationale 123 Optionsfelder 281 OR 126 ORDER BY 133, 134 Ordner –, anlegen 145 –, freigeben 145 overwrite 454

LABEL 292 LastVisit 411 LCase() 366 Len() 367 LIKE 132 Links 98, 266 list 470 ListAppend 383 Listen 201, 380 Listenelement 391 Listenwerte lesen 388 ListGetAt() 391 Löschen –, SQL 298 LTrim() 357, 368

M Mail –, Anhang 339 –, Eingang 343 –, löschen 345 –, Protokoll 328 MAILERID 332 Mail-Server –, definieren 332 makeunique 454 Maske 358 MAX 484 MAXLENGTH 286 MAXROWS 331 MESSAGE 286, 290, 292

O

44, 52

P ParagraphFormat() 361 PATH 438 Pfadname 53 POP3 343 PORT 332 Post Office Protocol 343 PRE 254 Primärschlüssel 104 Professional Edition 73 Protokolldateien 84, 560 Protokollierung 84

811

Stichwortverzeichnis

Provider 69 Prozeduren –, gespeicherte

495

Q Quell-URL 215 QUERY 290, 331 QuickBar 201 QuotedValueList 399

R

RANGE 286, 292 RDS-Server 204 read 467 readbinary 467 RecordCount 397, 437 RecordsSearched 437 REFRESHLABEL 292 Remote Development Services 204 rename 470 RepeatString() 368 Replace() 368 REPLYTO 345 REQUIRED 286, 289 Ressourcenbereich 202 Ressourcen-Registerkarten 202 RTrim() 368

S SCALE 292 Schablone 31 Schema 95 Schieberegler 277, 290 Schlüssel 51, 104 Schriftarten 201 Score 436 Secure Hypertext Protocol 524 Secure Socket Layer 524 Seite –, dynamisch 31 –, statisch 31 Seitenanker 266 Seitenindizes 266 SELECT-Abfrage 118 SELECT-Anweisung 119 SELECTED 290

812

Server 42 –, Optionen 79 server.log 560 SESSIONTIMEOUT 417 Setup –, überprüfen 77 Sicherheit –, Datenbank 108 Simple Mail Transfer Protocol 328 Sitzungsvariablen 415 SIZE 289 SMTP 328 social_security 284 Sortieren 134 Spaltenaliase 476 SQL 44, 53, 118 –, Ansichten 491 –, Editor 216 –, Einfügen, Aktualisieren, Löschen 298 –, Unterabfragen 488 SSL 524 STARTROW 332 Steuerzeichen 477 StructFind 393 Structured Query Language 44 Strukturen 391 Strukturschlüssel 391 SUBJECT 331, 345 SUM 484 Summary 436

T

Tabellen 49, 201 –, Ansicht 100 –, Assistent 213 –, Berechtigungen 108 –, Join 484 –, Sicherheit 108 –, Textmodus 254 TABLE 258 Tags 41 –, Abschluß 212 –, CF 54 –, Verarbeitung 43 –, Vorschau 211 –, Werkzeuge 211

Stichwortverzeichnis

TARGET 279 TD 260 telephone 284 Template 32, 54 –, aufbauen 148 –, Datei 31 TEXTCOLOR 286, 292 Textmodus 254 time 284 TimeCreated 411 TimeFormat() 363 TIMEOUT 332 Timeout 417 –, für DB-Anmeldungen 82 Title 436 TO 331, 345 TR 260 Transaktionstypen 524 Treiber 94 TYPE 331

U

UCase() 357, 366 Umgebungsvariablen 37 Unterabfragen 488 UPDATE 302, 304 Upload 448 upload 453 URL 436 –, Syntaxfehler 541 –, Token 411

V

Variablen 56, 226 –, definieren 241 –, Manipulation 573 –, Wertzuweisung 382 Verity 426 –, Datenbanken integrieren Verity-Sammlung 427 –, definieren 430 –, durchsuchen 433 Verknüpfungen 98 Verschachtelung 265 Version 70 VSPACE 280

440

W Web-Applikationsumgebungen Web-Eingabe 111 Web-Server –, Fehler 156 webserver.log 560 Web-Transaktionen 524 WHERE 122 WIDTH 280 Wildcard 59 write 467, 468

574

Y YesNoFormat()

364

Z Zeichenkettenfunktionen Zeilen 50 Zeitfunktionen 369

365

VALIDATE 286 VALUE 290, 292 ValueList 384

813