AG-VIP Konnektor

Der AG-VIP Konnektor stellt die Schnittstelle zwischen AG-VIP und Syncler dar.
Der Zugriff auf AG-VIP erfolgt standardmäßig über eine direkte Datenbankverbindung.

Sollte die Datenbank nicht direkt erreichbar sein (z. B. aufgrund von Netzwerkrestriktionen oder Firewalls), kann zusätzlich die SQL-Brücke installiert werden. Diese ermöglicht den sicheren Zugriff auf eine entfernte Datenbank über eine definierte Schnittstelle.

Voraussetzungen

Für den Einsatz des Konnektors müssen folgende Voraussetzungen erfüllt sein:

• Zugangsdaten für die Datenbank (z. B. Benutzername/Passwort oder Windows-Authentifizierung).
• Wenn eine Windows-Authentifizierung genutzt wird:
  • Syncler muss on-premises betrieben werden, oder
  • die SQL-Brücke muss im Kontext eines freigegebenen Benutzers laufen.
• Falls erforderlich, wurde die SQL-Brücke bereits installiert und konfiguriert.

⚠️ Hinweis: Stellen Sie sicher, dass der verwendete Benutzer über ausreichende Rechte für Lesen, Schreiben und Löschen verfügt. Einschränkungen in den Datenbankrechten wirken sich direkt auf die Funktionsfähigkeit des Konnektors aus.

Einrichtung

1. Neues System anlegen

• Erstellen Sie in Syncler ein neues System mit dem Konnektor „AG-VIP“.

2. Authentifizierung konfigurieren

• Geben Sie die SQL-Verbindungsdaten (Servername, Datenbank, Benutzer, Passwort) ein.
• Falls kein direkter Zugriff möglich ist, hinterlegen Sie zusätzlich die Zugangsdaten zur SQL-Brücke.

3. Verbindung testen

• Nach dem Speichern prüft Syncler die Erreichbarkeit der Datenbank.
• Fehler bei der Anmeldung oder fehlende Berechtigungen werden bereitgestellt.

Objekte

Nach erfolgreicher Einrichtung werden Schemaobjekte aus der AG-VIP-Datenbank generiert.

Standardmäßig enthalten:

• Adressen (zentrale Stammdatenbasis)

Optional enthalten:

• Bestellhistorie (falls konfiguriert)
• Warenkorb (falls konfiguriert)

Lesen von Daten

• Das Lesen von Daten ist grundsätzlich uneingeschränkt möglich.
• Unterstützt werden:
  • Änderungsabfragen (ermöglichen das effiziente Abrufen nur veränderter Datensätze).
  • Filter im SQL-Syntax (z. B. WHERE-Bedingungen).
  • Abfrage-Syncs mit frei formulierten SQL-Abfragen.

Schreiben von Daten

• Das Schreiben von Daten ist für alle Schemaobjekte möglich.
• Es können Datensätze erstellt, aktualisiert und gelöscht werden.
• Gelöschte Datensätze werden vollständig aus der Datenbank entfernt.

Besonderheiten

• Die Kommunikation erfolgt vollständig auf SQL-Ebene, daher gelten alle Einschränkungen und Besonderheiten der jeweiligen Datenbankengine.
• Bei Windows-Authentifizierung muss der Dienstbenutzer von Syncler bzw. der SQL-Brücke die erforderlichen Rechte besitzen.
• Für den Betrieb in Umgebungen mit hohen Sicherheitsanforderungen sollte der Zugriff über die SQL-Brücke mit eingeschränkten Benutzerrechten erfolgen.
• Es empfiehlt sich, regelmäßige Schema-Aktualisierungen durchzuführen, wenn sich die AG-VIP-Datenbankstruktur (z. B. neue Felder oder Tabellen) ändert.