Felddefinitionen und Variablen

kibeo simuliert eine Datenbank mit Hilfe von einfachen Text-Dateien. Die Felder dieser Pseudo-Datenbank werden in der Datei config/felder.cfg definiert. Weitere Variablen werden in der Datei config/config.cfg festgelegt. Beide cfg-Dateien können direkt editiert werden. config/config.cfg kann auch mit Hilfe der Administratormaske (admin.pl) bearbeitet werden.

 

Speicherort

Die Felddefinitionen werden in der Datei config/felder.cfg gespeichert.

Allgemeine Syntax

Feldname=Feldtyp

Evtl. können durch Semikolons getrennt weitere Parameter zu diesem Feld definiert werden:

Feldname=Feldtyp;Parameter1;Parameter2

Bei manchen Parametern gibt es weiter Zusatzangaben, die mit einem Doppelpunkt angeben werden:

Feldname=Feldtyp;Parameter1:Info1

Der Feldtyp "option" wird genauso definiert, die einzelnen Optionen werden durch Kommata getrennt:

Feldname=option:option1,option2,option3

Es kommt auf die richtige Groß-/Kleinschreibung an. Leerzeichen dürfen nicht in der Zeile benutzt werden.

Feldtyp "txt" (Textfeld)

Textfelder dienen zur Aufnahme von beliebigen freien Text.

spezielle Parameter:

Beispiele:

Name=text;laenge:30

Plz=text;laenge:5

Qualitaetsmanagement=text

Feldtyp "option" (Auswahlfeld)

Das Feld kann nur bestimmte - hier definierte - Werte annehmen. Beim Editieren wird eine Auswahlbox dargestellt, damit keine falschen Werte eingegeben werden.

Beispiel (mit Vorgabewert, s.u.):

Traeger=option:städtisch,katholisch,evangelisch,awo,selbst,unbekannt;default:unbekannt

Feldtyp "janein" (logisches Feld)

Das Feld kann nur zwei verschiedene Wert Ja und Nein annehmen.

[[TraegerStadt]]=janein

Feldtyp "bild" (Platzhalter für Grafikdateien)

Mit diesem Feld können Bilder bzw. Fotos gespeichert werden.

Vorderansicht=bild;maxbreite:800;maxhoehe:800

Die Bilder selbst werden nicht in der Daten-Datei daten/ID.txt gespeichert, sondern unter html/.bilder/ID/FELDNAME-NUMMER.DATEITYP abgelegt. In der Daten.Datei selbstwerden nur Metainformationen zum Bild (Dateiname, Breite, Höhe) abgelegt.

Als Dateityp ist (momentan) nur zugelassen: JPEG.

Beispiel-Dateiname: html/.bilder/ordner/st-x/Vorderansicht-1134402790.jpeg.

Feldtyp "Datei"

Nur zum internen Gebrauch für Datei-Uploads, z.B. Datenimport.

Feldparameter "laenge" (Feldlänge)

Nur bei text, s.o.

Feldparameter "default"

Ist noch kein Wert definiert, wird automatisch der hier angegebene benutzt.

Beispiel:

Traeger=option:städtisch,katholisch,evangelisch,awo,selbst,unbekannt;default:unbekannt

Feldparameter "selektion"

Alle Felder über die gesucht werden können soll, müssen mit dem Paramter selektion festgelegt werden.

Beispiele:

[[FeldJaNein]]=janein;selektion
Traeger=option:katholisch,evangelisch,awo,selbst,unbekannt;default:unbekannt;selektion

Feldparameter "readonly"

Das Feld wird zwar in der Datenbank gespeichert, darf aber nicht (hier) editiert werden, weil z.B. die Daten von woanders importiert werden.

Beispiel:

Name=text;selektion;laenge:30;readonly

Feldparameter "maxbreite" (Bildbreite)

Nur bei Typ bild.

Gibt die maximale Breite des Bilder vor, das Bild wird bei Bedarf vor dem Abspeichern herunterskaliert. Beispiel: s.o.

Feldparamter "maxhoehe" (Bildhöhe)

Nur bei Typ bild.

Gibt die maximale Höhe des Bilder vor, das Bild wird bei Bedarf vor dem Abspeichern herunterskaliert. Beispiel: s.o.

Standard-Feld "ID"

Das Feld ID ist immer definiert, Typ ist text.

Es bezeichnet den Identifier, also den eindeutigen Namen der Einrichtung, der auch zum Abspeichern unter daten/ID.txt benutzt wird. Man braucht das Feld z.B. um darauf zu verlinken.

Standardfeld "_BoersenName"

In der Konfiguration (config.cfg) kann eine Name für das Gesamtprojekt (z.B. "Kinderbetreuungsbörse Musterstadt") definert werden, der über das Feld $_BoersenName$ an eine HTML-Datei übergeben werden kann.

Standardfeld "_Instanz"

Die aktuelle Instanz der Börse, wird gebildet aus dem Pfad, Beispiel:

Standardfeld "_Aktion"

Die gerade ausgeführt Aktion:

Beachte: Speichern != Ansehen

Standardfeld "_Seite" (alt)

Name der aktuellen Seite (HTMLFILE) ohne Erweiterung, z.B: i01.

Diese Variable ist veraltet und wird nur in einzelnen Anwendungen definiert. Bitte stattdessen benutzen: _Seitenname

Standardfeld "_Seitenname"

Name der aktuellen Seite ohne Erweiterung, z.B. i01.

Kann dazu benutzt werden, um Link auf PDF-Version dieser Seite einzubinden:

<a href=$_seitenname$.pdf>PDF</a>

Siehe Kapitel PDF.

Standardfeld "_SeiteEditierbar"

Ja/Nein-Feld

Die aktuelle Seite darf editiert werden, wird aber gerade nicht editiert.

Aktuell nur in hilfe.pl implementiert.

Standardfeld "_Datum_Zeit" (alt)

Druckt das Datum, zu dem die entsprechende HTML-Datei zuletzt erzeugt wurde. Da diese Angabe recht ungenau ist (z.B. könnte die HTML-Datei neu erzeugt werden, weil sich ein Template geändert hat, nicht weil sich inhaltlich etwas geändert hat), sollte das Feld _DatumAenderung benutzt werden.

Standardfeld "_DatumAenderung"

Das Feld muss in der felder.cfg folgendermassen definiert werden:

_DatumAenderung=text;default:unbekannt;readonly

Datum/Zeit der letzen Änderung am Datensatz. Dieser Zeitstempel wird immer geschrieben, wenn der "Speichern"-Button gedrückt wird und ein Feld verändert wurde.

Datum/Zeit wird automatisch formatiert, z.B. 18.09.2006 15:33

Nur für Frame-Layout "_frame"

Diese Felder werden nur besetzt, wenn das Template _frame.html benutzt wird.

Beispiel für _frame.html

<HTML>
<HEAD>
<TITLE>Frame Template ($ID$)</TITLE>
</HEAD>
<FRAMESET COLS="205,*" BORDER=0 FRAMEBORDER=NO FRAMESPACING=0>
<FRAME SRC=$_Navigation$ NAME="navigationsleiste">
<FRAME SRC=$_Inhalt$ NAME="inhalt">
</FRAMESET>
</HTML>

Siehe auch unter "Navigation".

Nur für Frame-Layout: "_Navigation"

Der Link zur aktuellen Navigations-Seite, z.B. n_Seite.html oder n01.htm.

Nur für Frame-Layout: "_Inhalt"

Der Link zur aktuellen Inhalts-Seite, z.B. Seite.html oder i01.htm.

Nur im Admin-Modus: "Meldungen"

Meldungen und die folgenden Variablen werden nur definiert, wenn das Script admin.pl benutzt wird.

Aktuelle Meldungen, Typ ist text.

Nur im Admin-Modus: "NameNeu"

Name des neuen Ordners oder Einrichtung, Typ ist text.

Nur im Admin-Modus: "Ordner"

Der selektierte Ordner, Typ ist option.

Aktualisiert am 29.05.2008 - Startseite           ▲ nach oben