Zum Hauptinhalt springen

Wenn das Fremdsystem anders antwortet als erwartet

Der Lauf endet als Fehlgeschlagen, als Grund steht Anbindung passt nicht zur Antwort. Beim zweiten Mal dasselbe, und beim dritten auch. Dabei antwortet das Fremdsystem, und seine Antwort ist gültiges JSON.

Xchange hat die Antwort bekommen und an der Stelle nachgesehen, an der laut Anbindung die Datensätze stehen – und dort keine Liste gefunden. Das Fremdsystem führt seine Datensätze woanders, als die Anbindung angibt. Xchange sucht dann nicht weiter, sondern beendet den Lauf, bevor ein Vorgang entsteht.

Es gibt eine leisere Form desselben Fehlers: Der Lauf ist grün, bringt aber nur einen Teil des Bestands. Dann liest Xchange nur die erste Seite der Antwort – dazu Schritt 4.

Beides stellen Sie auf der Anbindung richtig, ebenso einen zweiten Fall derselben Sorte: Werte, die ankommen, aber anders gelesen werden, als das System sie meint.

Was Sie brauchen​

  • Die Berechtigung Anbindungen in der Stufe Voll – siehe Berechtigungen.
  • Eine echte Antwort des Fremdsystems, als JSON. Ein Aufruf im Browser, eine Zeile aus dem Protokoll des Partners, ein Beispiel aus seiner Dokumentation – alles recht, solange es eine Antwort auf denselben Abruf ist.
  • Einstieg: Anbindungen, die betroffene Anbindung, Abschnitt Sammelabruf.

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

1. Prüfen, ob es überhaupt dieser Abschnitt ist​

Der Abschnitt wirkt nur dort, wo Xchange einen Datenbestand stückweise beim Fremdsystem abholt. Diese Seite hilft, wenn beide Bedingungen zutreffen:

Woran Sie es sehen
Die Anbindung muss ihn zeigenDer Abschnitt Sammelabruf steht auf der Anbindung. Systeme, die den Aufbau ihrer Antworten selbst beschreiben, bekommen ihn gar nicht erst.
Die Route muss abrufenNur bei Datenherkunft Datenbestand. Bei Warteschlange und Verteilungseingang bekommt Xchange die Nachricht zugestellt, statt sie abzuholen, und die Angaben des Abschnitts bleiben unbeachtet.

Kommt Ihre Route aus der Warteschlange oder aus der Verteilung und bleibt die Feldauswahl trotzdem leer, ist das ein anderer Fall: Wenn die Feldauswahl leer bleibt.

2. Warum der Lauf abbricht, statt leer durchzulaufen​

Die Pfadfelder des Abschnitts stehen bei einer neuen Anbindung leer, und leer heißt hier: nicht angegeben. Xchange setzt dafür keinen Wert ein und sucht an keiner anderen Stelle. Ruft eine Route über die Anbindung ab, meldet die Prüfung des Entwurfs deshalb schon vor dem ersten Lauf „‚Datensätze‘ fehlt – eine abrufende Route liest diese Anbindung“.

Steht unter Datensätze ein Pfad, an dem die Antwort keine Liste führt, bricht der Lauf ab – bei „Webshop Cambira“ etwa customers, geraten nach dem Abrufendpunkt customers der Route „Kunden Webshop“, während der Shop seine Kunden unter data führt. Als leere Seite gilt nur eine leere Liste oder null an genau dieser Stelle – so antwortet ein abgeräumter Datenbestand. Ein Pfad, der ins Leere zeigt, ist dagegen keine leere Seite, sondern eine Anbindung, die zur Antwort nicht passt. Deshalb bleibt ein falscher Pfad nicht unbemerkt: Der Grund steht beim letzten Lauf der Route, siehe Ausführung – Letzter Lauf.

3. Die Antwort vorlegen, statt den Pfad zu raten​

Über den Feldern sitzt Beispielantwort einfügen. Fügen Sie dort eine echte Antwort des Systems ein: Xchange liest sie durch und füllt daraus die Vorschlagslisten der Pfadfelder. Sie wählen danach aus, was das System wirklich schickt, statt einen Pfad zu erraten.

„Webshop Cambira“ antwortet auf den Abruf der Kunden seitenweise, 100 Kunden je Seite:

{
"data": [
{ "customer_no": "K-10317", "company": "Hollmann Bau GmbH", "…": "…" }
],
"meta": { "next_cursor": "Sy0xMDMxNw", "has_more": true }
}
  1. Klicken Sie auf Beispielantwort einfügen. Es öffnet sich der Dialog Beispielantwort.
  2. Fügen Sie die Antwort als JSON ein und klicken Sie auf Fertig. Bei ungültigem JSON sagt der Dialog das und bleibt offen.
  3. Klappen Sie Datensätze auf und wählen Sie den Pfad, unter dem in der Antwort die Liste steht – beim Shop data.
  4. Schickt das System einen Token für die nächste Seite mit, stellen Sie Weiterblättern auf Token für die nächste Seite, wählen ebenso dessen Pfad unter Token-Pfad und tragen unter Token-Parameter den Namen ein, unter dem das System den Token beim nächsten Abruf erwartet – beim Shop meta.next_cursor und cursor.

Eine echte Antwort des Fremdsystems als JSON im Dialog Beispielantwort.

Die Beispielantwort gilt nur, solange der Bildschirm offen ist. So lange füllt sie die Vorschlagslisten – gespeichert werden allein die Pfade, die Sie auswählen. Sie können die Pfade auch direkt eintippen; die Beispielantwort erspart Ihnen lediglich das Raten.

4. Weiterblättern, und die eine Entscheidung, die Folgen hat​

Steht Weiterblättern auf Keines, liest Xchange je Lauf nur die erste Seite. Der Lauf ist dann grün und bringt trotzdem nur einen Teil des Bestands – bei „Kunden Webshop“ die ersten 100 der 412 Fachhandelskunden. Blättert das System über einen Token, gehören Token-Pfad und Token-Parameter zusammen: Am Token erkennt Xchange, wo es weitermacht, und unter dem Parameter schickt es ihn beim nächsten Abruf mit.

Das Feld Weitere Seiten ist eine Entscheidung:

  • Sie lassen es leer. Dann ist der Token das einzige Signal, an dem Xchange das Ende erkennt: Solange die Antwort einen mitschickt, holt Xchange weiter; kommt keiner mehr, ist der Abruf zu Ende. Für Systeme ohne einen solchen Hinweis ist das die richtige Angabe.
  • Sie tragen einen Pfad ein. Dann entscheidet dieser Hinweis. Meldet er „es kommt noch etwas“, muss ein Token dabeistehen, denn daran erkennt Xchange, wo es weitermacht. Fehlt er, bricht der Lauf ab, ebenfalls mit dem Grund Anbindung passt nicht zur Antwort. Eine Wiederholung gibt es dabei nicht, weil ein zweiter Versuch dieselbe Antwort bekäme.

Tragen Sie das Feld deshalb nur ein, wenn das System den Hinweis wirklich schickt. Ein Pfad auf eine Stelle, die das System nie füllt, verdeckt den Token als Endesignal und ersetzt ihn durch eines, das nie anschlägt. „Webshop Cambira“ schickt den Hinweis mit, unter meta.has_more – dort gehört der Pfad hinein.

Was in den Feldern jeweils genau steht, und wie Xchange bei Seitennummer und Versatz blättert, führt Anbindungen – Sammelabruf auf.

Der zweite Fall: die Werte kommen an, stimmen aber nicht​

Weiter unten auf derselben Anbindung steht Schreibweise der Daten – zwei Auswahlfelder für Datums- und Zahlenangaben. Dieser Abschnitt steht bei jeder Anbindung, auch bei denen ohne Sammelabruf: Werte schreibt jedes System in irgendeiner Form.

Und er wirkt an einer einzigen Stelle: dort, wo Xchange einen Wert mit einem anderen vergleicht. Ein Wert, den eine Zuordnung nur überträgt, geht in beiden Richtungen so durch, wie er ankommt. Angesehen wird ein Wert nur

  • im Datenfilter der Route, der entscheidet, welche Datensätze überhaupt mitkommen, und
  • in einer Bedingung der Zuordnung, die entscheidet, ob eine Zeile greift.

Die praktische Folge: Steht die Schreibweise falsch, überträgt die Route weiter richtig – aber sie überträgt die falschen Datensätze. Ein Filter „Betrag größer 1.000“ trifft dann die falschen Zeilen, und der Lauf ist grün dabei. Suchen Sie den Fehler also in der Auswahl.

Die beiden Felder beschreiben allein, wie das Fremdsystem schreibt. Den Vergleichswert, den Sie im Filter selbst eintragen, liest Xchange immer nach der Voreinstellung – Tag zuerst, Dezimalpunkt –, gleich an welcher Anbindung die Route hängt.

Wann ein Wert überhaupt mehrdeutig ist und welche Werte sich selbst erklären, steht unter Anbindungen.

Wie es weitergeht​

Beides – die Pfade und die Schreibweise – gehört zur Anbindung. Eine Korrektur hier wirkt auf alle Routen, die diese Anbindung verwenden, und sie wirkt im Betrieb erst mit dem aktivierten Konfigurationsstand: Prüfen und aktivieren.

Siehe auch​