Merge pull request #354 from it-at-m/add-doc-full-access-oracle-db

Dokumentation system Zugriff auf Docker Oracle DB

docs/.vitepress/config.mts

@@ -57,7 +57,8 @@ export default withMermaid({
                 {text: 'Auth-Service', link: `${PATH_FEATURES}auth-service/`},
             ],
             [PATH_GUIDES]: [
-                {text: 'API-Client generieren', link: `${PATH_GUIDES}how-to-create-client-from-open-api-json.md`}
+                {text: 'API-Client generieren', link: `${PATH_GUIDES}how-to-create-client-from-open-api-json.md`},
+                {text: 'Tips und Tricks', link: `${PATH_GUIDES}tips-and-tricks.md`},
             ]
         },
 

docs/src/guides/tips-and-tricks.md

@@ -0,0 +1,33 @@
+# Tips und Tricks
+
+## Zugriff auf Datenbanktabellen aller Services in einer Verbindung
+
+Für jeden Service gibt es einen separaten User für die Oracle Datenbank die in Docker läuft. Diese User können
+nur die Tabellen sehen, die im jeweiligen Schema sind. Der User `wls_basisdaten_service` kann
+z.B. nur die Tabellen `handbuch`, `kandidat` oder `wahlvorschlag` sehen.
+
+<details>
+
+<summary>Screenshots</summary>
+
+![mehrere Schemata ausgewählt](/tipsAndTricks/MultipleSchemasSelected.png)  
+*Auch wenn mehrere Schemata ausgewählt sind ...*
+
+![nur Basisdatenservicetabellen sichtbar](/tipsAndTricks/OnlyBasisdatenServiceTablesAccessible.png)  
+*so sieht man doch nur die Tabellen zum Basisdatenservice*
+
+</details>
+
+Mit dem User `system` kann man auf alle Schemata zugreifen und hat somit Zugriff auf alle Tabellen aller
+Services. Das Passwort ist der Wert von `ORACLE_PASSWORD` aus dem `docker-compose.yml`-File. Dort sind auch die
+Verbindungsdaten enthalten die man zum Einrichten des Zugriffs benötigt.  
+Mit IntelliJ kann man bei den Properties der entsprechenden Datasource unter dem Reiter 'Schemas' auswählen, welche
+Schemata man zusätzlich angezeigt haben möchte. Per Default ist nur das Schema SYSTEM zu sehen.
+<details>
+
+<summary>Screenshot</summary>
+
+![Tabellen zu allen Services sind verfügbar](/tipsAndTricks/MutlipleSchemasAccessible.png)  
+*Zugriff auf alle Tabellen der verschiedenen Schemata*
+
+</details>