...

v5.3

...

...

...

Schemata ermöglichen es eigene Datenbanktabellen zu schaffen.

Image Removed

...

Die Schemata ermöglichen es eigene Datenbanktabellen in PIM zu erstellen. Hierfür werden die folgenden Konfigurationstabellen zur Definition genutzt:

• Schemata

• Tabellen

• Tabellengruppen

Alle Tabellen stehen über den Administrationsbereich zur Verfügung. Die Schemata sind eine Gruppierung von Tabellen welche optional in Tabellengruppen organisiert werden können.

Datenpflege

Folgende Datenpflege ist für die Erstellung eines funktionsfähigen Schemas erforderlich.

Datenbank-Schemata

Ein Datenbank-Schema-Datensatz stellt ein Schema als ganzes dar. Einem Datenbank-Schema-Datensatz müssen alle diesem Schema zugehörigen Tabellenstrukturen als Kind verknüpft werden.

Image Removed

...

...

Dashboard-Kacheln

Die Kacheln repräsentieren die Kacheln die in brandbox angezeigt werden. In den Kacheln können Tabellen gruppiert und sortiert werden.

Image Removed

Tabellenstrukturen

Ein Tabellenstruktur-Datensatz stellt eine einzelne Datenbanktabelle dar. Wird einem Tabellenstruktur-Datensatz eine Tabellenstruktur als Kind verknüpft so wird eine Beziehung zwischen den beiden Tabellen aufgebaut welche es ermöglicht Datensätze beider Tabellen miteinander zu verknüpfen.

Image Removed

Image Removed

...

...

...

...

...

Datenbankschema aktualisieren

Sollten Anpassungen an den beiden Schemata-Tabellen durch die Datenpflege vorgenommen worden sein, so müssen diese Änderungen aus der Datenpflege übernommen und angewendet werden. Hierzu steht in der Toolbar beider Schemata-Tabellen ein Button zu Verfügung. Über diesen kann der Aktualisierungsvorgang manuell gestartet werden.

Image Removed

Auswirkungen einer Aktualisierung des Datenbankschemas

Wird der o. g. Aktualisierungsvorgang ausgelöst werden die gepflegten Datenbank-Schemata und deren verknüpften Tabellenstrukturen zum einen Tabellen in die Datenbank überführt und zum anderen werden entsprechende Code-Dateien erzeugt.

Anpassungen an der Datenbank

Jede mit einem Datenbank-Schemata verknüpfte Tabellenstruktur welche keine gewählte Entsprechung besitzt wird als Datenbanktabelle angelegt. Als Name dieser Tabelle wird der vergebene Identifikator in einer umgewandelten Form genutzt. Diese Tabellen beinhalten die in der abstrakten Entity \brandbox\pim\datapool\lib\pimEntityAbstract beschriebenen Spalten. Zudem werden entsprechende Übersetzungstabellen angelegt, welche sich an das abstrakte Entity \brandbox\pim\datapool\lib\pimTranslationEntityAbstract halten.

Erzeugung von Code-Dateien

Für jeden Datenbank-Schemata-Datensatz wird ein Ordner unter temp/plugin/scheme/ angelegt. Als Name dieses Ordners wird der Identifikator des Schemas genutzt. Es werden jeweils die für brandbox notwendigen Code-Dateien erzeugt, darunter fallen auch die entsprechenden Entity-Klassen für die Doctrine-Implementation von brandbox. Als namespace-Basis wird immer brandbox\scheme\[Identifikator des Schemas] genutzt.

Programmatische Verwendung

Die erzeugten Datenbanktabellen sowie deren Code-Dateien können wie Systemtabellen von brandbox genutzt und im Code angesprochen werden.

...

Datenbankschema aktualisieren

In der Datensatzliste der Schemata kann das gesamte Datenbankschema aktualisiert werden.

Benutzerdefinierte Konfigurationen

Über das JSON-Eingabefeld "Konfiguration" in der Definitionstabelle "Tabellen" kann eine benutzerdefinierte Konfiguration ergänzt werden. Diese kann mithilfe des folgenden Codes abgerufen werden:

use \Brandbox\Framework\Component\Widget;

$configuration = $this
	->staticController(Widget\Manager::class)
	->getRepositoryWidget('[Identifikator der Datenbanktabelle]') // Optional auch direkt über ein Entity per $entity->getWidget() abrufbar.
	->getConfiguration()
;

Echte Tabellenspalten erstellen

Normalerweise erstellt PIM keine Spalten in den generierten Datenbanktabellen sondern nutzt die ODM-Spalte für die Speicherung der Daten. Mit der Checkbox "Tabellenspalten erstellen" in der Konfiguration einer PIM-Tabellenstruktur werden die verknüpften Felder als echte Spalten in der Tabelle erstellt. Hierbei wird standardmäßig die interene Feldkonfiguration als Grundlage für die Spaltendefinition genutzt (Eine Checkbox wird als boolean gespeichert und eine Textfeld als string). Mit folgender Feldkonfiguration bei den entsprechenden Spalten kann diese Definition überschrieben werden:

{
    "doctrine": {
        "type": "[Typdefinition von Doctrine (bspw. boolean, string, json, etc.)]",
        "length": 255, // Längenangabe als Ganzzahl
        "encrypted": true // Optionale Verschlüsselung der Spalte
    }
}

Zugriff auf Datenbanktabellen

Der Identifikator der erstellten Datenbanktabellen setzt sich immer aus dem Identifikator des enthaltenen Schemata sowie dem Identifikator der Tabellenstruktur zusammen. Der nachfolgende Code kann zum Abrufen eines Identifikators genutzt werden.

use Brandbox\PimCore\Pim\Facade;

$scheme = '[Schema-Identifikator]';
$repository = '[Tabellenstruktur-Identifikator]';

$identifier = $this
  ->staticController(Facade\Manager::class)
  ->getRepositoryIdentifier($scheme, $repository)
;

Versionshinweise