Sage CRM Konnektor

Der Sage CRM Konnektor repräsentiert die Schnittstelle zwischen Sage CRM und Syncler.
Die Kommunikation erfolgt standardmäßig über den SOAP-Webservice, kann jedoch um direkte Datenbankzugriffe ergänzt werden.

Direkte Datenbankzugriffe sind insbesondere bei großen Datenmengen sinnvoll, da der SOAP-Webservice durch seine Architektur in der Performance limitiert ist.
Durch diese hybride Nutzung (SOAP + Datenbankzugriff) lassen sich sowohl Kompatibilität als auch Leistungsfähigkeit sicherstellen.

Voraussetzungen

Für die Einrichtung des Konnektors müssen bestimmte technische Voraussetzungen erfüllt sein:

• Webservice-Aktivierung:
  Der Webservice in Sage CRM muss aktiviert sein. Ohne diesen ist keine Kommunikation mit Syncler möglich.

• CRM-Komponente für Syncler:
  Es muss die Komponente crmk_SynclerCrm.zip installiert sein.
  Diese Komponente aktiviert zusätzliche Tabellen für den Webservice, die für eine vollständige Synchronisation erforderlich sind.

• Benutzerberechtigungen:

  • Der für die Anmeldung am Webservice verwendete Benutzer benötigt Lese- und Schreibrechte.
  • Einschränkungen in den Berechtigungen wirken sich direkt auf den Funktionsumfang von Syncler aus.
  • Besonders wichtig: Feldberechtigungen, die Schreibrechte steuern.
    • Wird das Schreibrecht für „Alle“ verweigert, gilt dies auch für Syncler.
    • Unzureichende Rechte führen zu Fehlermeldungen beim Schreiben von Daten.

Einrichtung

1. Komponenten installieren:

   • Installieren Sie die CRM-Komponente crmk_SynclerCrm.zip.
   • Optional: Für den Zugriff auf zusätzliche Benutzerfelder empfiehlt sich die Komponente crmk_UserForWebService.zip.
     • Diese stellt ein neues Schemaobjekt bereit, über das weitere Benutzerfelder ausgelesen werden können.

2. System anlegen:

   • Legen Sie in Syncler ein neues System mit dem Konnektor „Sage CRM“ an.

3. Webservice konfigurieren:

   • Tragen Sie im Bereich Webservice die URL und die Zugangsdaten ein.
   • Speichern Sie die Konfiguration.

   

4. Optionale Konfigurationen:

   • Datenbank-Bereich:
     Wird benötigt, wenn Lesen/Schreiben per Datenbankzugriff erfolgen soll oder wenn Abfrage-Syncs genutzt werden.
   • SQL- und Datei-Brücke:
     Ermöglicht den Zugriff auf eine entfernte Datenbank, falls kein direkter Zugriff möglich ist.
   • SData-Bereich:
     Wird verwendet, um Dateien (z. B. Dokumente, Anhänge) hochzuladen.

Objekte

Die Schemaobjekte des Konnektors enthalten alle Entitäten und Sichten, die für Webservice-Zugriffe in Sage CRM freigegeben sind.

• Diese werden über den Webservice und die CRM-Metadaten ermittelt.
• Änderungen an den CRM-Metadaten erfordern ggf. eine Schema-Aktualisierung in Syncler.

Lesen von Daten

• Das Lesen von Daten ist grundsätzlich uneingeschränkt möglich.
• Der Umfang der verfügbaren Daten richtet sich nach den Berechtigungen des Webservice-Benutzers.
• Der Filter-Syntax im Sync basiert auf SQL.

Unterstützte Funktionen

• Änderungsabfragen: Der Konnektor kann gezielt Änderungen erkennen und nur diese abrufen.
• Automatische Statusverarbeitung: Sync-Status kann in den Stammdaten berücksichtigt werden.

Besonderheiten bei Auswahlfeldern

• Standardauswahlfelder:
  • Der Webservice liefert die Übersetzung (Beschriftung) und nicht den Beschriftungscode.
  • Mit speziellen Transformationen kann der Code ermittelt werden.
• Intelligente Auswahlfelder:
  • Geben immer den Code/DB-Wert zurück.

Erweiterung über Datenbankzugriff

• Mit einer konfigurierten Datenbankverbindung können zusätzliche SQL-Abfragen genutzt werden.
• Diese ermöglichen eine flexible Datenabfrage außerhalb der Webservice-Beschränkungen.

Schreiben von Daten

• Das Schreiben von Daten ist für alle Entitäten möglich, sofern der Benutzer über die nötigen Rechte verfügt.
• Einschränkungen ergeben sich ausschließlich aus den Berechtigungen im CRM.
• Das Löschen von Datensätzen wird unterstützt.

Besonderheiten

• Beim Anlegen von Personen, die einer Firma zugeordnet sind, muss der spezielle Sync für Sage CRM verwendet werden.
  • Dieser stellt die Konsistenz sicher.
  • Zusätzlich wird automatisch ein Eintrag in der Tabelle Person_Link erstellt.

Besonderheiten & Einschränkungen

• Feldnamen:

  • Felder werden ohne DB-Präfix angesprochen.
  • Felder mit einer Zahl nach dem Präfix sind nicht verfügbar, da dies im XML zu ungültigen Namen führt.

• Felder mit Kürzel "sp_":

  • Diese führen zur kompletten Ablehnung der Entität.
  • Ursache: Verdacht auf mögliche SQL-Injektionen.

• Kommunikationsdatensätze:

  • Wenn einem Kommunikationsdatensatz ein CRM-Benutzer als Organisator zugewiesen wird, prüft Syncler, ob dieser Benutzer auch als CRM-Benutzer hinterlegt ist.
  • Dadurch wird die Konsistenz zwischen Kommunikations- und Benutzerdaten sichergestellt.