Sage X3 Konnektor

Der Sage X3 Konnektor stellt die Schnittstelle zwischen Syncler und dem ERP-System Sage X3 bereit.
Er ermöglicht das Lesen, Schreiben und Abfragen von Daten über den Classic SOAP Webservice.
Zusätzlich können SQL-basierte Abfragen genutzt werden, z. B. für Reports, Analysen oder erweiterte Datenabgleiche.

Damit lassen sich Stammdaten wie Kunden, Lieferanten, Artikel und Kontakte sowie Bewegungsdaten zwischen Sage X3 und anderen Systemen in Syncler austauschen.

Voraussetzungen

Vor der Einrichtung muss in Sage X3 ein Classic SOAP Pool konfiguriert werden.
Dieser dient als Webservice-Endpunkt für externe Verbindungen wie den Syncler-Konnektor.

Hinweis:
Der Classic SOAP Webservice ist Teil der Syracuse-Komponente von Sage X3 und muss aktiviert sowie erreichbar sein.

Einrichtung

Für die Einrichtung des Konnektors werden folgende Verbindungsangaben benötigt:

1. Öffnen Sie in Syncler den Bereich Systeme → Neues System anlegen.
2. Wählen Sie als Systemtyp „Sage X3“.
3. Tragen Sie die oben genannten Verbindungsparameter in die entsprechenden Felder ein.
4. Nach erfolgreicher Verbindung kann das Schema definiert werden.

Schema-Definition

Die Schemaobjekte müssen in Syncler manuell unter „Schema Definition“ angelegt werden.
Nach dem Speichern ruft der Konnektor die Eigenschaften der Objekte automatisch über den Webservice ab.

1. Standardobjekte

Folgende Standardobjekte werden in der Regel unterstützt:

Diese Objekte entsprechen den in Sage X3 verfügbaren Webservice-Objekten und können direkt verwendet werden.

2. Anpassung für Änderungsabfragen

Damit der Konnektor auch Änderungen erkennen und abrufen kann, muss die Objektdefinition in Sage X3 erweitert werden.
Das Feld für das Änderungsdatum gehört nicht standardmäßig zu den SOAP-Feldern und muss daher manuell ergänzt werden.

Vorgehen:

1. Öffnen Sie in Sage X3 das entsprechende Datenbankobjekt (z. B. BPC).

2. Wechseln Sie in den Bereich „Auswahl“.

3. Fügen Sie eine neue Zeile hinzu, die das Änderungsdatum enthält.

4. Tragen Sie folgenden Ausdruck ein:

   num$([F:BPC]UPDDATTIM])
   

   Einstellung	Wert
   Typ	A (alphanumerisch)

5. Notieren Sie sich die Zeilennummer des neuen Eintrags, da diese bei der Schema-Definition in Syncler benötigt wird.

3. Beispiel – Kundendaten

Eine beispielhafte Schema-Definition für Kundendaten (BPC) in Syncler:

Nur wenn das Updated Field korrekt angegeben ist, kann Syncler inkrementelle Änderungsabfragen durchführen.
Andernfalls können nur komplette Listen abgerufen werden.

4. Verwendung von Webservice-Objekten

Es können in Sage X3 eigene Webservice-Objekte definiert werden, die Syncler konsumieren kann.
Diese werden im Bereich:

Entwicklung → Skript-Dictionary → Web Services

angelegt.

Dort lassen sich vordefinierte SOAP-Objekte oder auch benutzerdefinierte Services definieren, die nur bestimmte Felder, Filter oder Berechtigungen enthalten.
Diese Objekte können anschließend in Syncler referenziert werden.

Beispiel:
Ein Webservice-Objekt, das nur „aktive Kunden“ liefert, kann über einen Standardfilter in Sage X3 konfiguriert werden.
Der Syncler-Konnektor berücksichtigt diesen Filter automatisch.

Besonderheiten

• Änderungsdaten sind nur über ein manuell definiertes Updated Field verfügbar.
• SOAP-Objekte können Standardfilter enthalten (z. B. nur aktive Datensätze).
• Kontakte (CONTACTCRM) können mehreren Kunden zugeordnet sein.
  Dabei wird über die interne Struktur in Sage X3 eine definierte Rolle des Kontakts abgebildet.
• Die Sprachsteuerung (GER, ENG, FRA) beeinflusst die Rückgabe von Textfeldern.