baseportal Dokumentation

Titel:

<table>
  <tr>
    <font face="arial" size="2">
    <td><font face="arial" size="2">
        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.
        <p>&nbsp;
        <p><b>Definition:</b>
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3"><code>get <i>Abfrage</i>, <i>Datenbank</i>,
                <i>Ergebnis</i>;</code></font></td>
            </tr>
          </tbody>
        </table>
        <br>
        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 <i>Abfrage</i>
        entspricht den Datenbank-Abfragen bei &quot;loop&quot;, &quot;do&quot;
        oder über die URL und kann als String oder Referenz auf eine Liste
        übergeben werden. <i>Datenbank</i> gibt den Namen der Datenbank an. <i>Ergebnis</i>
        bezeichnet einen &quot;Hash&quot; in dem die resultierenden Datensätze
        gespeichert werden sollen; standardmässig wird hier der Name der
        Datenbank genommen.
        <p>Der erste passende Eintrag wird in Variablen, mit den entsprechenden
        Feldnamen, gespeichert (genau wie bei <a
        href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/hilfe/baseportal/db_help&help=47">loop</a>).
        <p><b>Beispiele:</b>
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3"><p><code>get
                &quot;KundenNr==32631&quot;, &quot;adressen&quot;;<br>
                out &quot;Name: $Name, Ort: $Ort, Telefon: $Telefon&quot;;</code></p>
                </font></td>
            </tr>
          </tbody>
        </table>
        <br>
        Holt alle Datensätze bei denen &quot;KundenNr&quot; den Wert
        &quot;32631&quot; besitzt aus der Datenbank &quot;adressen&quot; und
        gibt den ersten davon aus.
        <p>Hiermit lässt sich ein individueller Zugangsschutz sehr einfach
        realisieren:</p>
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3"><p><code>get
                &quot;Name==!$namerein&quot;, &quot;nutzer&quot;;<br>
                if($Passwort ne &quot;&quot; && $Passwort eq
                $passwortrein)<br>
                {<br>
                &nbsp;&nbsp;# Hier die Ausgabe der eigentlichen Datenbank<br>
                &nbsp;&nbsp;# z.B. mit get_next (s.unten)<br>
                } else<br>
                {<br>
                &nbsp;&nbsp;out &quot;Zugang verboten!&quot;;<br>
                }</code></p>
                </font></td>
            </tr>
          </tbody>
        </table>
        <br>
        Holt aus der Datenbank &quot;nutzer&quot; den passenden Nutzer mit dem
        per URL oder Formular übergebenen &quot;namerein&quot;. Der Wert des
        Feldes &quot;Passwort&quot; wird dann mit dem ebenfalls per URL oder
        Formular übergebenen &quot;passwortrein&quot; verglichen. Stimmen beide
        überein wird z.B. eine Datenbank ausgegeben, wenn nicht, erfolgt die
        Ausgabe &quot;Zugang verboten!&quot;. Achten Sie darauf, dass die
        Datenbank &quot;nutzer&quot; keinerlei Rechte für Aussenstehende hat!
        <p>Um an mehrere passende Einträge zu kommen, benötigt man einen
        weiteren Befehl:
        <h3>get_next</h3>
        <p><b>Definition:</b>
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3">
              <code>get_next <i>Ergebnis</i>;</code></font></td>
            </tr>
          </tbody>
        </table>
        <br>
        Holt den nächsten Datensatz von <i>Ergebnis</i> und speichert ihn in
        Variablen, mit den entsprechenden Feldnamen. Ohne Angabe von <i>Ergebnis</i>
        wird die zuletzt abgerufene Datenbank genommen.
        <p>&nbsp;
        <p><b>Beispiele:</b></p>
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3"><p><code>get;
                while(get_next)<br>
                {<br>
                &nbsp;&nbsp;out &quot;Name: $Name - Auto: $Auto&lt;br&gt;&quot;;<br>
                }</code></p>
                </font></td>
            </tr>
          </tbody>
        </table>
        <br>
        Holt alle Datensätze der zum Template gehörigen oder per URL
        übergebenen Datenbank und gibt sie aus.
        <p>Mehrere Abrufe per &quot;get&quot; und &quot;get_next&quot; können
        verschachtelt werden:
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3">
              	<p><code>get &quot;Id==*&quot;,
                &quot;kunden&quot;;<br>
                while(get_next(&quot;kunden&quot;))<br>
                {<br>
                &nbsp;&nbsp;out &quot;Kunde: $Name&lt;br&gt;&quot;;<br>
                &nbsp;&nbsp;get &quot;Name==$Auto&quot;, &quot;autos&quot;;<br>
                &nbsp;&nbsp;out &quot;Auto: $Name&lt;br&gt;&quot;;<br>
                &nbsp;&nbsp;out &quot;Beschreibung: $Beschreibung&lt;p&gt;&quot;;<br>
                }</code></p>
                </font></td>
            </tr>
          </tbody>
        </table>
        <br>
        Hier wurde eine Relation zwischen den beiden Datenbanken
        &quot;kunden&quot; und &quot;autos&quot; hergestellt. Jeder Datensatz
        eines Kunden enthält ein Feld &quot;Auto&quot; mit dem Autonamen des
        Kunden. Dieser Wert wird verwendet, um den passenden Eintrag aus der
        Datenbank &quot;autos&quot; zu holen und die Beschreibung für dieses
        Auto auszugeben.
        <p>&nbsp;
        <p>Sie können auch verschiedene Abfragen derselben Datenbank speichern.
        Zur Unterscheidung dient der &quot;Ergebnis&quot;-Parameter:
        <p>&nbsp;
        <table cellpadding="10" width="90%">
          <tbody>
            <tr>
              <td bgcolor="#f0f0f0"><font size="3"><p><code>
              get &quot;Name~=a&quot;, &quot;kunden&quot;;
                get &quot;Name~=b&quot;, &quot;kunden&quot;,
                &quot;kmitb&quot;;<br>
                out &quot;Alle Kunden mit a:&lt;p&gt;&quot;;<br>
                while(get_next(&quot;kunden&quot;))<br>
                {<br>
                &nbsp;&nbsp;out &quot;Kunde: $Name&lt;br&gt;&quot;;<br>
                }<br>
                out &quot;&lt;hr&gt;Alle Kunden mit b:&lt;p&gt;&quot;;<br>
                while(get_next(&quot;kmitb&quot;))<br>
                {<br>
                &nbsp;&nbsp;out &quot;Kunde: $Name&lt;br&gt;&quot;;<br>
                }
                </code></p>
                </font></td>
            </tr>
          </tbody>
        </table>
        <br>
        Zuerst werden alle Datensätze, die mit &quot;a&quot; beginnen aus der
        Datenbank &quot;kunden&quot; geholt und im gleichnamigen Ergebnis
        gespeichert. Dann werden alle Datensätze, die mit &quot;b&quot;
        beginnen im Ergebnis &quot;kmitb&quot; gespeichert. Schliesslich werden
        beide Ergebnisse in entsprechenden Schleifen mit &quot;get_next&quot;
        ausgegeben.
        <p>&nbsp;</p>
      </font></td>
    </font>
  </tr>
</table>
<style type="text/css"> 
 
</style>
<p class=z_titel>Hinweis / Tipp</p>
<p>Wenn Sie mehrere Datenbankaufrufe auf einer Seite haben, dann muss zur Gewährleistung einer reibungslosen Funktion unbedingt die Angabe des Namens für die Ergebnismenge, der sogenannte Ergebnishash, angegeben werden.<br>
Nur so kann Baseportal "wissen", welche Daten zu welcher Datenbank gehören.<br>
Wenn Sie dies vergessen, werden Sie u.U. nicht reproduzierbare Fehlausgaben bzw. Fehlfunktionen hervorrufen.</p>
<p class=grau><span class=klein>(die bei Zusammentreffen mehrerer Faktoren sogar bis zum Datenverlust führen können, zumindest aber das Speichern/Ändern mittels <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/doku/wiki&uid=hempelr&sid=4435588.3685979.95587797.9143175&kennung=50">put</a> bzw. <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/doku/wiki&uid=hempelr&sid=4435588.3685979.95587797.9143175&kennung=51">mod</a> verhindern)</span>
<p>Es ist aus diesem Grund immer anzuraten, sich anzugewöhnen, den Ergebnishash in jedem Falle beim 
<a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/doku/wiki&uid=hempelr&sid=4435588.3685979.95587797.9143175&kennung=48">get</a>,
<a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/doku/wiki&uid=hempelr&sid=4435588.3685979.95587797.9143175&kennung=50">put</a> bzw. <a href="http://baseportal.de/cgi-bin/baseportal.pl?htx=/doku/wiki&uid=hempelr&sid=4435588.3685979.95587797.9143175&kennung=51">mod</a>
mit anzugeben.
<p class=z_beispiel>Beispiel:</p>
<p class=code>
get "Id==* Farbe=rot", "autos", "roteautos"<br>
while(get_next("roteautos"){<br>
<span class=einzug>$dsnr = $Id;<br>
mod "Id==$dsnr ["Farbe","dunkelrot"] ", "autos","andersrot";<br>
</span>
}<br>
</p>
<p>Hier ist im <strong>get</strong> "autos" der Datenbankname, "roteautos" der Ergebnishashname<br>
im <strong>mod</strong> der Datenbankname ebenfalls "autos" und der Ergebnishashname "andersrot";<p>
<p>Übrigens, dieser Scriptteil würde in jedem Datensatz der Datenbank "autos", bei dem im Datenbankfeld Namens "Farbe" der Wert "rot" oder "Rot" steht diesen in den Wert "dunkelrot" ändern<p>

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

Ohne Änderungen zurück zur Seite

Neue Seite erstellen