Systeme

Ein System oder auch Konnektor stellt die technische Anbindung eines externen Systems oder einer Funktion innerhalb von Syncler bereit.
Er bildet die Schnittstelle zwischen der Plattform und der angebundenen Umgebung und übernimmt dabei folgende Kernaufgaben:

Speicherung und Verwaltung von Zugangsdaten (z. B. API-Keys, Benutzernamen/Passwörter, Token)
Bereitstellung von Einstellungen (z. B. Abfrageparameter, Limits, Schreiboptionen)
Bereitstellung einer einheitlichen Schnittstelle für andere Elemente (z. B. Syncs, Reports, DQM-Projekte)

Neben klassischen Geschäftssystemen wie CRM oder ERP kann ein Konnektor auch generische Ein- und Ausgabekanäle abbilden, beispielsweise:

den Eingang von Daten (z. B. Push-Nachrichten, API-Aufrufe, Dateien im CSV-/XML-/JSON-Format)
den Ausgang von Daten (z. B. Serienbriefe, generierte Dokumente, E-Mails, Exportdateien)

Dadurch lassen sich sowohl technische Schnittstellen als auch fachliche Prozesse flexibel anbinden und steuern.

Standardaufgaben

Zu den zentralen Aufgaben eines Konnektors gehören:

Autorisierung: Verwaltung der Anmeldedaten und Prüfung der Zugriffsrechte. Je nach Konnektor kann dies über Basic Auth, OAuth, Token-basierte Verfahren oder proprietäre Mechanismen erfolgen.
Lesen von Daten: Abruf von Datenobjekten aus dem angebundenen System.
Schreiben von Daten: Übermittlung von Informationen oder Datensätzen an das Zielsystem.
Ermitteln eines Datenschemas: Automatische oder manuelle Abfrage der Datenstruktur, um diese für Syncs, Reports oder DQM zu verwenden.

Lesen von Daten

Beim Lesen von Daten unterscheidet Syncler grundsätzlich zwei Methoden.
Nicht jeder Konnektor unterstützt beide Varianten:

Schema-basiertes Lesen:
Daten werden anhand eines vordefinierten Schemas geladen. Diese Methode eignet sich, wenn Felder, Strukturen und Beziehungen im Voraus bekannt sind.
Abfrage-basiertes Lesen:
Daten werden dynamisch über Abfragen (z. B. SQL, API-Filter, Suchparameter) geladen. Diese Methode ist flexibler, erfordert aber häufig detailliertes Wissen über die Zielstruktur.

Speichern von Daten

Auch beim Speichern von Daten sind zwei grundlegende Verfahren möglich:

Schema-basiertes Speichern einzelner Datensätze:
Jeder Datensatz wird anhand des vordefinierten Schemas validiert und einzeln gespeichert.
Bulk-Speichern von Datensammlungen:
Mehrere Datensätze werden in einem einzigen Vorgang übertragen. Diese Methode ist performanter, erfordert aber meist spezielle Unterstützung seitens des Zielsystems.

Nicht jeder Konnektor unterstützt beide Methoden – die konkrete Ausführung hängt von den Möglichkeiten des angebundenen Systems ab.

Erweiterte Funktionen

Einige Konnektoren stellen zusätzliche Funktionen bereit, die über die Basisaufgaben hinausgehen. Beispiele:

Preisfindung in E-Commerce-Systemen

Diese erweiterten Funktionen sind konnektorspezifisch und werden in der jeweiligen Konnektor-Dokumentation detailliert beschrieben.

Schema-Verwaltung

Beim Speichern eines neuen Systems oder beim Aktualisieren eines bestehenden Systems (mit aktiviertem Schalter Schema aktualisieren) ruft Syncler das Schema des Systems ab und speichert es.

Das Datenschema bildet die Arbeitsgrundlage für die Konfiguration von schema-basierten Syncs.
Zur Verbesserung der Performance wird das Schema zwischengespeichert, um unnötige Abfragen im externen System zu vermeiden.

Änderungen am Datenschema

Wenn sich das Datenschema im externen System ändert, muss diese Änderung durch eine Schema-Aktualisierung übernommen werden. Beispiele:

Hinzufügen neuer Felder (z. B. ein zusätzliches Datenattribut in einem CRM)
Entfernen von Feldern oder Objekten
Anpassung von Feldtypen (z. B. Änderung von String auf Integer)

Mögliche Auswirkungen

Neue Felder stehen erst nach einer Schema-Aktualisierung in Syncs oder Reports zur Verfügung.
Gelöschte Felder können zu Fehlermeldungen führen, wenn diese weiterhin in Syncs oder Abfragen referenziert werden.
Bei fehlenden Informationen zum Schreibschutz kann es zu Fehlern beim Speichern von Datensätzen kommen.

Es wird daher empfohlen, nach größeren Änderungen im angebundenen System das Schema in Syncler manuell zu aktualisieren und bestehende Syncs oder Reports auf Konsistenz zu prüfen.