Variablen - baseportal Dokumentation

Variablen sind "Platzhalter" für Werte und werden wie in vielen Programmiersprachen eingesetzt. Einfache Variablen beginnen mit dem $-Zeichen und müssen mit einem Buchstaben beginnen, gefolgt von weiteren Buchstaben, Zahlen oder Unterstrichen (Beispiele: $Text, $Mein_Name, $urx_123). Inhalte von Variablen können beliebig lang sein und aus Zahlen, Texten oder beliebigen anderen Zeichen bestehen.

Die über eine URL oder in einem baseportal-Tag angegebenen Parameter werden automatisch als Variablen zur Verfügung gestellt.

Beispiele:

<perl>
out "Zähler: ",$cnt++,"<p>";
out '<a href="/cgi-bin/baseportal.pl?htx=/zaehler&cnt=',$cnt,'">Weiter';
</perl>

Dieses Code-Stück fungiert als Zähler. Jeder Klick auf "Weiter" erhöht die Zahl um 1. Dies geschieht durch die Variable $cnt, deren Wert durch den Parameter in der URL weitergegeben wird und im Template zur Verfügung steht.

Pfiffig ist der Einsatz von Variablen, um HTML-Bausteine individuell anzupassen:

<h2 align=center>$Text</h2>

Die Variable $Text wird nun mit dem aktuellen Wert ersetzt. Angenommen obige Zeile wird im Template titel gespeichert, so führt der Einbau in eine andere Seite durch...

<include src=titel Text=Einleitung>

...zu folgender Ausgabe:

Einleitung

Spezialvariablen

Eine Reihe von Werten werden von baseportal in Spezialvariablen bereitgehalten. Sie beginnen immer mit einem Unterstrich "_". Obwohl es möglich ist, sollten Sie also auf eigene Variablen, die mit einem Unterstricht beginnen, verzichten.

Datenbank-Abruf:

Variable	Bedeutung
$_db	Name der zuletzt genutzten Datenbank
$_id	ID des Datensatzes
$htx	zuletzt aufgerufenes Template "baseportal.pl?htx=$htx"
$_loop	fortlaufende Nummer der geholten Datensätze
$_range	Ausgabebereich Start
$_range_length	Ausgabebereich Anzahl
$_amount	Anzahl Datensätze die beim letzten Abruf tatsächlich geholt wurden.
$_amount_query	Anzahl Datensätze die beim letzten Abruf ohne "range" geholt worden wären.
$_amount_all	Anzahl Datensätze die in der zuletzt genutzten Datenbank insgesamt enthalten sind

Parameter und Abfragewerte:

Variable	Bedeutung
%_cgi	Werte die über CGI (GET oder POST) mit "=" übergeben wurden(z.B. Farbe=Rot)
%_get	Werte die über CGI, in Tags oder über eine Datenbank-Abfrage gesetzt wurden (z.B. Farbe=Rot)
%_sel	Abfragewerte (z.B. Name==a)
%_put	Zu schreibende Werte (z.B. Name:=Hans)
%_put_last	Tatsächlich geschriebene Werte
$_put_id	ID des zuletzt geschriebenen Datensatzes
%_raw	Ungefilterte Ausgabe von Feldern (z.B. bei Datum, Link oder Email) - man erhält den tatsächlichen Inhalt des Feldes
%_loop	Enthält den aktuellen Datensatz bei `<loop>` oder `get; get_next();`
$_user	Name des angemeldeten Nutzers. Definiert leer, wenn Anmeldung fehlgeschlagen
%_user	Feldinhalte der Nutzer-Datenbank des angemeldeten Nutzers

Durch %_cgi und %_get können auch Parameter abgefragt werden, die nicht über Variablen zugänglich sind, weil sie für Variablennamen unzulässige Zeichen enthalten (z.B: Leerzeichen, Sonderzeichen usw.) oder weil Sie durch eigene Variablen überschrieben wurden. Beispiele: $_get{"Mein Name"}; $_cgi{"12345"};