- baseportal Dokumentation

Titel:

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 Seiten 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:

<codeparse>
get Abfrage, Datenbank, Ergebnis;
</codeparse>

<ul type=square><li>Die Abfrage entspricht den Datenbank-Abfragen bei [42:loop], [38:do] oder über die URL und kann als String oder Referenz auf eine Liste übergeben werden.
<li>Datenbank gibt den Namen der Datenbank an.
<li>Ergebnis bezeichnet einen Hash in dem die resultierenden Datensätze gespeichert werden sollen; standardmässig wird hier der Name der Datenbank genommen.
</ul>

Alle Felder sind optional. Ohne irgendeine Angabe werden die per URL übergebenen Parameter genommen, fehlen auch diese, wird die Datenbank mit dem gleichen Namen der Seite komplett gelesen. Wird nur ein Parameter übergeben, wird die komplette Datenbank mit diesem Namen geholt.

Der erste passende Eintrag wird in Variablen, mit den entsprechenden Feldnamen, gespeichert (wie bei [42:loop], allerdings ohne dass die Werte gefiltert werden).

Beispiele:

<code>
get "KundenNr==32631", "adressen";
out "Name: $Name, Ort: $Ort, Telefon: $Telefon";
</code>

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

<code>
get "Vorname==hans Alter<30 PLZ~=8 range=0,10", "kunden";
</code>

Holt die ersten 10 Kunden mit dem Vornamen "hans", einem Alter unter 30 und aus dem Postleitzahlengebiet mit führender "8".

<code>
get "datenbank";
</code>

Holt den kompletten Inhalt der Datenbank (Sortiert nach der <c>Id</c>. Die Abfrage lautet also: <c>Id==*</c>).

<h2>Abfrage über eine Liste</h2>

Es kann passieren, dass man Zeichen zur Abfrage benutzen will, die eine spezielle Bedeutung haben, wie das Leerzeichen zur Trennung von Abfragen oder das <c>|</c>-Zeichen, was für eine Oder-Verknüpfung steht. Diese kann man entweder mit dem <c>\</c> "entschärfen" oder die zweite Form von <c>get</c> benutzen:

<code>
get ["Name", "==!", "Stefan Klamm", "&", "URL", "==", $URL], "zugriffe";
</code>

Holt alle Einträge mit "Name" genau "Stefan Klamm" und "URL" gleich der Variablen <c>$URL</c>. Diese kann beliebige Zeichen wie <c>|</c> oder <c>&</c> etc. enthalten.

Hier erfahren Sie mehr über das [63:Maskieren von Sonderzeichen].

Sie können auch die Abfrage vorher in einer Liste speichern und dann über eine Referenz an <c>get</c> übergeben:

<code>
my @query;
for(my $i=0; $i<21; $i+=3)
{
 push @query, "Wert", "==", $i, "|";
}
get \@query, "datenbank";
</code>

Holt alle Einträge bei denen das Feld "Wert" den Inhalt 0, 3, 6, 9, 12, 15 oder 18 hat.

Um bei der Verwendung einer Liste eine Sortierung oder einen Bereich zu übergeben, müssen Sie dies über die speziellen Variablen <c>$_get_range</c> und <c>$_get_sort</c> übergeben:

<code>
$_get_range="10,20"; $_get_sort="-";
get ["Name", "==!", $name], "db";
</code>

Holt die Einträge 10 bis 30 mit dem Feld Name die genau <c>$name</c> enthalten, in umgekehrter Reihenfolge sortiert. <c>$name</c> kann auch Leerzeichen enthalten.

Um nach dem <c>get</c> der Reihe nach alle gefundenen Einträge zu durchlaufen, benötigt man den Befehl [1393:get_next].

Name: Passwort: Stichworte: Version: 1 2 3 Angebot:

Ohne Änderungen zurück zur Seite

Neue Seite erstellen