Zum Hauptinhalt springen

Eine Anbindung anlegen

Cambira hat einen Logistikdienstleister dazugenommen: „Kessler Logistik“ soll künftig Lieferungen übernehmen und ihren Bearbeitungsstand zurückmelden. Bevor eine einzige Route entstehen kann, muss Xchange das System kennen – Adresse, Anmeldung, und woher es weiß, welche Felder es dort gibt.

Die Schritte folgen dem, was A. Vogt am 30. September 2026 getan hat – vom Anlegen bis zu dem Punkt, an dem eine Route die Anbindung benutzen kann.

Nach dem bestandenen Verbindungstest folgt noch die Feldstruktur (Schritt 4).

Was Sie brauchen​

  • Die Berechtigung Anbindungen in der Stufe Voll – siehe Berechtigungen.
  • Vom Fremdsystem: die Basisadresse, die Zugangsdaten und – falls vorhanden – die Adresse seiner Schnittstellenbeschreibung. Die letzte fehlt beim ersten Gespräch fast immer; sie lässt sich nachtragen, siehe Schritt 4.
  • Einstieg: Konfiguration → Anbindungen → Neue Anbindung.

Xchange sichert jede Eingabe automatisch. Im Betrieb wirkt sie erst mit dem aktivierten Konfigurationsstand.

1. Anlegen: Name und Typ​

Der Dialog Neue Anbindung fragt zwei Dinge, und das zweite entscheidet alles Weitere.

  1. Name: Kessler Logistik. Er steht später in jeder Routenliste – wählen Sie den Namen, unter dem man das System im Haus kennt.
  2. Typ: REST oder SAP Business One.
  3. Anlegen.

Der Typ lässt sich danach nicht mehr ändern. Er steht im Detail nur noch als Text da. Ein Vertippen kostet die Anbindung – legen Sie in dem Fall eine neue an und löschen Sie die falsche, solange ihre Liste Verwendung in Routen leer ist.

Er verzweigt außerdem den gesamten Rest des Bildschirms:

RESTSAP Business One
AnmeldungSie wählen die Art – z. B. OAuth 2.0immer Service-Layer-Anmeldung
Zusätzliches Pflichtfeld–Mandantendatenbank
FeldstrukturSie tragen Quelle und Format eindas System bringt sie mit
Sammelabrufvorhandenentfällt – SAP Business One beschreibt seine Antworten selbst

Für Kessler steht der Typ auf REST. Den SAP-Fall führt Stammdaten in einen zweiten Mandanten übernehmen an einem vollständigen Beispiel durch.

2. Adresse und Anmeldung eintragen​

Im Abschnitt Technische Konfiguration steht die Basisadresse: https://edi.kessler-logistik.example.com/v2. Sie ist der gemeinsame Anfang aller Aufrufe; die einzelnen Pfade tragen später die Routen.

Im Abschnitt Authentifizierung wählen Sie den Authentifizierungstyp OAuth 2.0. Darunter erscheinen zwei Felder, die Sie aus den Zugangsdaten von Kessler füllen:

  • Token-Endpunkt: https://edi.kessler-logistik.example.com/oauth/token
  • Client-ID: cambira-xchange

Unter ihnen steht das Client-Secret, zunächst mit dem Zustand Nicht konfiguriert:

  1. Klicken Sie daneben auf Ersetzen. Es öffnet sich ein Eingabefeld.
  2. Tragen Sie das Client-Secret ein und klicken Sie auf Speichern.

Der Zustand wechselt auf Konfiguriert. Das Geheimnis wird verschlüsselt abgelegt, und angezeigt wird danach nur noch dieser Zustand; wie Sie es später ersetzen, steht unter Zugangsdaten ersetzen.

Die Anmeldung einer REST-Anbindung mit OAuth 2.0 und hinterlegtem Client-Secret, vor dem ersten Verbindungstest.

3. Die Verbindung testen​

Verbindung testen schickt einen echten Aufruf an das System und meldet das Ergebnis in einem grünen oder roten Streifen. Bei Kessler war er um 09:16 grün – eine Minute nach dem Anlegen.

Der Streifen merkt sich sein Ergebnis: Erfolgreich mit Letzter Test: 30.09.2026 09:16 Uhr steht auch morgen noch dort. Ob er dann noch stimmt, zeigt erst ein neuer Test.

Bei einer SAP-Anbindung nennt der grüne Streifen zusätzlich den Mandanten, in dem der Aufruf gelandet ist. Das ist dort die eigentliche Kontrolle: Die Adresse kann stimmen und trotzdem den falschen Mandanten treffen.

Welches Ergebnis wofür steht, führt Anbindungen vollständig auf. Eines davon hat eine Folge über den Streifen hinaus: Ein fehlgeschlagener Test hält die Aktivierung auf – die Prüfung meldet die Anbindung als Fehler. Was die Prüfung zu einer ungetesteten Anbindung sagt, steht unter Die erste Anbindung.

4. Die Feldstruktur einrichten​

Diesen Schritt übersieht man leicht. Die Verbindung steht, der Streifen ist grün – und die erste Route zeigt trotzdem in jeder Feldauswahl eine leere Liste.

Der Abschnitt Feldstruktur beantwortet eine andere Frage als der Test: welche Objekte und Felder gibt es dort. Bei einer REST-Anbindung besteht er aus zwei Eingaben:

FeldBei KesslerWas es bedeutet
Quelleopenapi.jsonder Pfad zur Schnittstellenbeschreibung, unterhalb der Basisadresse
FormatOpenAPI (Version 3.0 und 3.1)in welcher Sprache diese Beschreibung verfasst ist

Darunter sitzt Feldstruktur abrufen. Die Schaltfläche holt die Beschreibung und meldet, wie viele Objekte sie gefunden hat – bei Kessler um 09:18.

Solange eines der beiden Felder leer ist, bekommen die Routen leere Listen – und zwar stillschweigend. Die Auswahl des Abrufendpunkts bleibt leer, und die Feldauswahl ebenso. Das ist der Zustand, auf dem jede neue Anbindung anfängt: Format steht auf Keine Feldstruktur. Bleibt die Liste leer, prüfen Sie deshalb zuerst die Anbindung.

Hat Ihr System dauerhaft keine Beschreibung, ist Keine Feldstruktur die richtige Angabe – wie Sie dann zuordnen, steht unter Wenn die Feldauswahl leer bleibt.

Was Test und Abruf jeweils prüfen​

Auf der Anbindung stehen zwei Streifen mit zwei Zeitstempeln – Letzter Test und Zuletzt abgerufen.

Bei „Webshop Cambira“ liegen sie weit auseinander: der Verbindungstest ist vom 08.10.2026, 08:44, die Feldstruktur vom 02.10.2026, 16:05. Beides ist in Ordnung. Ein grüner Test sagt nur, dass das System antwortet – über die Feldstruktur gibt erst das Abrufen Auskunft.

Die Beziehung ist einseitig:

Sie drücken …… und prüfen damit
Verbindung testennur die Verbindung
Feldstruktur abrufendie Feldstruktur und dabei die Verbindung

Das Abrufen ist deshalb der gründlichere der beiden Knöpfe – und die einzige Stelle, an der Sie vor der ersten Route sehen, ob die Beschreibung überhaupt lesbar ist. Drücken Sie ihn, sobald Quelle und Format stehen, und noch einmal, wenn das Fremdsystem seine Beschreibung geändert hat.

Was danach noch auf der Anbindung steht​

Der Bildschirm trägt mehr als diese vier Schritte anfassen. Zwei Abschnitte lohnen einen Blick, sobald die erste Route läuft:

  • Sammelabruf – wo in der Antwort des Systems die Datensätze stehen. Liest eine Route einen Datenbestand von dieser Anbindung ab, ist Datensätze Pflicht. Endet ein Lauf mit „Anbindung passt nicht zur Antwort“, siehe Wenn das Fremdsystem anders antwortet als erwartet.
  • Verwendung in Routen – welche Routen an dieser Anbindung hängen. Löschen lässt sich die Anbindung erst, wenn diese Liste leer ist.

Alle Felder und alle Ergebnisse vollständig: Anbindungen.

Wie es weitergeht​

Siehe auch​