zusätzliche Tags |
dburl | Enthält die gewünschte Datenbank |
dbschema | Hier kann ein Datenbankschema angegeben werden. |
dbuser | Der anzumeldende Benutzer |
dbpasswd | Das Passwort Diese ersten Tags werden allerdings nicht mit ausgegeben und erscheinen nur im Template. Alle vier Angaben stehen im Dokumenten-Header. |
<dbstmt> </dbstmt> | Dieser Tag klammert das SQL-Statement. Bei 'out'-Templates wird der Befehl um die beim Aufruf übergebenen Parameter erweitert. Wird z. B. 'id_=100' übergeben, so wird das Statement um diese Angabe ergänzt. Dies gilt auch, wenn der Befehl mit ORDER BY oder GROUP BY abgeschlossen wurde. Alle variablen SQL-where clause Argumente brauchen also nicht im Statement berücksichtigt werden, sie fließen durch den Server automatisch ein.
Im in-Statement müssen an diesere Stelle die gewünschten Feldwerte markiert werden. Dies geschieht in der Form: '##feld##'. Soll z. B. ein Name geändert werden, so steht im Statement 'set name_ = ##name_##'. Die Referenz 'name_' muß bei der Parameterübergabe in Form von 'name_=DerName' vorkommen, sie wird dann vom Server eingesetzt.
Manchmal kommt es vor, daß numerische Werte in ein Textfeld übernommen werden sollen (z.B. Postleitzahlen). Beim Input kann deswegen eine alphanumerische Behandlung erzwungen werden, wenn bei Variablenübergabe ',c' eingefügt wird (z.B. ##plz_,c## siehe adrupd.shtml).
Große Textströme verursachen manchmal Probleme, wenn sie als String übergeben werden. Deshalb kann man sie bei der Eingabe als ASCII-Stream kennzeichnen (z.B. ##longtext_,a## siehe adrupd.shtml). |
<dbcall> </dbcall> | Innerhalb dieser Tags steht ein Aufruf einer Stored Procedure.
Sie auch dazu Arbeitsweise. |
dbmaxrow | Wieviel Zeilen sollen ausgegeben werden? |
dbinclude | Es lassen sich an dieser Stellen wiederkehrende Texte aufrufen. |
<dbdata> </dbdata> | Zwischen diesen Tags stehen die wiederkehrenden Ausgaben des SQL-Statement. Solange Daten vorhanden sind, wird z. B. eine Liste gefüllt. Dazu wird wieder eine Referenz eingefügt in Form von '##name_##', die zur Laufzeit vom Server mit dem Inhalt vom Feld 'name_' gefüllt wird. Da nicht immer die Feldnamen bekannt sind, kann auch als Ersatz '##1##' für das erste Ausgabefeld angegeben werden. |
<dbdata txt="no data"> | Zusätzlich kann in 'dbdata' ein Text für die Ausgabe definiert werden, der erscheinen soll, wenn keine Daten vorhanden sind. |
<dbbreak col=???> </dbbreak> | Eine Ausgabe kann durch 'dbBreak' gruppiert werden. Dazu wird als Parameter das Feld für die Bündelung benötigt. In der Klammer stehen dann alle zusammengehörigen Werte. 'dbBreak' kann auch geschachtelt werden. |
<dbbreak typ=mail col=???> </dbbreak> | Eine spezielle Art von Gruppierung ist der Mailtyp. Die Daten innerhalb dieser Tags werden versandt, wenn aller Rahmenbedingung erfüllt sind.
Im Debug-Modus werden die Daten auf der Konsole ausgegeben. Wenn der Mailhost nicht angegeben wird, werden die Daten in der HTML-Ausgabe angezeigt. |
<dbmailto=???>
<dbmailsubject=???> | Zusätzliche Variablen, die für eine Mail gefüllt sein müssen. |
dbsub | Erlaubt es, zusätzliche Datenbankabfragen einzubauen. Diese Tag kann nicht innerhalb von 'dbdata' stehen. |
##dbrownum## | dbrownum ist ein spezielle Variable mit der die Zeilennummer ausgegeben werden kann. Sie wird benutzt wie ein Feldvariable. |
##dbrowplus## | dbrowplus ist dbrownum plus eins. Sie wird benutzt wie ein Feldvariable. |
##dbrowminus## | dbrowminus ist dbrownum minus eins. Sie wird benutzt wie ein Feldvariable. |
##dbswaprow txt1="???" txt2="???"## | dbswaprow ermöglicht die unterschiedliche Gestaltung jeder zweiten Zeile. |
##dbtan## | dbtan gibt eine Transaktionsnummer aus. Dazu muß bei der Parameterübergabe beim ersten Aufruf ein Aktivierung durch 'dbtan=0' geschehen. In allen folgenden Scripten muß die Transaktionsnummer dann wieder übergeben werden, damit die Transaktion gültig bleibt. Es wird bei jedem Aufruf die Gültigkeit (vergangene Zeit und aufrufender Host) geprüft. Die Zeit der Gültigkeit wird über die Ini-Datei festgelegt. |
dbtanrequired | Bestimmt, daß eine Seite eine dbtan benötigt. |
dbfirstrow dbnextrow | Mit diesen beiden Variablen können die Ausgaben zusätzlich beschränkt werden. Z.B. <INPUT TYPE=HIDDEN NAME=dbfirstrow VALUE="5"> startet die Ausgabe erst ab dem 5. Datensatz. |
&dbvar=???; dbfirstrow dbnextrow dbprevrow dblastrow | Dieser Variablenaufruf stehen außerhalb von <dbdata>. Z.B. <INPUT TYPE=HIDDEN NAME=dbfirstrow VALUE="&dbvar=dbprevrow;"> füllt die vorherige Zeilennummer ein. Diese wird berechnet aus 'dbfirstrow' und 'dbmaxrow'. Wenn also dbfirstrow gleich 4 ist und dbmaxrow gleich 3, dann ist dbprevrow gleich 1. (siehe Beispiel liste.shtml) 'dblastrow' gibt die letzte ausgegebene Zeile aus. |
<dbnocache> | Mit dieser Anweisung im Header werden Templates nicht zwischengespeichert. |
##dbnow## | dbnow gibt das Datum aus. Ein Aufruf mit 'form' formatiert das Datum. Beispiel: ##dbnow form="MM.yy"## gibt Monat und Jahr zurück. Es gelten die Java-Konventionen für das Datumsformat. |
dbprocesswriter | dbprocesswriter legt für das Template einen abweichenden Writer fest. Diese Angabe muß vor der ersten Ausgabe geschehen. Z.B. <!-dbprocesswriter="de.dbServ.writer.dbMyWriter"-> ändert die Voreinstellung dbSimpleWriter. |
log | Name des Logfiles |
debug | Name des Debugfiles |
error | Name des Errorfiles |
blog | Logfile ein-/ausschalten |
bdebug | Debugfile ein-/ausschalten |
berror | Errorfile ein-/ausschalten |
use_xy | Übergabeparameter x/y benutzen (ein/aus). Wird bei der Gestaltung einer Seite ein Image als Button benutzt, übergibt der Client die x/y-Werte zusätzlich. Bei der IN-Methode für dies zu unerwünschten Nebeneffekten. |
use_gui | Soll eine Dialogbox vom Server angezeigt werden oder nicht. |
pub | Der Pfad zu den Templates |
timeout | Wartezeit für den Socket in Sekunden |
tanalive | Lebenszeit für eine Transaktionsnummer in Minuten |
admin | Name für den Administrator |
passwd | Password für den Administrator |
counturl | Datenbank-Url für die counter-Datenbank |
counttime | Lebenszeit für das angezeigte Bitmap (0 = nocache) |
countdateformat | Datumsformat für die Speicherung der Counterdaten |
counttimeformat | Zeitformat für die Counterdatenbank |
mailhost | Name des Mailhosts, bliebt dieser Wert leer, wird der Text in der HTML-Ausgabe angezeigt und nicht versandt. |
mailfrom | Email des Absenders |
cachedir | Verzeichnis für die Cachedateien |
cachealive | Lebenszeit für ein Cachedatei in Minuten, wird dieser Wert auf '0' gesetzt, wird nicht gecachet. |
writer | setzt den Default für die Ausgabe. |
[driver] | Abteilung für die benötigten Datenbank-Treiber
Die Treiber werden einfach untereinander aufgelistet. |
com.mm.mysql.Driver | Beispiel für einen Treiber |