Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- basis:configuration:embed [2025/11/10 15:06] – angelegt nullrich
+++ basis:configuration:embed [2025/11/10 15:15] (aktuell) – nullrich
@@ Zeile 1: / Zeile 1: @@
-====== Einbetten externer bzw. zusätzlicher Module======
+====== Einbetten externer bzw. zusätzlicher Module ======
 > **Zielgruppe:** Mandanten-Administrator:innen, Systemverantwortliche, technische Integrator:innen
@@ Zeile 32: / Zeile 32: @@
 Fügen Sie über das **CAATS Skript** eine neue Einstellung hinzu.
 Der **Schlüsselbegriff** muss wie folgt aufgebaut sein:
+**Beispiel:** DASH.EMBEDDED_EXTENSION.<modulname>.url
+DASH.EMBEDDED_EXTENSION.taxiplanung.url
+**4. Berechtigungen und Navigation konfigurieren (optional)**
+Falls notwendig, fügen Sie für das einzubettende Modul eine **Berechtigungsdefinition**
+und einen passenden **Menü-Navigationspfad** hinzu.
+**5. Modul im Dashboard eintragen**
+Gehen Sie im Menü zu:
+`ADM > Einstellungen > Mandant > Dashboard`
+und tragen Sie dort die vollständige **URL zum externen Modul** ein.
+<wrap tip>
+💡 **Tipp:**
+Achten Sie darauf, dass das Modul in einem **iframe** eingebettet werden kann
+und dass die externe Seite HTTPS unterstützt.
+</wrap>
+----
+===== 4. Platzhaltervariablen für URLs =====
+In der URL können bestimmte **dynamische Variablen** verwendet werden,
+um Benutzerkontext und Sprache automatisch an das externe System zu übergeben:
+| Variable | Bedeutung | Beispiel |
+|-----------|------------|----------|
+| `{jwt}` | Der aktuelle **JSON Web Token** des angemeldeten Benutzers. Ermöglicht die Authentifizierung im externen System. | `https://externes-system.at/?token={jwt}&param=xyz` |
+| `{lcid}` | Das **ISO-Sprachkürzel** der aktuellen Benutzeroberfläche (z. B. `de` oder `en`). | `https://unsere-taxiplanung.at?language={lcid}` |
+<wrap important>
+**Wichtig:**
+Verwenden Sie Variablen **immer in geschweiften Klammern** (`{}`),
+da CAATS sie beim Laden automatisch ersetzt.
+Das externe System muss die Übergabeparameter **jwt** und **lcid** auswerten können.
+</wrap>
+----
+===== 5. Technische Hinweise =====
+  * Die eingebetteten Module werden im **Dashboard** unter einem eigenen Menüpunkt angezeigt.
+  * Jedes eingebettete Modul wird in einer **eigenen Registerkarte (iframe)** geöffnet.
+  * Die Kommunikation zwischen CAATS und dem externen Modul erfolgt ausschließlich über HTTPS.
+  * Administrator:innen können mehrere Module gleichzeitig registrieren –
+    z. B. `taxiplanung`, `statistik`, `intranet`.
+<wrap tip>
+**Tipp:**
+Wenn das externe System eine Single-Sign-On-Authentifizierung (SSO) unterstützt,
+kann der übergebene `{jwt}`-Token direkt zur Benutzeridentifikation genutzt werden.
+</wrap>
+----
+===== 6. Beispielkonfiguration =====
+**Modulname:** `taxiplanung`
+**Einstellungsschlüssel:**
+**URL-Eintrag im Dashboard:**  https://unsere-taxiplanung.at/system/?token={jwt}&language={lcid}
+Nach dem Speichern erscheint das Modul im Dashboard-Menü.
+Benutzer:innen mit entsprechender Berechtigung können es direkt öffnen.
+----
+===== 7. Zusammenfassung =====
+Mit dieser Funktion können Organisationen **eigene Anwendungen** oder **Drittmodule**
+in die Benutzeroberflächen **CAATS Desktop** und **CAATS Mobile** integrieren.
+So lassen sich externe Systeme zentral anbinden, ohne die Benutzeroberfläche zu verlassen.
+<wrap round info>
+📘 **Siehe auch:**
+  * [[adm-cockpit:system:dashboard|Dashboard-Konfiguration und Layout]]
+  * [[adm-cockpit:administration:permissions|Berechtigungen und Rollenverwaltung]]
+  * [[adm-cockpit:processes:extensions|Systemerweiterungen und Integrationen]]
+</wrap>
+----
+**Schlagworte:** embedded-modules, dashboard, einbettung, iframe, jwt, lcid, url, taxiplanung, mandantenadministrator, externe-module, integration, caats, desktop, mobile