Konnektoren
Schemaobjekte
Die SQL- und Dateibrücke
Das OAuth 2.0 Verfahren
Gesperrte Datensätze

CAS genesisWorld Konnektor

Der CAS genesisWorld Konnektor ermöglicht die bidirektionale Synchronisation von Datensatztypen über die REST API.
Zusätzlich können E-Mails und Dokumente archiviert, Bulk-Importe ausgeführt sowie Views abgefragt werden.

  • Schema-basierte und Abfrage-basierte Datenzugriffe erfolgen über die REST API.
  • Für Abfragen wird der CAS-spezifische SQL-Syntax genutzt, der zusätzliche Funktionen für Dossiers, Verknüpfungen und Filter bereitstellt.
  • Es stehen spezifische Sync-Vorlagen für Integrationen mit Sage b7, Microsoft Dynamics Business Central, Sage 100, Sage X3 und Mailing-Anbietern zur Verfügung.
  • Weitere Systeme und Entitäten können über Universalsyncs angebunden werden.

⚠️ Hinweis:
Aus historischen Gründen kann der Konnektor auch mit CAS SmartWe eingesetzt werden.
Nicht alle Funktionen stehen dort zur Verfügung – es existiert ein eigener SmartWe-Konnektor, der bevorzugt genutzt werden sollte.

Voraussetzungen

  • Der Webservice-Dienst von CAS muss verfügbar sein.
  • Für die Verbindung werden benutzerbezogene Zugangsdaten benötigt.
  • Bei Bulk-Imports ist die Einrichtung der CAS SOAP Bridge erforderlich.

Einrichtung

1. Neues System anlegen

  • Erstellen Sie in Syncler ein neues System mit dem Konnektor „CAS genesisWorld“.
  • Tragen Sie dort die Webservice-URL, den Datenbanknamen sowie die Zugangsdaten ein.

image

2. Einstellungen

URL REST API

  • URL der REST API.
  • Beispiel für SmartWe:

https://api.smartwe.de/SmartWe/rest/v6.0

Benutzername

  • Benutzername der Zugangsdaten.

Passwort

  • Passwort der Zugangsdaten.

Datenbank

  • Name der Datenbank bzw. des Mandanten.

SmartWe

  • Kennzeichnung, ob das Zielsystem SmartWe ist.

Bridge URL (optional)

  • URL zur CAS SOAP Bridge.

CAS SOAP URL (optional)

  • URL zur SOAP-Schnittstelle.
  • Beispiel für SmartWe:

https://api.smartwe.de/SmartWe/services

Bridge Timeout (optional)

  • Timeout für Aufrufe der Bridge URL (in Millisekunden).
  • Standard: 100000.
  • Anpassung sinnvoll bei Bulk-Verarbeitung, wenn es zu Timeout-Meldungen kommt.

Maximale Anzahl von Datensätzen je Aufruf

  • Paketgröße für Bulk-Importe.
  • Praxiswerte: 100–200 Datensätze pro Aufruf.
  • Das Timeout beeinflusst die maximale Größe.

Feldname Massen-Neuanlage (optional)

  • Feldname zur Wiedererkennung angelegter Datensätze bei Bulk-Importen.
  • Muss manuell als Textfeld in CAS angelegt werden.
  • Ohne dieses Feld können keine IDs aus dem Bulk-Import ermittelt werden.

Abfrage von Berechtigungen deaktivieren

  • Deaktiviert das Lesen von Berechtigungen, Schreiben bleibt möglich.
  • Vorteil: Schnellere Lesegeschwindigkeit durch weniger Abfragen.

Prüfung von Pflichtfeldern deaktivieren

  • Deaktiviert die Schema-Prüfung von Pflichtfeldern.
  • Nur in Ausnahmefällen empfohlen.

Objekte

  • Das Schema wird über die REST API ermittelt.
  • Basis: Verfügbare Datenobjekte im System.
  • Zusätzlich erweitert um:
  • Benutzer, Verknüpfungen, Papierkorb, Views
  • DOCUMENT & EMAILSTORE: Feld FileContent (Base64 für Dokumente/E-Mails)
  • APPOINTMENT, TODO, GWPHONECALL: erweiterte Felder für Participants, LinkToAddress, LinkToGWOpportunity
  • GWOPPORTUNITY, BSVOUCHER: geschachtelte Positionslisten
  • GWDISTRIBUTION: geschachtelte Liste für ADDRESS-Verweise

⚠️ Hinweis:

  • Berechtigungen und Verknüpfungen können für alle Datentypen festgelegt werden.
  • Bei Participants und Positionslisten handelt es sich um geschachtelte Strukturen.

Lesen von Daten

  • Alle Abfragen (außer Einzeldatensätze) werden über query-Statements ausgeführt.
  • Automatische Erweiterung um:

TEAMFILTER(Objektname; CASLOGGEDINUSER; CASPUBLICRECORDS; CASEXTERNALACCESS)

  • Bei Abfrage-Syncs muss der TEAMFILTER manuell hinzugefügt werden, um Daten-Duplikate zu vermeiden.

Unterstützt

  • Änderungsabfragen
  • Automatische Filterung des Sync-Status

Schreiben von Daten

  • Schreiben erfolgt über die REST API.
  • Unterstützt:
  • Anlegen, Aktualisieren und Löschen von Datensätzen
  • Direkte Verknüpfungen (anlegen/löschen)
  • Berechtigungen, Verknüpfungen und Listen an Schema-Objekten

⚠️ Einschränkungen:

  • Benutzer können nicht geschrieben werden.

Bulk-Daten

  • Nur über die CAS SOAP Bridge möglich.
  • Funktionsweise:
  • Bulk-Daten werden in Paketen (z.B. 1000 Datensätze) übermittelt.
  • SOAP-Bridge verarbeitet diese und übergibt sie an CAS.
  • Besonderheiten:
  • Berechtigungen können nur einheitlich vergeben werden.
  • Generierte IDs erfordern ein zusätzliches GUID-Feld in CAS.
  • CAS-Zugangsdaten werden verschlüsselt an die API übergeben.

Besonderheiten

  • Das Schema wird automatisch erweitert um:

  • Permission (Berechtigungen)

  • LinkTo & LinkFrom (Verknüpfungen)

  • Berechtigungen:

  • Standard:

    ACCESSRIGHT = 32768  
RIGHTOWNER = 00000000000000000000000000000000

    → Vollzugriff für alle Benutzer

  • Weitere Levels:

    • Lesen = 64
    • Bearbeiten = 2048
    • Löschen = 8192

  • Archivierung von E-Mails über EMAILSTORE:

  • Feld FileContent = EML-Datei im Base64-Format

  • E-Mails werden im CAS archiviert

  • Weitere Felder können für Verknüpfungen oder Metadaten genutzt werden

  • Archivierung erfolgt nur bei neuen Datensätzen (keine Updates)

  • Verknüpfungen:

  • Über API-Aufrufe gesteuert

  • Zuweisung einer leeren GUID überspringt die Anlage

⚠️ Wichtig:

  • Werden Datensätze ohne Berechtigungen angelegt, sind diese für Benutzer im CAS nicht sichtbar.