Anbindungen
Eine Anbindung ist ein Fremdsystem, das Xchange kennt: seine Adresse, seine Anmeldung und das, was Xchange über den Aufbau seiner Daten weiß. Jede Route trägt genau eine.
Das SAP Business One, in dem Xchange arbeitet, ist bei jeder Route von selbst die andere Seite – eine Anbindung dafür entfällt.
Zwei Verbindungstypen
| Typ | Was damit angebunden wird |
|---|---|
| REST | Jedes System, das über HTTP ansprechbar ist – ein Onlineshop, das Portal eines Logistikers, ein Marktplatz. |
| SAP Business One | Eine andere Mandantendatenbank, etwa die einer Schwestergesellschaft. Xchange spricht sie über den Service Layer an. |
Im Beispiel: „Webshop Cambira“ ist eine REST-Anbindung, „Cambira Austria“ eine SAP-Business-One-Anbindung auf die Mandantendatenbank der österreichischen Schwester.
Der Typ wird beim Anlegen gewählt und steht danach fest. Soll ein System über einen anderen Typ angebunden werden, legen Sie eine neue Anbindung an.
Die Anmeldung
Xchange meldet sich bei jedem Abruf und jeder Übertragung am Fremdsystem an. Die Oberfläche kennt dafür drei Formen:
| Form | Was hinterlegt wird |
|---|---|
| Keine Authentifizierung | nichts – für Systeme, die ohne Anmeldung antworten |
| OAuth 2.0 | Token-Endpunkt, Client-ID und ein Client-Secret |
| Service-Layer-Anmeldung | Mandantendatenbank, Benutzername und ein Passwort |
Welche Formen zur Wahl stehen, hängt vom Verbindungstyp ab. Eine REST-Anbindung bietet Keine Authentifizierung und OAuth 2.0. Eine SAP-Business-One-Anbindung kennt nur die Service-Layer-Anmeldung und zeigt gleich deren Felder.
Client-Secret und Passwort werden verschlüsselt abgelegt und bleiben danach verborgen. Die Oberfläche sagt nur, ob Zugangsdaten hinterlegt sind; ersetzen lassen sie sich jederzeit.
Was bei REST und SAP Business One verschieden ist
Eine REST-Anbindung zeigt mehr Abschnitte als eine SAP-Business-One-Anbindung. Das liegt an dem, was das angebundene System selbst mitbringt:
- Feldstruktur. SAP Business One gibt seine Felder von sich aus preis; Sie rufen sie nur ab. Bei REST tragen Sie ein, wo das System seine Feldstruktur bereitstellt – dieser Eintrag ist freiwillig.
- Sammelabruf. Nur bei REST. Dort sagen Sie Xchange, wo in der Antwort des Systems die Datensätze stehen, wie es weiterblättert und wie es nur die Änderungen liest. SAP Business One antwortet immer im selben Aufbau, den Xchange schon kennt.
Die Feldstruktur
Die Feldstruktur ist das, was Xchange über die Felder des Fremdsystems weiß: welche es gibt, wie sie heißen, von welcher Art sie sind.
Sie ist freiwillig und eine große Erleichterung. Ist sie hinterlegt, bietet die Zuordnung beim Einrichten einer Route die Felder des Systems zur Auswahl an, und die Prüfung meldet ein Zielfeld, das dort fehlt. Ohne Feldstruktur tragen Sie die Feldnamen selbst ein.
Bei einer REST-Anbindung geben Sie dafür die Adresse an, unter der das System seine Feldstruktur bereitstellt, und das Format, in dem sie vorliegt.
Der Abruf der Feldstruktur und der Verbindungstest sind zwei getrennte Urteile. Jeder hat sein eigenes Ergebnis und seinen eigenen Zeitpunkt. Eine Anbindung, deren Verbindung eben noch getestet wurde, kann trotzdem eine veraltete Feldstruktur tragen, und umgekehrt.
Wenn zwei Anbindungen dasselbe Ziel meinen
Xchange weist darauf hin, wenn eine Anbindung auf dasselbe Ziel zeigt wie eine bestehende, und nennt sie beim Namen. Erlaubt ist der Fall trotzdem: es gibt Gründe dafür, etwa zwei getrennte Zugänge desselben Systems mit unterschiedlichen Rechten.
Was der Hinweis erspart, ist der andere Fall – dieselbe Adresse zweimal, aus Versehen. Dann werden Zugangsdaten zweimal gepflegt, und ein Wechsel muss an zwei Stellen nachgezogen werden.
Wenn Xchange eine Anbindung sperrt
Lehnt das Fremdsystem im laufenden Betrieb – bei einem Abruf oder einer Übertragung einer Route – die hinterlegten Zugangsdaten ab, sperrt Xchange die Anbindung. Ab diesem Moment stehen alle Routen still, die sie verwenden – auch die, deren Zeitplan fällig wird.
Sie sehen das an zwei Stellen: in der Liste der Anbindungen steht bei ihr Gesperrt, und auf der Anbindung selbst erscheint ein Hinweis, der sagt, was passiert ist und was die Sperre aufhebt – neue Zugangsdaten hinterlegen und die Verbindung testen.
Dasselbe passiert, wenn Xchange die hinterlegten Zugangsdaten nicht mehr entschlüsseln kann. Der Weg heraus ist derselbe.
Von Hand angehalten wird immer die Route. Dort wird pausiert und fortgesetzt – siehe Ausführung.
Was an anderer Stelle entschieden wird
- Welche Daten fließen, sagt die Route, die sie verwendet – siehe Routen.
- Wann etwas läuft, sagt der Auslöser der Route – siehe Auslösung.
- Welches Feld auf welches geht, sagt die Zuordnung – siehe Zuordnung.
Siehe auch
- Anbindungen (Referenz) – jedes Feld des Bildschirms
- Routen (Grundkonzept) – was eine Route aus einer Anbindung macht
- Konfigurationsstände (Grundkonzept) – warum eine geänderte Anbindung erst nach der Aktivierung im Betrieb wirkt