AnleitungenEinrichtung
Bestehende Daten übernehmen
Daten aus einem anderen System per CSV oder API importieren.
Überblick
Dieser Leitfaden zeigt, wie du bestehende Daten in iglesio übernimmst. Zwei Wege stehen zur Auswahl: CSV-Import (empfohlen, stabil) und direkte API-Anbindung (in Entwicklung).
Bevor du startest
- Du brauchst Admin-Rechte.
- Für CSV: eine UTF-8-codierte Datei mit Überschriften-Zeile.
- Für API: Zugangsdaten für dein Quellsystem.
Option A: CSV-Import
- Öffne Einstellungen → Kirche → Import (
/settings/church/import). - Lade die CSV hoch.
- Ordne Spalten im Mapping-Schritt den iglesio-Feldern zu.
- Starte den Import.
- Nach Abschluss siehst du:
{n} Personen hinzugefügt, {m} als Duplikate übersprungen, {e} Fehler.
Details siehe Personen importieren.
Option B: API-Verbindung
- Öffne Einstellungen → Kirche → API-Verbindungen (
/settings/church/api-connections). - Wähle ein System:
Planning Center,ChurchTools,Elvanto,ChurchSuite,Subsplash. - Gib die geforderten Zugangsdaten ein:
- OAuth 2.0: du wirst beim Anbieter authentifiziert.
- API-Schlüssel: trage App-ID, Secret, Token, Instanz-URL oder Subdomain ein, je nach System.
- Klicke Verbindung testen.
- Bei Erfolg startest du Daten entdecken — iglesio zeigt, wie viele Personen und Gruppen gefunden wurden.
- Klicke Jetzt importieren, um die Synchronisation zu starten.
Laufende und vergangene Synchronisationen siehst du im Synchronisationsverlauf.
Die direkten API-Migrationen sind teilweise ausgeliefert (Coverage 13.8, partial). Spezifische Mappings pro CMS und alle OAuth-Flows sind nicht in allen Systemen vollständig bestätigt. Bei Problemen den CSV-Weg als verlässlichen Fallback nutzen.