DB-App-Builder

Der DB-App-Builder ist ein grafisches Interface mit dessen Hilfe SQL Statements erstellt werden können. Eine fertige Selektion wird in einem XML File gespeichert. und kann anschließend mit der Function run-selection im Jart Code aufgerufen werden.

<art:call function="run-selection" selection="path/to/selection.xml"></art:call>

Allgemeines

Selektionen im DB-App-Builder sind bereits gegen SQL Injections abgesichert, d.h. es brauchen keine zusätzlichen Vorkehrungen getroffen werden. Um den DB-App-Builder zu verwenden muss folgende Datei verwendet werden.

<art:include href="/prj3/jart-tools/resources/developer-apps/db-app-builder/includes/dbapp-inc.jart"></art:include>

Die Beziehungen zwischen den einzelnen Tabellen werden vom DB-App-Builder aus dem dbcon.xml File gelesen (meistens in prj3/projekt/resources/dbcon.xml zu finden). Falls keine Ajax DB im aktuellen Projekt verwendet wird müssen die Relationen erst mit dem Relationseditor gesetzt werden, da diese die Einträge im dbon.xml generiert.

Der DB-App-Builder kann mit dem Developer Tools Icon auf der Startseite aufgerufen werden. (Schraubenschlüssel). Wenn man sich im DB-App-Builder Interface befindet gibt es die Möglichkeit einen Folder anzulegen bzw. zu wählen und darin eine Selektion anzulegen bzw. auszuwählen. Im folgenden werden die Möglichkeiten beschrieben um eine Selektion zu erstellen.

Eine einfach Selektion

Wenn man sich im Zielfolder für die Speicherung der Selektion befindet, muss in der Selectbox "selection" der eintrag new gewählt werden. Zuerst muss man sich nur auf die rechte Seite des Bildschirms konzentrieren, hier befinden sich die Eigenschaften. Beginnt man bei der Bearbeitung mit der Wahl der richtigen Tabelle wird der Name der Tabelle automatisch auch als Selektionsname und Nodename gesetzt, diese Felder können natürlich auch manuelle bearbeitet werden. Falls eine Verbindung mit anderen Tabellen besteht werden diese im Feld Subtables zur Auswahl angeboten, darauf wird später eingegangen. Die Eigenschaft Fields erstellt eine Liste aller Felder aus der DB. Mittels * wird alles selektiert, mit *.+ wird alles außer _history und jartdb_deleted gewählt, *.- bewirkt das Gegenteil. Während die Felder angeklickt werden ist in der linken Hälfte des Interface die getätigte Auswahl zu sehen. Die getroffenen Einstellungen reichen bereits aus um eine einfache Selektion zu erstellen, die Selektion muss nur noch mittels Save gespeichert werden.