baseportal Dokumentation

Titel:

Bei der Namensvergabe von Variablen gibt es ein paar Dinge zu beachten, damit man nicht irgendwann mal Überraschungen erlebt. 
<ul style="margin-top:2px;margin-bottom:2px;">a) Generell gilt, dass Variablennamen niemals mit einem Unterstrich "_" beginnen sollten, diese sind für BasePortal-Interna reserviert.</ul>
<ul style="margin-top:2px;margin-bottom:2px;">b) Variablennamen mit nur einem Buchstaben, insbesondere $a und $b sollten vermieden werden.</ul>
<ul style="margin-top:2px;margin-bottom:2px;">c)Variablennamen sollte man "sprechend" wählen, damit man auch nach 3 Monaten noch weiss, was man damit im Script gemeint hat, also beispielsweise für einen Zähler $cnt oder für eine Tabellenzeile mit Inhalten aus der Datenbank Namen $tz_dbnamen</ul>
Hier eine kleine Übersicht wichtiger und oft gebrauchter reservierter Variablennamen, die ohne Unterstrich beginnen:
<ul style="margin-top:2px;margin-bottom:2px;">uid= ... baseportal-Username 
upw= ... Passwort 
sid= ... gültige Session-Id 
htx= ... Templatename 
db= ... Datenbankname 
src= ... Name eines Includes 
Id=... Datensatz-Ident-Nr. 
Aktion= (in den andersprachigen Versionen die Übersetzung davon) 
(Danke an Andreas Jurenda, der das mal in einem Forumsbeitrag gepostet hatte)</ul>
Reservierte Wörter: 
<ul style="margin-top:2px;margin-bottom:2px;">Alle baseportal-interne Befehls- und Funktionsnamen sowie alle Perl-Befehls- und -Funktionsnamen sind für Variablennamen nicht einzusetzen</ul>
<ul style="margin-top:2px;margin-bottom:2px;">Insbesondere die in den Kapiteln <a href=http://baseportal.de/cgi-bin/baseportal.pl?htx=/hilfe/baseportal/db_help&help=61> Variablen</a> und <a href=http://baseportal.de/cgi-bin/baseportal.pl?htx=/hilfe/baseportal/db_help&help=96>Umgebungsvariablen</a> sowie <a href=http://baseportal.de/cgi-bin/baseportal.pl?htx=/hilfe/baseportal/db_help&help=62>Parameter</a> genannten Wörter sollten nicht im Script- bzw. Templatetext für Variablennamen verwendet werden</ul> 
Parameter- und Feldnamen: 
<ul>Bei der Wahl von Parameternamen bzw. anderen Bezeichnern, die per URL oder auch Formular übergeben werden sollen, ist es sinnvoll, auf alle "maskierten" Bezeichner für Sonderzeichen zu verzichten (Benannte Zeichen, s.a. bei SelfHTML unter <a href="http://de.selfhtml.org/html/referenz/zeichen.htm">Benannte Zeichen</a>). Andernfalls kann das kann mitunter zu seltsamen Ausgaben führen. Obwohl alle benannten HTML-Zeichen mit einem Strichpunkt enden interpretieren es die Browser offensichtlich auch ohne diesen, wenn ein "&" davor steht - und dann stimmt natürlich nichts mehr...</ul>

Ein wichtiger Hinweis nochmal zur Konvention der Feldnamen: 
<li>Feldnamen immer mit einem Buchstaben beginnen lassen (bzw. in Ausnahmefällen und wenn man weiss, was dabei passieren kann mit einer Zahl) - es geht auch anders, aber damit ist Ärger vorprogrammiert!</li>
<li>Keine mehrfach aufeinanderfolgende Leerzeichen in Feldnamen verwenden Am Besten ist es, generell keine Leerzeichen in Feldnamen zu verwenden, denn wenn man später mal mehr als nur die einfache BasePortal-Interne Ausgabe mit Programmierung machen will, ist jeder Feldname mit Leerzeichen ein potentieller Problemspender</li>
<li>Keine Sonderzeichen im Feldnamen (wie bspw. &lt;,&gt;&euro; o.ä. (bzw. in Ausnahmefällen und wenn man weiss, was dabei passieren kann muss man diese als HTML-Codierte Zeichen einsetzten, man darf sich aber dann nicht wundern, wenn manches nicht wie erwartet funktioniert!) Mit Sonderzeihen in Feldnamen ist Ärger vorprogrammiert!</li>
<li>Sprechende Feldnamen benutzen, anstatt Leerzeichen kann man auch den Unterstrich (_) einsetzen</li>

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

Ohne Änderungen zurück zur Seite

Neue Seite erstellen