Datenbank-Editor

Mit dem Datenbank-Editor können Sie SQL-Abfragen für Bausteine einer Datenbankverbindung definieren, um Daten aus einer relationalen Datenbank abzufragen. Durch die logische Trennung der Prozessbausteine SQL-Anweisung und Datenbankverbindung lassen sich diese Prozessbausteine im X4 Designer flexibel einsetzen und mehrfach verwenden.

Um den Datenbank-Editor aufzurufen, legen Sie eine neue SQL-Statement-Datei (.stm) an, oder öffnen Sie eine bereits vorhandene SQL-Statement-Datei.

Aufbau des Datenbank-Editors

Der Datenbank-Editor besteht aus den folgenden Bereichen:

Statement Editor: In diesem Bereich können Sie eine Verbindung zu einer Datenbank aufbauen und die Struktur der verbundenen Datenbank anzeigen. Mit dieser Struktur können anschließend SQL-Statements für die Datenbank erstellt werden.
Mapping Editor: In diesem Bereich können Sie für das im Statement Editor zuvor erstellte Statement ein Mapping von Elementen eines Input-XML-Dokuments auf die Named Parameter des Statements definieren. Aus diesem Mapping können Sie anschließend ein XSL-Mapping erstellen, das mit einem passenden Input-XML-Dokument eine dynamisch erzeugte Eingabe für den (7.4.0-de) JDBC Connector erzeugt.

Statement Editor

Der Statement Editor ist in folgende Bereiche unterteilt:

Connection-Bereich

In diesem Bereich können Sie über einen JDBC Connector eine Verbindung zu einer Datenbank aufbauen.

JDBC Connector: xstore-URL zu einem JDBC Connector
- Um eine Verbindung aufbauen zu können, muss der Adapter innerhalb des Parameters JndiName einen gültigen JNDI-Namen enthalten.
- In der Dropdown-Liste werden die letzten acht verbundenen URLs zur Auswahl angeboten.
Connect: Mit der Datenbank verbinden
Unter Status wird der Verbindungstatus angezeigt.
Execute Statement: Statement ausführen

Database-Bereich

In diesem Bereich wird nach dem Verbindungsaufbau die Struktur der Datenbank angezeigt. Für die Darstellung der Struktur werden die folgenden Symbole verwendet:

Datenbankschema
Datenbanktabelle
Primärschlüssel
Primärschlüssel/Fremdschlüssel
Fremdschlüssel

Statement-Bereich

In diesem Bereich können Sie über das Kontextmenü verschiedene Statements für die verbundene Datenbank anlegen:

New Named Prepared Statement: Im Statements Root ein neues Named Prepared Statement anlegen
Edit Named Prepared Statement: Named Prepared Statement bearbeiten
New RowSet: Neues RowSet anlegen.
Innerhalb eines Named Prepared Statement kann lediglich ein RowSet existieren. Dieses wird beim Anlegen des Named Prepared Statement automatisch mit angelegt.
Ein neues RowSet kann nur angelegt werden, wenn das bestehende RowSet gelöscht wurde.
New Row: Neue Zeile innerhalb eines RowSet hinzufügen
New Named Parameter Value: Einen neuen Named Parameter-Wert innerhalb einer Zeile hinzufügen
Edit Named Parameter: Named Parameter bearbeiten
New SELECT Statement: Ein neues SELECT-Statement anlegen
Edit SELECT: SELECT-Befehl bearbeiten
Edit FROM: FROM-Befehl innerhalb eines SELECT-Statements bearbeiten
New INSERT Statement: Ein neues INSERT-Statement anlegen
Edit INTO: INTO-Befehl bearbeiten
New VALUE Entry: Neuen Eintrag unter VALUE anlegen
Edit VALUE: Wert eines VALUE-Eintrags bearbeiten
New UPDATE Statement: Ein neues UPDATE-Statement anlegen
Edit UPDATE: UPDATE-Befehl bearbeiten
New SET Entry: Neuen Eintrag unter SET anlegen
Edit SET Entry: Eintrag unter SET bearbeiten
New DELETE Statement: Ein neues DELETE-Statement anlegen
Edit FROM: FROM-Befehl bearbeiten
Edit WHERE: WHERE-Bedingung bearbeiten
New Column: Neue Spalte innerhalb eines INSERT- oder SELECT-Befehls einfügen
New Table: Neue Tabelle innerhalb eines UPDATE- oder SELECT-Befehls einfügen
Delete: Element löschen

Weitere Informationen zum Anlegen und Bearbeiten von Statements finden Sie im Abschnitt Statement für eine verbundene Datenbank erstellen.

Drag&Drop-Aktionen

Im Statement-Bereich können Sie die folgenden Drag&Drop-Aktionen ausführen:

SQL-Statement	Datenbank-Element	Statement-Element	Aktion
`SELECT`	`Column`	`SELECT`	Die auszuwählende Spalte hinzufügen Steht die Tabelle der Spalte noch nicht im `FROM`, wird diese hinzugefügt.
`SELECT`	`Table`	`FROM`	Tabelle hinzufügen, aus der ausgewählt werden soll
`UPDATE`	`Column`	`SET Entry`	Spalte als Eintrag setzen Steht die Tabelle der entsprechenden Spalte noch nicht im `UPDATE`, wird diese hinzugefügt.
`UPDATE`	`Table`	`UPDATE`	Die zu aktualisierende Tabelle setzen
`INSERT`	`Table`	`INTO`	Tabelle setzen, in die geschrieben werden soll Ist bereits eine Tabelle vorhanden, wird diese ersetzt. Dabei werden auch bereits gesetzte Spalten (`Columns`) gelöscht.
`INSERT`	`Column`	`INTO`	Spalte setzen, in die geschrieben werden soll Dies ist nur möglich, wenn die Spalte aus der gesetzten Tabelle stammt.
`DELETE`	`Table`	`FROM`	Die zu löschende Tabelle setzen Ist bereits eine Tabelle vorhanden, wird diese ersetzt.

Mapping Editor

Mit dem Mapping Editor können Sie für die zuvor im Statement Editor angelegten Statements per Drag&Dropp Mappings von einem Input-XML-Dokument auf die Named Parameters der Statements konfigurieren und anschließend erstellen. Diese Mappings erzeugen mit einem passenden Input-XML-Dokument eine dynamisch erzeugte Eingabe für den (7.4.0-de) JDBC Connector.

Der Mapping Editor ist in folgende Bereiche unterteilt:

Quelldokument-Bereich

Auf der linken Seite befindet sich in der Quelldokument-Bereich. In diesem Bereich können Sie die Input-XML-Datei per Drag&Drop ablegen und anzeigen.

Über das Kontextmenü können Sie den gewählten Knoten wie folgt bearbeiten:

Collapse: Knoten mit aufgeklappten Unterelementen zuklappen
Expand: Unterelemente des Knotens aufklappen
Remove Input: Input-XML-Dokument entfernen

Verknüpfungsbereich

In der mittleren Spalte befindet sich der Verknüpfungsbereich. In diesem Bereich werden die xsl:value-of-Verknüpfungen zwischen dem Element aus dem Quelldokument und dem Named Parameter im Statement als Linien visualisiert.

Statements-Bereich

Auf der rechten Seite befindet sich der Statements-Bereich. In diesem Bereich wird die gesamte Struktur der Statement-Datei angezeigt. Dabei können Mappings vom Input-XML auf die Kind-Elemente eines Row-Elements erstellt werden.