Zum Hauptinhalt springen

Routen – Verteilung

Auf dem Reiter Verteilung legen Sie fest, welche eingehende Nachricht an welche Route weitergegeben wird. Der Reiter erscheint nur auf einer Route vom Typ Verteilung.

Die Zuordnung ist eine geordnete Liste von Regeln. Xchange prüft sie von oben nach unten und hört bei der ersten auf, die zutrifft. Was das für den Betrieb bedeutet, steht unter Verteilung.

Im Beispiel: „Statusmeldungen Kessler“ verteilt die Nachrichten des Logistikers auf vier Routen – Abholung, Transport, Zustellung, Fehlzustellung.

Berechtigungen​

Berechtigung auf RoutenWas möglich ist
Nur lesendie Regelliste und das Sonst-Verhalten ansehen, den Testbereich benutzen
Vollzusätzlich Regeln anlegen, ändern, duplizieren, umsortieren und entfernen

Die Regeldetails öffnen sich erst mit Voll. Mit Nur lesen sind das Zahnrad, das dorthin führt, sowie Regel hinzufügen, Regel duplizieren und das Entfernen-Symbol ausgeblendet. Was von einer Regel sichtbar bleibt, ist die Zusammenfassung in ihrer Zeile – Bedingung und Ziele als Text. Das unterscheidet diesen Reiter von Routen – Zuordnung, wo sich die Einstellungen auch lesend öffnen lassen.

Der Testbereich steht dagegen beiden offen. Ein Test ist reines Auswerten – ohne Weitergabe der Nachricht und ohne Lauf.

Aufbau​

Der Reiter teilt sich in zwei Hälften, deren Trennlinie Sie verschieben können:

  • links die Regelliste mit dem Sonst-Verhalten darunter,
  • rechts der Testbereich.

Anders als auf dem Reiter Zuordnung bleibt der Testbereich immer eingeblendet. Einklappen lassen sich seine beiden Teile, Testnachricht und Ergebnis, jeweils über ihre Kopfzeile.

Die beiden Hälften hängen zusammen: Die Testnachricht rechts liefert den Feldbaum, aus dem Sie in den Regeldetails ein Feld auswählen, und der Test markiert links in jeder Zeile, ob die Regel zutrifft.

Der Reiter Verteilung nach einem Test: Regel 2 trägt den grünen Haken, die übrigen drei einen grauen Strich, rechts das Ergebnis „Regel 2 greift – Ziele: Transport Kessler“.

Die Regelliste​

Über der Liste steht der Titel Regeln; rechts daneben liegt Regel hinzufügen. Eine neue Regel kommt ans Ende der Liste, ohne Bedingung und ohne Ziel – sie ist damit eine Auffangregel, bis Sie ihr eine Bedingung geben.

Jede Zeile trägt sieben Spalten:

SpalteWas darin steht
(ohne Überschrift)der Ziehgriff. Damit schieben Sie die Regel an eine andere Stelle – und ändern damit, welche zuerst geprüft wird.
Bedingungdie Bedingung als lesbarer Satz, z. B. status ist gleich „picked“. Mehrere Bedingungen stehen mit UND oder ODER dazwischen, mehrere Gruppen trennt ein senkrechter Strich `
Zieledie Zielrouten, jede als Sprunglink. Ein Klick führt auf die Route selbst; der Hinweistext lautet Zielroute öffnen. Hat die Regel kein Ziel, steht dort ein Strich.
Testdas Ergebnis des letzten Tests, als Zeichen – siehe Der Testbereich. Ohne Test bleibt die Spalte leer.
(ohne Überschrift)das Zahnrad: öffnet die Regeldetails.
(ohne Überschrift)Regel duplizieren: legt eine Kopie direkt unter der Regel an und öffnet sofort deren Regeldetails. Bei einer Regel ohne Bedingung fehlt die Schaltfläche, ebenso bei einer Regel, deren gespeicherte Bedingung oder Ziele sich nicht lesen lassen.
(ohne Überschrift)das Entfernen-Symbol. Eine Regel ohne Bedingung und ohne Ziel verschwindet sofort. Jede andere fragt vorher nach: Regel entfernen, mit dem Hinweis „Die Regel wird entfernt. Diese Aktion kann nicht rückgängig gemacht werden.“ und der Schaltfläche Löschen.

Eine gelöschte Zielroute bleibt als Text stehen statt als Link – mit ihrem technischen Schlüssel. Die Regel zeigt dann ins Leere.

Regeldetails​

Das Zahnrad öffnet ein Fenster Regeldetails mit zwei Abschnitten: der Bedingung und den Zielrouten. Jede Änderung darin speichert Xchange sofort; Fertig schließt das Fenster nur.

Bedingung​

Die Bedingungen stehen in Gruppen – Gruppe 1, Gruppe 2 und so weiter, höchstens 3 je Regel, jede mit bis zu 5 Bedingungen, ohne Klammern und Verschachtelung. Im Kopf jeder Gruppe stehen der Umschalter UND / ODER, Bedingung hinzufügen und Gruppe entfernen. Der Umschalter gilt für die Bedingungen dieser einen Gruppe. Zwischen den Gruppen steht fest ODER: die Regel trifft zu, sobald eine ihrer Gruppen zutrifft. Weitere Gruppen legt Gruppe hinzufügen unter der letzten an. Nach der fünften Bedingung einer Gruppe meldet Bedingung hinzufügen nur noch Höchstens 5 Bedingungen je Gruppe, nach der dritten Gruppe meldet Gruppe hinzufügen Höchstens 3 Gruppen.

Gruppe entfernen nimmt eine leere Gruppe sofort heraus. Steht in der Gruppe schon etwas, fragt es vorher nach: Gruppe entfernen, mit dem Hinweis „Die Gruppe und alle ihre Bedingungen werden entfernt. Diese Aktion kann nicht rückgängig gemacht werden.“ und der Schaltfläche Entfernen.

Jede Bedingung ist eine Zeile mit drei Spalten:

SpalteWas Sie eintragen
Feldder Pfad in die Nachricht, in Kurzform: status, lines[0].sku. Über das Symbol daneben wählen Sie ihn aus einem Baum statt ihn zu tippen. Das Eingabefeld schlägt z. B. type vor.
Operatoreiner von vier – siehe unten.
Wertder Vergleichswert, frei einzutragen. Bei ist leer und ist nicht leer verschwindet die Spalte, weil dort nur das Feld selbst geprüft wird.

Rechts daneben liegt eine schmale Spalte mit Bedingung entfernen. Hat eine Gruppe keine einzige Bedingung, steht in ihr statt der Tabelle: Keine Bedingungen – Regel greift auf alle Nachrichten zu.

Der Feldbaum kommt aus der Testnachricht. Er zeigt die Felder der Nachricht, die rechts im Testbereich steht. Ist der Editor dort leer, meldet der Auswahlbaum Testnachricht angeben., und der Pfad lässt sich nur von Hand eintragen.

Die vier Operatoren​

OperatorTrifft zu, wenn
ist gleichdas Feld genau diesen Wert trägt
ist ungleichdas Feld einen anderen Wert trägt
ist leerdas Feld fehlt oder keinen Wert hat
ist nicht leerdas Feld einen Wert hat

Das ist deutlich weniger, als der Datenfilter auf dem Reiter Quelldaten anbietet:

  • Dort gibt es außerdem enthält, beginnt mit, ist eines von und Größenvergleiche.
  • Dort lassen sich bis zu 6 Gruppen bilden und wahlweise mit UND oder ODER verknüpfen. Eine Verteilungsregel hat höchstens 3, immer mit ODER verknüpft.
  • Dort lässt sich ein Datumsvergleich an den Lauf binden. Eine Verteilungsregel wird dagegen geprüft, bevor ein Lauf überhaupt begonnen hat.

Zielrouten​

Ein Pflichtfeld. Sie wählen eine oder mehrere Routen aus; ausgewählte stehen als Merker im Feld. Trifft eine Regel mit zwei Zielen zu, geht dieselbe Nachricht an beide – und jedes Ziel bekommt einen eigenen Lauf.

Zur Wahl stehen nur Routen, die als Ziel taugen. Vier Angaben müssen dafür stimmen: Richtung Import, Typ Verarbeitung, Datenherkunft Verteilungseingang – und dieselbe Anbindung wie die dieser Route. Andere Verteilungsrouten scheiden damit aus. Eine Route, die eine der vier Angaben nicht erfüllt, erscheint nicht in der Auswahl; das Feld nennt dafür keinen Grund. Welche Anbindung, Richtung und Datenherkunft eine Route hat, steht auf ihrem Reiter Allgemein.

Darunter liegt Neue Zielroute. Damit legen Sie eine Route an, ohne den Reiter zu verlassen. Passt die neu angelegte Route nicht zu dieser Regel, erscheint der Hinweis Route angelegt, aber nicht ausgewählt – für diese Regel keine gültige Zielroute: die Route steht dann nur in der Routenliste.

Das Fenster Regeldetails von Regel 4: eine Gruppe mit zwei Bedingungen auf status, verknüpft mit ODER, und die Zielroute Fehlzustellung Kessler.

Wenn keine Regel greift​

Unter der Regelliste steht Sonst – wenn keine Regel zutrifft mit einer Auswahl von zwei Stellungen:

StellungWas mit der Nachricht geschieht
ÜberspringenDie Nachricht gilt ohne weitere Verarbeitung als erledigt.
Manuelle PrüfungDie Nachricht geht in die Manuelle Klärung, Ursache Keine Verteilungsregel.

Im Beispiel steht die Verteilung auf Manuelle Prüfung. Deshalb liegt die Nachricht zur Sendung KS-778102 mit dem unbekannten Status customs_hold in der Klärung statt verloren zu gehen.

Die Auffangregel​

Eine Regel ohne Bedingung trifft auf jede Nachricht zu, die bei ihr ankommt – sie ist eine Auffangregel und zeigt in der Liste (trifft auf alle zu). Jede Regel, die Regel hinzufügen anlegt, ist das, bis sie eine Bedingung bekommt. Eine Auffangregel wirkt auf den ganzen Reiter:

  • Regeln unter ihr kommen nie zum Zug, denn jede Nachricht, die bis zu ihr gelangt, fängt sie.
  • Das Sonst-Verhalten kommt nie zum Zug. Die Auswahl ist grau, daneben steht Nicht erreichbar – eine Auffangregel trifft auf alle Nachrichten zu. Die Stellung bleibt gespeichert.
  • Sie lässt sich nicht duplizieren – Regel duplizieren fehlt in ihrer Zeile.
  • Eine zweite Auffangregel meldet die Prüfung als Mehr als eine Auffangregel in dieser Route (siehe unten).

Was die Prüfung meldet​

Ein leeres Pflichtfeld zeigt sich schon beim Bearbeiten. Fehlt in den Regeldetails ein Feld, ein Wert oder eine Zielroute, steht das Feld rot; an Zielrouten mit dem Hinweis Pflichtfeld.

Alles Weitere meldet Prüfen auf den Konfigurationsständen, denn es hängt an anderen Routen oder an der Regelliste als Ganzes. Danach stehen sie auch in den Meldungen der Route, unter Verteilung:

MeldungWas sie bedeutet
Zielroute ist in diesem Konfigurationsstand nicht vorhandenDie Zielroute wurde gelöscht. In der Regelliste steht sie dann als Text statt als Link.
Zielroute hat nicht die Datenherkunft „Verteilungseingang“Die Zielroute hat die Datenherkunft Datenbestand oder Warteschlange. Wählen Sie eine Route, die aus dem Verteilungseingang beliefert wird.
Zielroute liegt auf einer anderen Anbindung als die VerteilungsrouteDie Anbindung einer der beiden Routen wurde nachträglich geändert.
Mehr als eine Auffangregel in dieser RouteZwei Regeln haben keine Bedingung. Nur die obere kommt je zum Zug.
Zirkuläre VerteilungsabhängigkeitEine Zielroute führt direkt oder über weitere Verteilungsrouten auf diese Route zurück.

Regeln sind namenlos, deshalb nennt die Meldung ihre Stelle, von oben gezählt:

Am Anfang der MeldungGemeint ist
Regel 1, Regel 2, …eine Regel an dieser Stelle
Regeln 1 und 3zwei Regeln, die die Meldung gemeinsam betrifft
Regel (Position unbekannt), Regeln (Position unbekannt)Regeln, deren Stelle sich nicht mehr bestimmen lässt
Entfernte Regel, Entfernte RegelnRegeln, die Sie seit der Prüfung entfernt haben

Ein Klick auf eine Meldung mit Stelle öffnet die Regeldetails dieser Regel. Die Zirkelmeldung betrifft die Route als Ganzes; ihr Klick öffnet den Reiter als Ganzes.

Der Testbereich​

Der Testbereich zeigt, welche Regel bei dieser Nachricht greift.

Testnachricht. Ein Editor mit Zeilennummern für eine Beispielnachricht im JSON-Format. Zwei Symbole im Kopf: Auf Referenz zurücksetzen holt die an der Route hinterlegten Referenzdaten zurück und erscheint nur, wenn es welche gibt; Testnachricht leeren räumt den Editor. Was Sie hier eintragen, speist zugleich den Feldbaum in den Regeldetails.

Beim ersten Öffnen steht die Referenznachricht schon im Editor, sofern die Route eine hat. Sie dürfen sie überschreiben; die Referenz bleibt dabei erhalten. Was Sie einmal eingetragen haben, bleibt stehen, auch wenn sich die Referenz später ändert.

Testen. Die Schaltfläche wertet die Regeln gegen diese Nachricht aus. Ist der Text kein gültiges JSON, erscheint statt eines Ergebnisses Testnachricht ist kein gültiges JSON.

Ergebnis. Der Bereich erscheint erst nach dem ersten Test. Er trägt eine Zeile, die den Ausgang benennt:

AusgangWas dort stehtFarbe
Eine Regel greiftRegel 2 greift – Ziele: Transport Kesslergrün
Keine greiftKeine Übereinstimmung – Verhalten: Manuelle Prüfungorange
Eine Bedingung ist nicht lesbarKein Ergebnis – die Bedingung von Regel 3 ist nicht lesbarorange

Trägt eine Regel eine unlesbare Bedingung, steht immer der dritte Ausgang da – auch wenn eine Regel weiter oben greift. Welche das ist, zeigt dann der grüne Haken in der Spalte Test.

Zugleich füllt sich in der Regelliste die Spalte Test mit einem von vier Zeichen:

ZeichenBedeutung
grüner HakenDiese Regel greift – sie ist die erste zutreffende.
grauer HakenDiese Regel trifft ebenfalls zu, aber eine weiter oben gewinnt.
grauer StrichDiese Regel trifft nicht zu.
orangefarbenes WarnzeichenDie Bedingung dieser Regel ist nicht lesbar.

Der graue Haken zeigt eine Überschneidung, die sonst in der Liste verborgen bleibt: zwei Regeln, die dieselbe Nachricht fangen würden, und die Reihenfolge entscheidet.

Zeichen und Ergebnis gehören zum letzten Test. Verschieben Sie eine Regel oder ändern Sie ihre Bedingung, wandern die Zeichen mit der Regel mit und bleiben, wie sie waren; neu ausgewertet wird erst mit dem nächsten Testen. Ändern Sie dagegen die Testnachricht, setzen Sie sie auf die Referenz zurück oder leeren Sie sie, verschwinden das Ergebnis und die Zeichen der Spalte Test.

Ein Test wirkt nur im Testbereich. Läufe, Zielrouten und das Zielsystem bleiben, wie sie sind. Vor dem Auswerten sichert er Ihre offenen Änderungen an den Regeln, damit er das prüft, was am Bildschirm steht.

Siehe auch​