Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- ftp4elo:c3_datasources:simpledatagateway [2023/12/02 03:27] – [Installation] support
+++ ftp4elo:c3_datasources:simpledatagateway [2023/12/03 14:17] (aktuell) – support
@@ Zeile 2: / Zeile 2: @@
 Das Simple Data Gateway ist eine WebApplikation, die auf dem Datenquellenkonzept von FTP4ELO/DDI aufbaut, resp. mit diesem kompatibel ist. Es handelt sich um eine WebApp, die mittels JDBC Datenverbindungen aufbaut, das parametrierte ausführen von Queries ermöglicht und diese in Form einer JSON Notation oder in Form einer XML Notation zurückgibt. Die WebApplikation hat im Grunde eine Standalone Variante, wurde aber im Zuge von Anpassungen so erweitert, dass sie die Konfigurationen von DDI lesen und verarbeiten kann.
+===== Konfigurationshierarchie =====
+  * Workspace: der Workspace enthält alle Konfigurationen (in DDI Datenquellen) und Queries
+      * Config: ident mit der Datenquelle in DDI/FTP4ELO, hier sollen unterschiedliche Datenquellen angesteuert werden könne (bspw. TEST/PROD etc.)
+        * Query: eine Query ist eine SQL-Query. Jede SQL-Query kann mit Parametern ausgestattet werden.
+===== Konfiguration =====
+  - Konfigurieren Sie die Datenquellen im Config-Tool
+    - Achtung: die dataSources.json Datei im Konfigurationsverzeichnis ist ausschließlich für die WebApp gedacht, zzt. werden die Datenquellen immer noch in der server.xml Datei führend gespeichert.
+  - Konfigurieren Sie die Abfragen mittels Config-Tool oder im Dateisystem (Config-Verzeichnis Queries)
+  - In den Queries kann mit Platzhalter gearbeitet werden. Folgende Formatierungen sind zulässig
+    - {Platzhalter} (DDI Notation)
+    - {$Platzhalter} (alternative Notation)
+    - %Platzhalter% (BLP Formatierung)
 ===== Installation =====
@@ Zeile 14: / Zeile 30: @@
     - MySQL: [[https://dev.mysql.com/downloads/connector/j/]|Downloadlink für MySQL/J]]
+===== Embedded Betrieb des SDG in DDI/FTP4ELO =====
+Ab Version 3.80 ist das SDG Bestandteil des DDI Pakets. Es ist somit hier nicht mehr notwendig einen eigenen Tomcat aufzusetzen, um das SDG zu betreiben, es steht einfacherweise direkt über den URI /sdg/sdg zur Verfügung. Wenn also der DDI/FTP4ELO hier auf Port 8040 (Default) lauscht dann ist das SDG über den URL http://localhost:8040/sdg/sdg erreichbar. Zusätzliche JAR-Dateien zur Datenbanktreiber müssen somit in das Lib-Verzeichnis des DDI/FTP4ELO eingespeist werden. Anders als bei der Web-Applikation gibt es hier keine echte Statusseite, da hier direkt das Servlet in den Hauptkontext des Dienstes eingespielt wird.