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

CAS SmartWe Konnektor

Der CAS SmartWe Konnektor ermöglicht die bidirektionale Synchronisation von Datensatztypen über die REST API.
Zusätzlich können E-Mails und Dokumente archiviert 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.

Voraussetzungen

  • Für die Verbindung werden benutzerbezogene Zugangsdaten benötigt.

Einrichtung

1. Neues System anlegen

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

2. Einstellungen

URL REST API

  • URL der REST API.
  • Beispiel:

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

Benutzername

  • Benutzername der Zugangsdaten.

Passwort

  • Passwort der Zugangsdaten.

Mandant

  • Name des Mandanten.

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
  • DOCUMENT & EMAILSTORE: Feld FileContent (Base64 für Dokumente/E-Mails)
  • APPOINTMENT, TODO, GWPHONECALL: erweiterte Felder für Participants, LinkToAddress, LinkToGWOpportunity
  • GWOPPORTUNITY, RECEIPT: 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.

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.

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.