get / get_next (Datenbank abfragen)

Baseportal stellt spezielle Befehle zur Behandlung von Datenbanken bereit. Sie erlauben den Abruf, das Hinzufügen, Ändern oder Löschen von Datensätzen. Da Sie diese Befehle in Templates einsetzen, die nur Sie verändern können, haben Sie mit diesen Befehlen immer Zugriff auf alle Ihre Datenbanken - unabhängig davon, wie die Rechte dieser Datenbanken gesetzt sind.

Definition:

get ~Abfrage~, ~Datenbank~, ~Ergebnis~;

Alle Felder sind optional. Ohne irgendeine Angabe werden die per URL übergebenen Parameter genommen, fehlen auch diese, wird die gleichnamige Datenbank (wie das Template) komplett gelesen. Die Abfrage entspricht den Datenbank-Abfragen bei "loop", "do" oder über die URL und kann als String oder Referenz auf eine Liste übergeben werden. Datenbank gibt den Namen der Datenbank an. Ergebnis bezeichnet einen "Hash" in dem die resultierenden Datensätze gespeichert werden sollen; standardmässig wird hier der Name der Datenbank genommen.

Der erste passende Eintrag wird in Variablen, mit den entsprechenden Feldnamen, gespeichert (genau wie bei loop).

Beispiele:

get "KundenNr==32631", "adressen";

out "Name: $Name, Ort: $Ort, Telefon: $Telefon";

Holt alle Datensätze bei denen "KundenNr" den Wert "32631" besitzt aus der Datenbank "adressen" und gibt den ersten davon aus.

Hiermit lässt sich ein individueller Zugangsschutz sehr einfach realisieren:

get "Name==!$namerein", "nutzer";

if($Passwort ne "" && $Passwort eq $passwortrein)
{
  # Hier die Ausgabe der eigentlichen Datenbank
  # z.B. mit get_next (s.unten)
} else
{
  out "Zugang verboten!";
}

Holt aus der Datenbank "nutzer" den passenden Nutzer mit dem per URL oder Formular übergebenen "namerein". Der Wert des Feldes "Passwort" wird dann mit dem ebenfalls per URL oder Formular übergebenen "passwortrein" verglichen. Stimmen beide überein wird z.B. eine Datenbank ausgegeben, wenn nicht, erfolgt die Ausgabe "Zugang verboten!". Achten Sie darauf, dass die Datenbank "nutzer" keinerlei Rechte für Aussenstehende hat!

Um an mehrere passende Einträge zu kommen, benötigt man einen weiteren Befehl:

getnext

Definition:

get_next ~Ergebnis~;

Holt den nächsten Datensatz von Ergebnis und speichert ihn in Variablen, mit den entsprechenden Feldnamen. Ohne Angabe von Ergebnis wird die zuletzt abgerufene Datenbank genommen.

Beispiele:

get;

while(get_next)
{
  out "Name: $Name - Auto: $Auto<br>";
}

Holt alle Datensätze der zum Template gehörigen oder per URL übergebenen Datenbank und gibt sie aus.

Mehrere Abrufe per "get" und "get_next" können verschachtelt werden:

get "Id==*", "kunden";

while(get_next("kunden"))
{
  out "Kunde: $Name<br>";

  get "Name==$Auto", "autos";

  out "Auto: $Name<br>";
  out "Beschreibung: $Beschreibung<p>";
}

Hier wurde eine Relation zwischen den beiden Datenbanken kunden und autos hergestellt. Jeder Datensatz eines Kunden enthält ein Feld Auto mit dem Autonamen des Kunden. Dieser Wert wird verwendet, um den passenden Eintrag aus der Datenbank autos zu holen und die Beschreibung für dieses Auto auszugeben.

Sie können auch verschiedene Abfragen derselben Datenbank speichern. Zur Unterscheidung dient der Ergebnis-Parameter:

get "Name~=a", "kunden";

get "Name~=b", "kunden", "kmitb";

out "Alle Kunden mit a:<p>";
while(get_next("kunden"))
{
  out "Kunde: $Name<br>";
}

out "<hr>Alle Kunden mit b:<p>";
while(get_next("kmitb"))
{
  out "Kunde: $Name<br>";
}

Zuerst werden alle Datensätze, die mit a beginnen aus der Datenbank kunden geholt und im gleichnamigen Ergebnis gespeichert. Dann werden alle Datensätze, die mit b beginnen im Ergebnis kmitb gespeichert. Schliesslich werden beide Ergebnisse in entsprechenden Schleifen mit get_next ausgegeben.