Datenbackends und Provider
Sparks verbindet verschiedene Provider (Datenquellen) für Kalender, Kontakte, Aufgaben und Speicher. Sie können mehrere Provider parallel nutzen; die Daten werden zusammengeführt angezeigt.
Language / Language: English
Übersicht
| Bereich | Unterstützte Provider | Protokoll |
|---|---|---|
| Kalender | Microsoft Outlook, Sparks Termine (Scheduler), Google, Nextcloud, Open-Xchange | Graph API, Scheduler API, Google Calendar API, CalDAV, OX API |
| Kontakte | Microsoft Outlook, Nextcloud, Open-Xchange, Google (in Entwicklung) | Graph API, CardDAV, OX API, Google People API |
| Aufgaben | Microsoft Planner, Nextcloud Tasks, Open-Xchange, Google (in Entwicklung) | Graph API, Nextcloud API, OX API, Google Tasks API |
| Speicher | Microsoft OneDrive, WebDAV | Graph API, WebDAV |
| Chat | Matrix | Matrix-Protokoll |
| Teams | Microsoft | Microsoft Graph API |
Sparks Cloud vs. eigene Nextcloud-Instanz
In Deployments mit gehosteter Sparks Cloud (technisch: Sparks-Cloud-PIM/WebDAV, z. B. über VITE_SPARKS_CLOUD_WEBDAV / Server-seitige Anbindung) gibt es für Kalender, Kontakte, Aufgaben und Dateispeicher zwei mögliche Wege über die Nextcloud-Anbindung in der App:
| Sparks Cloud | Nextcloud (eigener Server) | |
|---|---|---|
| Kurz | Daten über die von Sparks betriebene Nextcloud; Anmeldung mit Ihrem Sparks-/OIDC-Konto (kein Nextcloud-Passwort im Browser). | Beliebige eigene Instanz: Basis-URL, Benutzername, App-Passwort werden in Sparks gespeichert. |
| Parallel? | Nein für denselben Datenkanal: Wenn Sie Nextcloud (eigenen Server) verbinden, wird Sparks Cloud für Kalender, Kontakte, Aufgaben und Dateispeicher deaktiviert; beim Verbinden erscheint ein Hinweis. Wechsel zurück zu Sparks Cloud entfernt die gespeicherte eigene Nextcloud-Verbindung nach Bestätigung. | Siehe links. |
| In den Einstellungen | Unter Provider-Konten erscheinen zwei Zeilen (Sparks Cloud und Nextcloud). Ist Nextcloud aktiv, sind Abmelden und der Aktiv-Schalter bei der Sparks-Cloud-Zeile entsprechend eingeschränkt. |
Microsoft, Open-Xchange, Google usw. sind davon unabhängig und weiter parallel nutzbar.
Kalender-Provider
Microsoft Outlook
- Voraussetzung: Microsoft-/Office-365-Konto
- Einrichtung: Einstellungen → Provider-Konten → Kalender → Microsoft verbinden
- Funktionen: Vollständige Kalendersynchronisation, Serientermine, Teilnehmer, Scheduling Assistant, Online-Meetings
- OAuth: Anmeldung über Microsoft-Konto, Berechtigungen für Kalenderzugriff
Sparks Cloud (CalDAV, gehostet)
- Voraussetzung: Sparks Cloud durch den Betreiber bereitgestellt; PIM/WebDAV für Sparks aktiviert.
- Einrichtung: Einstellungen → Provider-Konten → Sparks Cloud verbinden (Dialog „Sparks Cloud“) bzw. über die Karten unter Angemeldete Konten.
- Hinweis: Schließt die gleichzeitige Nutzung einer eigenen Nextcloud-URL für Kalender/Kontakte/Aufgaben/Dateien aus (siehe Abschnitt oben).
Nextcloud (CalDAV, eigener Server)
- Voraussetzung: Nextcloud-Server mit CalDAV
- Einrichtung: CalDAV-URL, Benutzername, Passwort oder App-Passwort
- Funktionen: Kalendersynchronisation, mehrere Kalender, Serientermine
- Hinweis: CalDAV-URL z.B.
https://nextcloud.example.com/remote.php/dav/calendars/USER/CALENDAR/
Open-Xchange
- Voraussetzung: Open-Xchange-Account (OX App Suite)
- Einrichtung: OX-Server-URL, Anmeldedaten
- Funktionen: Kalendersynchronisation, Teilnehmer, Serientermine
- Typische Nutzer: Organisationslösungen mit OX-Backend
Sparks Termine (Scheduler)
- Voraussetzung: Sparks-Appointment-Manager (Scheduler) konfiguriert
- Einrichtung: Automatisch über Autoconfig (appointment_manager.base_url)
- Funktionen: Termine mit Online-Meeting-Links, Matrix-Raum-Verknüpfung, Join-URLs (
/j/c/:appointmentId) - Besonderheit: Oft parallel zu Microsoft Exchange – Meetings werden in Exchange gespeichert und mit Scheduler synchronisiert
Google Calendar
- Voraussetzung: Google-Konto (OAuth über Backend)
- Einrichtung: Einstellungen → Provider-Konten → Kalender → Google verbinden
- Funktionen: Vollständige Kalendersynchronisation, Google-Meet-Links, Serientermine, Teilnehmer
- OAuth: Anmeldung über Google; Tokens werden serverseitig verwaltet
Kontakte-Provider
Microsoft Outlook
- Voraussetzung: Microsoft-/Office-365-Konto
- Einrichtung: Einstellungen → Provider-Konten → Kontakte → Microsoft verbinden
- Funktionen: Kontakte lesen, bearbeiten, hinzufügen; „Kopieren zu Microsoft“ (benötigt Contacts.ReadWrite)
- OAuth: Berechtigungen für Kontaktzugriff
Sparks Cloud (CardDAV, gehostet)
- Voraussetzung / Hinweis: Wie Kalender; gemeinsamer Modus mit Nextcloud (eigener Server) – nicht parallel.
Nextcloud (CardDAV, eigener Server)
- Voraussetzung: Nextcloud mit CardDAV
- Einrichtung: CardDAV-URL, Anmeldedaten
- Funktionen: Kontakte synchronisieren, bearbeiten
- URL: z.B.
https://nextcloud.example.com/remote.php/dav/addressbooks/users/USER/CONTACTBOOK/
Open-Xchange
- Voraussetzung: Open-Xchange-Account
- Einrichtung: OX-Server, Anmeldedaten
- Funktionen: Kontakte lesen und bearbeiten
Google (in Entwicklung)
- Voraussetzung: Google-Konto
- Einrichtung: Einstellungen → Provider-Konten → Kontakte → Google verbinden
- Status: Google People API – Implementierung in Arbeit
Aufgaben-Provider (Planner)
Microsoft Planner
- Voraussetzung: Microsoft-/Office-365-Konto mit Planner
- Einrichtung: Einstellungen → Provider-Konten → Aufgaben → Microsoft verbinden
- Funktionen: Pläne, Buckets, Aufgaben, Zuweisungen, Fälligkeiten, Priorität, „Zu Meinem Tag“, Charts
- Struktur: Plan → Bucket → Aufgabe
Sparks Cloud (Aufgaben, gehostet)
- Voraussetzung / Hinweis: Wie Kalender; gemeinsamer Modus mit Nextcloud (eigener Server) – nicht parallel.
- Funktionen: Graph-kompatibler Planner-Umfang mit Plänen, Buckets, Aufgaben, Prioritäten und Zuweisungen.
Nextcloud Tasks (eigener Server)
- Voraussetzung: Nextcloud mit Tasks-App
- Einrichtung: Nextcloud-Verbindung
- Funktionen: Aufgabenlisten, Fälligkeiten, Kalender-zu-Aufgaben-Mapping
Open-Xchange Tasks
- Voraussetzung: Open-Xchange mit Tasks
- Einrichtung: OX-Server
- Funktionen: Aufgaben synchronisieren und verwalten
Google Tasks (in Entwicklung)
- Voraussetzung: Google-Konto
- Einrichtung: Einstellungen → Provider-Konten → Aufgaben → Google verbinden
- Status: Google Tasks API – Implementierung in Arbeit
Speicher-Provider
Microsoft OneDrive
- Voraussetzung: Microsoft-/Office-365-Konto
- Einrichtung: Einstellungen → Provider-Konten → Speicher → OneDrive verbinden
- Funktionen: Dateien hochladen, teilen, von Chat/Kanälen aus öffnen
Sparks Cloud (Dateispeicher, gehostet)
- Voraussetzung: Sparks-Cloud-WebDAV aktiviert.
- Einrichtung: Über Angemeldete Konten / Provider-Konten → Sparks Cloud; keine separate WebDAV-URL im Client nötig.
- Hinweis: Ist Nextcloud (eigener Server) für Dateien verbunden, ist die Sparks-Cloud-Zeile im Bereich Dateispeicher entsprechend deaktiviert.
WebDAV / Nextcloud (eigener Server)
- Voraussetzung: WebDAV-fähiger Server (z.B. Nextcloud, eigene Server)
- Einrichtung: WebDAV-URL, Benutzername, Passwort
- URL-Format:
https://server.example.com/remote.php/webdav/(Nextcloud)
Matrix (Chat)
Matrix ist das primäre Chat-Backend von Sparks – kein optionaler Provider, sondern Basis der Anmeldung.
- Matrix-Server: Vom Administrator oder Hosting bereitgestellt
- Funktionen: Ende-zu-Ende-Verschlüsselung, Räume, Spaces, Reaktionen, Dateien
- Keine parallele Anbindung: Ein Matrix-Konto pro Sparks-Sitzung
Bestehender Matrix-Server (Räume und Verlauf schon vorhanden)
In der üblichen Auslieferung melden Sie sich mit dem Organisations-Login an (OpenID Connect, z. B. Keycloak). Die App holt anschließend eine Matrix-Sitzung auf dem Homeserver, den der Betreiber per Mandanten-Autoconfig vorgibt. Es gibt keinen separaten „Import“ von Räumen: Nach dem Sync erscheinen bestehende Räume und der Verlauf in der Chatliste wie in jedem Matrix-Client, sofern Sie dieselbe Matrix-Identität (@localpart:domain) wie zuvor nutzen.
Kurz-Checkliste für den Betrieb:
- Autoconfig des Mandanten auf die richtige Homeserver-URL (und ggf. Server-Typ bei Tuwunel vs. Synapse-SSO) zeigen.
- IdP und Matrix so abstimmen, dass jede Person dieselbe MXID behält wie mit Element/altem Client.
- Bei Web: Browser-Zugriff auf die Matrix-API erlauben (CORS am Homeserver oder Reverse-Proxy).
Manche Organisationen nutzen einen separaten Modus „Legacy Synapse“ (Matrix-Passwort gegen eine fest hinterlegte Homeserver-URL in den Org-Einstellungen). Das betrifft vor allem Migration oder Sonderverträge; beim Betreiber nachfragen, ob dieser Weg aktiv ist und wie die Anmeldung erfolgen soll.
Microsoft Teams
- Voraussetzung: Microsoft-/Office-365-Konto
- Einrichtung: Microsoft-Konto verbinden (oft zusammen mit Kalender/Kontakte)
- Funktionen: Teams Chat (1:1), Teams Channels (Kanäle), Kanalliste, Beiträge, Dateien
- API: Microsoft Graph
Anrufe und Call Log
- Anrufe: Echtzeit-Videodienste, vom Administrator bereitgestellt
- Anrufverlauf (Call Log): Datenquelle hängt vom Deployment ab:
- Telefonie-/Conf-Backend (typisch): Oft OIDC; Einträge kommen aus dem Backend der Organisation.
- Vista Node (Selbstbetrieb, optional): Mit aktiviertem lokalen Call-Log legt der Vista-Node Teilnahmezeilen an (u. a. Verknüpfung mit Matrix-Raum); mit PostgreSQL bleiben Einträge und Mitschrift-Sessions über Neustarts erhalten.
- Mitschriften / Transkripte:
- Live-Untertitel im Meeting sind von der dauerhaft gespeicherten Mitschrift im Anrufverlauf getrennt; Letztere setzt passendes Server-Setup voraus (Transcriber, Datenbank).
- Sichtbarkeit der gespeicherten Mitschrift kann der Betrieb steuern (z. B. nur die eigene Call-Log-Zeile oder – wenn aktiviert – gemeinsame Inhalte für Teilnehmer desselben Matrix-Raums im selben Zeitfenster).
- Nach Ende des Meetings kann der Server Sitzungen abschließen und temporäre RAM-Puffer leeren (Webhooks der Videoinfrastruktur, z. B.
room_finished, optional Wartezeit bei „Raum leer“). Konfigurationsvariablen: technische Referenz im Projekt Vistameet-Teams unterserver/.env.example(u. a.MEETING_TRANSCRIPT_LIFECYCLE,MEETING_EMPTY_ROOM_GRACE_MS,CALL_LOG_TRANSCRIPT_SCOPE).
Standard-Provider
Bei mehreren verbundenen Providern können Sie in Einstellungen einen Standard-Provider festlegen. Beim Erstellen neuer Termine, Aufgaben oder Kontakte wird dieser bevorzugt vorgeschlagen.