Suche
Startseite / Dokumentation / API-Funktionen Design
Ein wesentlicher Bestandteil von dbXwebApp sind die Data Dictionarys
Ein Data Dictionary (DD) ist ein Verzeichnis, das Informationen über die Strukturen von Daten, ihre Eigenschaften sowie ihre Verwendung enthält¸ also sogenannte Metadaten speichert. Durch im DD festgelegte Regeln (Funktionsaufrufe) wird auch die Datenintegrität unterstützt.
Die Informationen über die Daten (Meta-Daten) holt sich dbXwebApp automatisch aus dem jeweiligen Data Dictionary.
Neben Feldtype und Größe können in den dbXwebApp Data Dictionarys auch Vorgabewerte und Validations-Regeln festgelegt werden.
Auch werden in den dbXwebApp Data Dictionarys die Lese/Schreib und Löschrechte für die Tabelle und bei Bedarf auch für einzelne db-Felder festgelegt.
Bild: Ansicht DataDictionarys Übersicht.
Jedes Data Dictionary kann bei den verschiedenen Ereignissen (Datensatz lesen, erstellen,ändern,löschen) automatisch verschiedene Funktionen aufrufen.
Bild: Ansicht DataDictionary (dbx_events)
Berechtigungen (HTML-Level, lesen und schreiben) können bis hinunter auf Feldebene festgelegt werden.
Für Standardaufgaben gibt es in dbXwebApp vorgefertigte Funktionen.
In den DataDictionarys können Sie für jedes Dateifeld verschiedene Validierungs Funktionen angeben. Diese Funktionen werden dann
beim Speichern eines Datensatzes automatisch ausgeführt. Sollte eine der Validierungs-Funktionen 0 (false) als Ergebnis zurückgeben wird
der Speicher-Vorgang nicht durchgeführt und das Eingabeformular mit der entsprechenden Fehlermeldung angezeigt.
Validierungs-Funktionen:
$msg ist dabei die ID des Datensatzes der db-Tabelle dbx_message. In dieser Tabelle werden die Fehlermeldungen definiert, die Angezeigt werden sollen.
$err ist Standard mäßig 1. Das Bedeutet, dass im Fehlerfall die db-Operation abgebrochen wird.
$minval ist der Mindestwert und $maxval der Maximalwert der jeweiligen Eingabe.
Beispiel:
dbx_field_validate_between("1970","2008",3);
Bedeutet das die Eingabe in dem Feld einen Wert zwischen 1970 und 2008 haben muss. Im Fehlerfall wird der Datensatz nicht gespeichert. Das Eingabeformular wird erneut mit den fehlerhaften Eingaben angezeigt und die Fehlermeldung mit der ID 3 wird angezeigt.
Auch wird das Eingabefeld mit fehlerhafter oder fehlender Eingabe (je nach Validierungs-Funktion) automatisch farblich markiert.
Das System erkennt automatisch ob Formulardaten mehrfach abgesendet wurden (reload / F5) und führt in einen solchen Fall die db-Operationen nicht ungewollt mehrfach aus.
dbXwebApp ist in sich und durch die konsequente Verwendung von DataDictionarys ein PHP System, was sich deutlich vom Mitbewerb abhebt.
Ein wesentlicher Bestandteil von dbXwebApp sind die Data Dictionarys
Ein Data Dictionary (DD) ist ein Verzeichnis, das Informationen über die Strukturen von Daten, ihre Eigenschaften sowie ihre Verwendung enthält¸ also sogenannte Metadaten speichert. Durch im DD festgelegte Regeln (Funktionsaufrufe) wird auch die Datenintegrität unterstützt.
Die Informationen über die Daten (Meta-Daten) holt sich dbXwebApp automatisch aus dem jeweiligen Data Dictionary.
Neben Feldtype und Größe können in den dbXwebApp Data Dictionarys auch Vorgabewerte und Validations-Regeln festgelegt werden.
Auch werden in den dbXwebApp Data Dictionarys die Lese/Schreib und Löschrechte für die Tabelle und bei Bedarf auch für einzelne db-Felder festgelegt.
Bild: Ansicht DataDictionarys Übersicht.
Jedes Data Dictionary kann bei den verschiedenen Ereignissen (Datensatz lesen, erstellen,ändern,löschen) automatisch verschiedene Funktionen aufrufen.
Bild: Ansicht DataDictionary (dbx_events)
Berechtigungen (HTML-Level, lesen und schreiben) können bis hinunter auf Feldebene festgelegt werden.
Für Standardaufgaben gibt es in dbXwebApp vorgefertigte Funktionen.
In den DataDictionarys können Sie für jedes Dateifeld verschiedene Validierungs Funktionen angeben. Diese Funktionen werden dann
beim Speichern eines Datensatzes automatisch ausgeführt. Sollte eine der Validierungs-Funktionen 0 (false) als Ergebnis zurückgeben wird
der Speicher-Vorgang nicht durchgeführt und das Eingabeformular mit der entsprechenden Fehlermeldung angezeigt.
Validierungs-Funktionen:
- dbx_field_validate_email($msg,$err=1);
- dbx_field_validate_ge_now($msg,$err=1);
- dbx_field_validate_between($minval,$maxval,$msg,$err=1);
- dbx_field_validate_eq($val,$msg,$err=1);
- dbx_field_validate_lt($maxval,$msg,$err=1);
- dbx_field_validate_gt($minval,$msg,$err=1);
$msg ist dabei die ID des Datensatzes der db-Tabelle dbx_message. In dieser Tabelle werden die Fehlermeldungen definiert, die Angezeigt werden sollen.
$err ist Standard mäßig 1. Das Bedeutet, dass im Fehlerfall die db-Operation abgebrochen wird.
$minval ist der Mindestwert und $maxval der Maximalwert der jeweiligen Eingabe.
Beispiel:
dbx_field_validate_between("1970","2008",3);
Bedeutet das die Eingabe in dem Feld einen Wert zwischen 1970 und 2008 haben muss. Im Fehlerfall wird der Datensatz nicht gespeichert. Das Eingabeformular wird erneut mit den fehlerhaften Eingaben angezeigt und die Fehlermeldung mit der ID 3 wird angezeigt.
Auch wird das Eingabefeld mit fehlerhafter oder fehlender Eingabe (je nach Validierungs-Funktion) automatisch farblich markiert.
Das System erkennt automatisch ob Formulardaten mehrfach abgesendet wurden (reload / F5) und führt in einen solchen Fall die db-Operationen nicht ungewollt mehrfach aus.
dbXwebApp ist in sich und durch die konsequente Verwendung von DataDictionarys ein PHP System, was sich deutlich vom Mitbewerb abhebt.
