Datenbank

Das System bietet eine einfache Möglichkeit, eigene SQL-Datenstrukturen zu importieren und zu konfigurieren. Die entsprechenden Tabellen müssen per PHP myAdmin angelegt werden, es können aber auch Tabellen bestehender Systeme eingebunden werden. Liegen diese Tabellen auf einem anderen Server, muss sicher gestellt werden, dass die nötigen Berechtigungen für den externen Zugriff vergeben wurden. Die importierten Daten lassen sich ohne Umwege innerhalb der Templates nutzen.

Die Tabellen einer Datenbank können in beliebig viele Gruppen unterteilt werden. Die Zuordnung zu einer Gruppe dient der inhaltlich sinnvollen Strukturierung der Daten. Jede Tabelle kann allerdings nur ein einziges Mal in das System importiert werden. Die Zugangsdaten für den Zugriff auf die Datenbank eines externen Servers können innerhalb der Gruppe hinterlegt werden, im Normalfall geht das System jedoch davon aus, dass sich alle zu importierenden Tabellen innerhalb der System-Datenbank befinden.

Datengruppen anlegen

1.Datengruppen werden im Backend unter dem Menüpunkt Datenbank angelegt.2.Als Name sollte eine inhaltlich sinnvolle Bezeichnung der Gruppe gewählt werden3.Die Backend-Berechtigungen legen fest, welche Usergruppen oder -rollen im Backend Zugriff auf die Datengruppe erhalten4.Zugangsdaten müssen nur hinterlegt werden, wenn sich die zu importierenden Tabellen nicht innerhalb der System-Datenbank befinden

Feldname
Beschreibung
NameName der Datenbank-Gruppe
BACKENDLegt die Zugriffsrechte für diese Datengruppe fest
DatenbankName der Datenbank
HostDer Server auf dem die Datenbank liegt. Normalerweise ist das der System-Server, in dem Fall wird "localhost" eingetragen.
UserDer Datenbank Benutzername
PasswortDas Passwort des Datenbank Benutzers
PortDer Port über den auf die Datenbank zugegriffen wird. Im Falls des locahost ist das meist der Port 21.

Datentabellen können nach dem Import als Datenquelle für Templates genutzt werden. Jeder importierten Tabelle lässt sich ein Verzeichnis zuordnen in dem hochgeladene Dateien dieser Tabelle gespeichert werden. Die Feldbezeichnung sowie der Typ der Datenfelder lassen sich im Backend anpassen. Außerdem kann eine Parent-Tabelle angegeben werden, um ein relationales Datenmodell abzubilden.

Tabellen importieren

1.Tabellen werden im Backend innerhalb einer Datengruppe importiert2.Der Name ist frei wählbar und dient zur Anzeige im Backend3.Alle weiteren Angaben sind optional. Wichtig ist ggf. die Angabe der Parent-Tabelle und falls die Tabelle über ein Upload-Feld (auch Images) verfügt, das Datenverzeichnis. Außerdem ist es sinnvoll, die Buttons zum Anlegen, Bearbeiten und Löschen von Daten mit aussagekräftigen Beschreibungen zu versehen, z.B. "Neuen Artikel anlegen", "Artikel löschen" etc.4.Im Anschluss an den Import der Tabelle erfolgt die Konfiguration und die Wahl der Datenfelder

Feldname
Beschreibung
NameEin frei zu vergebender Name unter dem die Tabelle im Backend angezeigt wird
TabelleDie zu importierende Tabelle
ParentDie Parent-Tabelle dieser Datentabelle (falls vorhanden)
DatenverzeichnisDas Verzeichnis innerhalb des /data/ Verzeichnisses auf in dem hochgeladene Daten dieser Tabelle gespeichert werden
ICONDas Icon mit dem die Tabelle in einigen Bereichen des Backends dargestellt wird. Ein Icon sollte immer dann vergeben werden, wenn mehrere Tabellen mit der gleichen Parent-Tabelle verknüpft sind.
NEUDie Bezeichnung des Buttons zum Anlegen neuer Datensätze
BEARBEITENDie Bezeichnung des Buttons zum Bearbeiten von Datensätzen
DELETEDie Bezeichnung des Buttons zum Löschen von Datensätzen dieser Tabelle
BACKENDVergabe der Zugriffsrechte zum Zugriff auf die Tabelle über das Backend
ANLEGENVergabe der Zugriffsrechte zum Anlegen neuer Datensätze dieser Tabelle
BEARBEITENVergabe der Zugriffsrechte zum Bearbeiten von Datensätzen dieser Tabelle
LÖSCHENVergabe der Zugriffsrechte zum Löschen von Datensätzen dieser Tabelle

Importierte Tabellen müssen innerhalb des Systems konfiguriert werden, damit die Anbindung und die Verknüpfung mit Parent-Datensätzen problemlos funktioniert. Im Wesentlichen müssen die Schlüsselfelder (Primär-Key und Secundär-Key) definiert werden. Zusätzlich lassen sich u.a. die Sortierung sowie die Anzeige in der Übersicht und im Bearbeitungs-Modus anpassen.

Tabellen konfigurieren

1.Die Tabelle importieren (s.o.)2.Die Schlüsselfelder und das Namensfeld definieren3.Optional die Sortierung und die Anzeige anpassen

Feldname
Beschreibung
FeldnameDer Name oder (falls angegeben) die Bezeichung des Tabellen-Feldes
Key1Das Feld welches den Primärschlüssel der Tabelle darstellt. Dieses Feld muss in der Datenbank-Definition über einen AUTO INCREMENT verfügen!
Key2Ein Secondär-Key muss nur angegeben werden falls die Tabelle eine Verknüpfung zu einer Parent-Tabelle besitzt
NameDas Feld welches die Bezeichnung eines Datensatzes dieser Tabelle enthält. Stehen Datensätze dieser Tabelle für ein Template oder innerhalb einer anderen Tabelle zur Auswahl wird dieses Feld genutzt, um den Datensatz zu identifizieren.
SORTDas Feld nach dem die Datensätze dieser Tabelle sortiert werden
DESCUmgekehrte Reihenfolge der Sortierung (von groß nach klein)
SUMFeld ist in der Übersichtsanzeige sichtbar. Es werden je nach Bildschirmauflösung max. 8 Felder in der Übersicht angezeigt
EDITSichtbarkeit des Feldes im Editier-Modus
NEEDWird diese Option gewählt, wird das betreffende Feld zum Pflichtfeld und muss bei Änderungen des Datensatzes ausgefüllt werden
LANGSprachfeld, d.h. bei Verwendung mehrerer Sprachen kann für dieses Feld für jeden Datensatz ein eigener sprachabhängiger Wert eingetragen werden
SortDie Reihenfolge in der die Felder dieser Tabelle im Backend angezeigt werden
GruppierungUnterteilung der Felder in Gruppen (wird nur im Editier-Modus eines Datensatzes angezeigt)
CONFIGDient lediglich zur Information darüber, ob die Konfiguration geändert oder das Feld als Suchfeld markiert wurde

Die Feld-Konfiguration ändert die Darstellung des Eingabe-Feldes im Backend. Die Datenfelder importierter Tabellen können auf verschiedene Weise konfiguriert werden: Je nach Einstellung wird das Feld zur Checkbox, zum HTML Editor oder es wird mit einem Upload-Button versehen. Welche Optionen für das jeweilige Feld zur Verfügung stehen ist abhängig vom Datentyp des Feldes innerhalb der SQL-Datenbank Definition.

Feld-Konfiguration ändern

1.Die Konfiguration über den Bearbeiten-Button des betreffenden Feldes aufrufen2.Den anzuzeigenden Feldinhalt wählen.3.Optional können der Bearbeitungs-Modus, die Priorität bei der Textsuche und der angezeigte Name des Feldes geändert werden.

Feldname
Beschreibung
FeldnameDer eigentliche Feldname wird aus der Datenbank übernommen und ist hier nicht änderbar
FeldinhaltJe nach Datentyp des Datenbank-Feldes stehen verschiedene Optionen zur Verfügung< DEFAULT >
Anzeige eines einfachen Eingabefeldes welches mit dem Datentyp des Feldes korrespondiert
< Textbox >
Vergrößertes Eingabenfeld für mittellange Texte (für Felder vom Typ CHAR, TEXT)
< Passwort >
Eingabe eines Passworts im Backend (für Felder vom Typ CHAR, TEXT)
< Image >
Upload-Feld für Images. Die Datei wird in das innerhalb der Tabellen-Konfiguration hinterlegte Verzeichnis hochgeladen (für Felder vom Typ CHAR, TEXT)
< Upload >
Allgemeiner Datei-Upload. Die Datei wird in das innerhalb der Tabellen-Konfiguration hinterlegte Verzeichnis hochgeladen (für Felder vom Typ CHAR, TEXT)
< HTML Editor >
Großes Eingabefeld mit optionalem WYSIWYG Editor (für Felder vom Typ TEXT)
< CODE Example >
Großes Eingabefeld welches zur besseren Lesbarkeit des Codes im Backend in der Typo COURIER angezeigt wird (für Felder vom Typ TEXT)
< Währung >
Ein auf zwei Stellen nach dem Komma gerundeter Wert (für Felder vom Typ FLOAT)
< Integer >
Anzeige eines ganzzahligen Wertes (für Felder vom Typ INT)
< Checkbox >
Anzeige einer Checkbox (für Felder vom Typ INT, BOOL)
< Radiobutton >
Die Verwendung eines Radiobuttons macht nur dann Sinn wenn das Feld zur Bearbeitung in der Übersicht freigeschaltet wurde (für Felder vom Typ INT, BOOL)
< Navigation >
Verknüpfung eines Datensatzes mit einem Menüpunkt (für Felder vom Typ INT)
< Lookup Tabelle >
Ein Lookup-Feld bietet die Möglichkeit das Feld mit Werten aus anderen importierten Tabellen zu Verknüpfen. So lassen sich z.B. in einer Shop-Anwendung Produkte mit Eigenschaften verknüpfen. Mit einem Lookup-Feld lässt sich ein Datensatz einem(!) Wert aus einer anderen Tabelle zuordnen, für die Zuordnung mehrerer Eigenschaften muss ein Feld vom Typ Multiple Select gewählt werden (für Felder vom Typ INT)
< Multiple Select >
Dieses Feld bietet die Möglichkeit den Datensatz mit mehreren Werten aus einer anderen, importierten Tabellen zu Verknüpfen. So lassen sich z.B. in einer Shop-Anwendung Produkte mit diversen Eigenschaften verknüpfen (für Felder vom Typ TEXT !!)
ParentDiese Feld steht nur für Feldinhalte vom Typ Lookup Tabelle und Multiple Select zur Verfügung. Hier kann die Auswahl auf ausgewählte Datensätze unterhalb des gewählten Parent-Datensatzes beschränkt werden.
BearbeitungLegt fest in welcher Ansicht sich der Feldinhalt bearbeiten lässt< DEFAULT >
Werte lassen sich im Bearbeitungs-Modus ändern und werden in der Übersicht lediglich angezeigt
< OVERVIEW >
Werte lassen sich in der Übersicht bearbeiten
< READ ONLY >
Die Werte dieses Feldes dienen nur der Anzeige und sind im Backend nicht änderbar
TextsucheDie Priorität bei der Textsuche. Content der in System-Tabellen (und nicht in eigens angelegten) gespeichert wird erhält die Priorität 5. Hier kann festgelegt werden, ob der Inhalt des eigenen Datensatzes höhere oder niedrigere Priorität erhält. Wird kein Wert gewählt, wird der Inhalt dieses Feldes bei der Textsucht ignoriert.
AnzeigeAngezeigter Feldname im Backend
HilfetextOptionaler Hilfetext im Backend. Dieser kann z.B. die benötigeten Maße eines Images enthalten.

Developer's Guide Referenz

Abfrage der Feld-Konfiguration

Die Daten der importierten Tabellen lassen sich in der Datenansicht bearbeiten. Diese wird wird direkt über das Backend-Menü aufgerufen. Welche Tabellen für den jeweiligen Benutzer zur Verfügung stehen steuert der Administrator über die Vergabe der Benutzerrechte.