baseportal Dokumentation

Titel:

Bitte beachten: Diese Funktion steht in der Lizenzversion nicht zur Verf&uuml;gung.

baseportal bietet die auf den ersten Blick verblüffende Möglichkeit, beliebige baseportal-Funktionen (perl, php, loop etc.) erst im Browser bei der Anzeige der Seite auszuführen. Natürlich steckt dahinter ein kleiner Trick: In Wirklichkeit wird eine Verbindung zum Server hergestellt, der den Code ausführt und das Ergebnis zurückschickt. Auch Parameter können beim Aufruf übermittelt werden, die dann wie gewohnt bereitstehen.

<h2>Beschreibung</h2>
Durch den Parameter script=... wird baseportal angewiesen, einen Befehl nicht wie sonst sofort, auf dem Server, auszuführen. Stattdessen wird eine Javascript-Funktion mit dem bei script angegebenen Namen bereitgestellt. Im Browser kann diese Funktion nun ganz normal wie in Javascript üblich aufgerufen werden. Sodann verbindet sich diese im Hintergrund mit der aufrufenden Seite, führt den Befehl aus und schickt das Ergebnis an eine Rückgabe-Funktion zurück. Der Name dieser Funktion kann über den Parameter return definiert werden. Gibt es diesen Parameter nicht, so heisst die Rückgabe-Funktion automatisch wie die über script definierte mit Unterstrich davor. Die Kommunikation mit dem Server läuft dabei "asynchron" ab, d.h. während auf das Ergebnis gewartet wird, bleibt der Browser nicht stehen, sondern es können weitere (Javascript-)Aktionen ausgeführt werden.

An die Sende-Funktionen können optional bis zu 3 Parameter übergeben werden:
<table style="border:1px #e0e0e0 solid;margin-top:6px">
<tr><td width=100>query</td><td>Parameter die per URL übergeben werden (CGI GET)</td></tr>
<tr><td>post</td><td>Daten die über HTTP-Post gesendet werden (CGI POST)</td></tr>
<tr><td>requestHeader</td><td>Parameter die im HTTP-Header gesetzt werden sollen</td></tr>
</table>
In den allermeisten Fällen reicht die Übergabe über die URL, also die Angabe des 1. Parameters, aus. Nur bei sehr grossen Formular-Daten (z.B. Texteingabefelder) müssen diese wegen der Längenbeschränkung von URLs über post gesendet werden.

An die Rückgabe-Funktion werden 3 Parameter übergeben, die nach Bedarf ausgewertet werden können:
<table style="border:1px #e0e0e0 solid;margin-top:6px">
<tr><td width=100>responseText</td><td>Die Rückgabe als einfacher Text</td></tr>
<tr><td>responseXML</td><td>Die Rückgabe als XML-Daten (müssen entsprechend gesendet werden)</td></tr>
<tr><td>status</td><td>Der Statuswert der Rückgabe. Enthält 200 wenn alles Ok ist, sonst den HTTP-Fehlercode</td></tr>
</table>

<h2>Beispiele</h2>
Das folgende Beispiel übersetzt deutsche Begriffe ins Englische - sofort bei der Eingabe:
<pre style="border:1px #e0e0e0 solid;background-color:#f0f0f0;padding:8px">
&lt;loop script=getname range=0,10 db=/_bib/dict_de_en/dict_de_en&gt;
$Deutsch - $English&lt;br&gt;
&lt;/loop&gt;

&lt;script&gt;
function _getname(x)
{
  document.getElementById(&quot;out&quot;).innerHTML=x;
}
&lt;/script&gt;

&lt;form&gt;

Begriff: &lt;input type=text onkeyup=&quot;getname('Deutsch~='+this.value)&quot;&gt;
&lt;/form&gt;

&lt;div id=&quot;out&quot; width=500 height=200 style=&quot;border:1px solid red&quot;&gt;&lt;/div&gt;</pre>

Wie man sieht ist der Code denkbar einfach: Durch den Parameter script=... wird das &lt;loop&gt;..&lt;/loop&gt; nicht auf dem Server ausgeführt. Stattdessen wird die Javascript-Funktion getname bereitgestellt, die bei jedem Tastendruck in einem Textfeld aufgerufen wird. Der Inhalt des Textfeldes wird als Parameter übergeben. Erst wenn der Nutzer einen Buchstaben eingibt wird das loop ausgeführt und fragt im Beispiel das Deutsch/Englisch-Wörterbuch ab. Nach Beendigung wird die Callback-Funktion _getname (da wir keinen anderen Namen mit return= angegeben haben) in Javascript aufgerufen und das Ergebnis als Parameter übergeben. Dieses wird einfach in einen div-Container geschrieben und somit angezeigt.
 
 Hier ist das Beispiel in Aktion: <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/loop" target="_blank">http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/loop</a>
 
Ebenso kann Perl oder PHP als Javascript-Funktion definiert werden. Hier ein PHP-Aufruf:

<pre style="border:1px #e0e0e0 solid;background-color:#f0f0f0;padding:8px">
&lt;php script=phpversion&gt;
out(&quot;PHP-Version: &quot;.phpversion());
&lt;/php&gt;

&lt;script&gt;
function _phpversion(x)
{
  alert(x)
}
&lt;/script&gt;

&lt;input type=button value=&quot;PHP-Version&quot; onclick=&quot;phpversion()&quot;&gt;
</pre>

Aufruf: <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/php" target="_blank">http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/php</a>

Und hier ein kleines Perl-Skript das eine Bankverbindung auf Gültigkeit überprüft - sofort, während der Eingabe:
<pre style="border:1px #e0e0e0 solid;background-color:#f0f0f0;padding:8px">
&lt;perl script=kontocheck&gt;
$result=&amp;KontoCheck($kto, $blz);
out &quot;Konto: $kto&lt;br&gt;BLZ: $blz&lt;br&gt;Ergebnis: $result&lt;br&gt;Bank: $Name&lt;br&gt;PLZ: $PLZ&lt;br&gt;Ort: $Ort&quot;;
&lt;/perl&gt;

&lt;script&gt;
function _kontocheck(r)
{
  document.getElementById(&quot;out&quot;).innerHTML=r;
}
&lt;/script&gt;

&lt;p&gt;
Konto-Nr.: &lt;input type=text id='kto' onkeyup=&quot;kontocheck('kto='+this.value+'&amp;'+'blz='+document.getElementById('blz').value)&quot;&gt;&lt;br/&gt;

BLZ: &lt;input type=text id='blz' onkeyup=&quot;kontocheck('kto='+document.getElementById('kto').value+'&amp;'+'blz='+this.value)&quot;&gt;&lt;br/&gt;
&lt;p/&gt;

&lt;div id=&quot;out&quot; width=500 height=200 style=&quot;border:1px solid red&quot;&gt;&lt;/div&gt;
</pre>

Aufruf: <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/perl" target="_blank">http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/perl</a>

Und natürlich kann auch die komplette Datenbank-Ausgabe als Javascript-Funktion verwendet werden:

<pre style="border:1px #e0e0e0 solid;background-color:#f0f0f0;padding:8px">
&lt;do action=all db=/baseportal/forum script=database&gt;

&lt;script&gt;
function _database(x)
{
  document.getElementById(&quot;out&quot;).innerHTML=x;
}
&lt;/script&gt;

&lt;loop sort=- range=0,10 db=/baseportal/forum&gt;
&lt;div onmouseover='database(&quot;cmd=all&amp;Id=$_id&quot;)'&gt;$Name - $Titel&lt;/div&gt;

&lt;/loop&gt;

&lt;div id=&quot;out&quot; width=500 height=200 style=&quot;border:1px solid red&quot;&gt;&lt;/div&gt;
</pre>

Hier werden die neuesten 10 Einträge mit Namen und Titel als Liste ausgegeben und beim Darüberfahren mit der Maus, wird der jeweilige Eintrag im Detail gezeigt.

Aufruf: <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/do_all" target="_blank">http://baseportal.de/cgi-bin/baseportal.pl?htx=/baseportal/Projekte/ajax/do_all</a>

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

Ohne Änderungen zurück zur Seite

Neue Seite erstellen