Sage X3: 1. Webservice-Pool anlegen
Voraussetzungen
- Ein Sage-X3-Zugang mit Administrationsrechten
- Ein technischer X3-Benutzer für den Sync-Dienst mit der Berechtigung für Webdienste
Der Sync-Dienst spricht Sage X3 wahlweise über die neuere GraphQL-Schnittstelle oder über den klassischen SOAP-Weg an. Für SOAP verlangt Sage X3 einen sogenannten Pool. Das ist eine feste Gruppe von Verbindungen, die der Server für Webdienst-Aufrufe bereithält. Ohne laufenden Pool weist Sage X3 jeden Aufruf ab. Diese Anleitung zeigt, wie Sie den Pool anlegen und starten.
Die Pool-Verwaltung öffnen
Melden Sie sich in Sage X3 mit einem Administratorkonto an.
Klicken Sie oben rechts auf das Kompass-Symbol. Es öffnet das Navigationsmenü.
Wählen Sie links den Bereich „Administration". Klicken Sie dann in der Spalte „Webservices" auf „Classic SOAP-Pools-Konfiguration". Die Seite „Liste der SOAP-Pools" öffnet sich.
Das Navigationsmenü. 1 Der Eintrag „Classic SOAP-Pools-Konfiguration" in der Spalte „Webservices".
Den Pool anlegen
Klicken Sie rechts auf „Neuer SOAP-Pool". Das Formular „Pool-Konfiguration" öffnet sich.
Die Liste der SOAP-Pools. 1 Die Aktion „Neuer SOAP-Pool". Die Zeile zeigt einen bereits eingerichteten Pool. Füllen Sie die Pflichtfelder aus. Die Feldliste unten erklärt jedes Feld.
Das Anlege-Formular. Pflichtfelder sind mit einem Stern markiert. Rechts steht „Speichern". Klicken Sie rechts auf „Speichern". Der Pool erscheint danach in der Liste.
Die Felder des Pools
| Feld | Bedeutung |
|---|---|
| Alias* | Der Name des Pools. Genau diesen Namen tragen Sie später in der Konfigurations-Oberfläche des Sync-Dienstes im Feld „SOAP-Pool-Alias" ein. Ein kurzer Name in Großbuchstaben hat sich bewährt, zum Beispiel CITESYNC. |
| Endpoint* | Der X3-Ordner, in dem der Sync arbeiten soll. Wählen Sie den Produktivordner Ihrer Installation. |
| Gebietsschema* | Die Sprache der Pool-Verbindungen. Sie bestimmt auch Datums- und Zahlenformate der Antworten. |
| Benutzer* | Der technische X3-Benutzer, unter dem die Aufrufe laufen. Er braucht die Berechtigung für Webdienste und Zugriff auf die betroffenen Daten. Sein Kennwort darf nicht ablaufen, sonst startet der Pool irgendwann nicht mehr. |
| Autostart | Startet den Pool automatisch mit dem Server. Setzen Sie den Haken, sonst steht die Anbindung nach jedem Neustart still. |
| Maximale Größe / Initialisierungsgröße* | Wie viele Verbindungen der Pool höchstens öffnet und wie viele er beim Start vorbereitet. Für den Sync-Dienst reichen kleine Werte, zum Beispiel 4 und 2. |
* Pflichtfeld
Den Pool starten und prüfen
Öffnen Sie den Pool über seinen Alias in der Liste.
Klicken Sie rechts auf „Start/Aktualisierung". Unter „Status Kanäle" erscheinen nach kurzer Zeit Zeilen mit dem Status „Gestartet".
Der laufende Pool. Unter „Status Kanäle" stehen die geöffneten Verbindungen mit dem Status „Gestartet". Rechts finden Sie „Start/Aktualisierung" und „Anhalten". Tragen Sie den Alias in der Konfigurations-Oberfläche des Sync-Dienstes ein und klicken Sie dort auf „Verbindungen prüfen". Der Punkt „Sage X3 API" wird grün.