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 Routen | Was möglich ist |
|---|---|
| Nur lesen | die Regelliste und das Sonst-Verhalten ansehen, den Testbereich benutzen |
| Voll | zusä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.

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:
| Spalte | Was darin steht |
|---|---|
| (ohne Überschrift) | der Ziehgriff. Damit schieben Sie die Regel an eine andere Stelle – und ändern damit, welche zuerst geprüft wird. |
| Bedingung | die Bedingung als lesbarer Satz, z. B. status ist gleich „picked“. Mehrere Bedingungen stehen mit UND oder ODER dazwischen, mehrere Gruppen trennt ein senkrechter Strich ` |
| Ziele | die 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. |
| Test | das 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:
| Spalte | Was Sie eintragen |
|---|---|
| Feld | der 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. |
| Operator | einer von vier – siehe unten. |
| Wert | der 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
| Operator | Trifft zu, wenn |
|---|---|
| ist gleich | das Feld genau diesen Wert trägt |
| ist ungleich | das Feld einen anderen Wert trägt |
| ist leer | das Feld fehlt oder keinen Wert hat |
| ist nicht leer | das 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.

Wenn keine Regel greift
Unter der Regelliste steht Sonst – wenn keine Regel zutrifft mit einer Auswahl von zwei Stellungen:
| Stellung | Was mit der Nachricht geschieht |
|---|---|
| Überspringen | Die Nachricht gilt ohne weitere Verarbeitung als erledigt. |
| Manuelle Prüfung | Die 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:
| Meldung | Was sie bedeutet |
|---|---|
| Zielroute ist in diesem Konfigurationsstand nicht vorhanden | Die 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 Verteilungsroute | Die Anbindung einer der beiden Routen wurde nachträglich geändert. |
| Mehr als eine Auffangregel in dieser Route | Zwei Regeln haben keine Bedingung. Nur die obere kommt je zum Zug. |
| Zirkuläre Verteilungsabhängigkeit | Eine 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 Meldung | Gemeint ist |
|---|---|
| Regel 1, Regel 2, … | eine Regel an dieser Stelle |
| Regeln 1 und 3 | zwei Regeln, die die Meldung gemeinsam betrifft |
| Regel (Position unbekannt), Regeln (Position unbekannt) | Regeln, deren Stelle sich nicht mehr bestimmen lässt |
| Entfernte Regel, Entfernte Regeln | Regeln, 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:
| Ausgang | Was dort steht | Farbe |
|---|---|---|
| Eine Regel greift | Regel 2 greift – Ziele: Transport Kessler | grün |
| Keine greift | Keine Übereinstimmung – Verhalten: Manuelle Prüfung | orange |
| Eine Bedingung ist nicht lesbar | Kein Ergebnis – die Bedingung von Regel 3 ist nicht lesbar | orange |
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:
| Zeichen | Bedeutung |
|---|---|
| grüner Haken | Diese Regel greift – sie ist die erste zutreffende. |
| grauer Haken | Diese Regel trifft ebenfalls zu, aber eine weiter oben gewinnt. |
| grauer Strich | Diese Regel trifft nicht zu. |
| orangefarbenes Warnzeichen | Die 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
- Eingehende Nachrichten an die zuständige Route geben (Anleitung) – der Weg von der leeren Route bis zur ersten verteilten Nachricht
- Routen (Referenz) – die übrigen Reiter einer Route
- Manuelle Klärung (Referenz) – wo eine Nachricht ohne Treffer landet
- Verteilung (Grundkonzept) – warum die Reihenfolge der Regeln die Aussage trägt