Routen – Verhalten
Der Reiter Verhalten legt fest, was eine Route in zwei Lagen tut, die sich aus dem einzelnen Datensatz nicht ergeben: wenn ein Feld auf beiden Seiten geändert wurde, und wenn ein Datensatz in der Quelle nicht mehr gilt. Es gibt ihn nur an Routen vom Typ Verarbeitung; eine Verteilungsroute überträgt selbst nichts und hat deshalb weder Konflikte noch ein Löschverhalten.
Berechtigungen
Der Reiter gehört zur Route und folgt deshalb der Berechtigung Routen:
| Stufe auf Routen | Was Sie auf dem Reiter können |
|---|---|
| Keine | der Menüpunkt Routen fehlt, und mit ihm dieser Reiter |
| Nur lesen | Konfliktregeln, Löschverhalten und Löschkennzeichen ansehen; die Felder lassen sich nicht ändern, Bedingung hinzufügen und Bedingung entfernen fehlen |
| Voll | alles ändern, Bedingungen hinzufügen und entfernen |

Aufbau
| Bereich | Inhalt |
|---|---|
| Konflikte | welche Seite gewinnt, wenn ein Feld in der Quelle und im Zielsystem geändert wurde: ein Standard für die Route und darunter eine Regel je Feld. |
| Löschverhalten | das Feld Strategie: was die Route mit einem Datensatz tut, der in der Quelle nicht mehr gilt. |
| Löschkennzeichen | die Bedingung, an der die Route einen in der Quelle gelöschten Datensatz erkennt. Leer, solange die Quelle Löschungen nicht kennzeichnet. |
Im Beispiel: Bei „Artikel Cambira Austria“ gilt für alle drei Felder der Wert aus SAP Business One. Die Route steht auf Im Zielsystem deaktivieren, und ihr Löschkennzeichen ist leer – SAP Business One kennzeichnet einen gelöschten Artikel nicht, er fehlt einfach.
Konflikte
Ein Feld kann sich auf beiden Seiten ändern: in der Quelle, die es liefert, und im Zielsystem, wo jemand es von Hand nachträgt. Ohne Regel schreibt die Route den Wert der Quelle und überschreibt damit, was im Zielsystem geändert wurde. Der Abschnitt legt fest, ob das so bleibt. Unter seinem Titel steht, was er regelt, mit den Namen beider Systeme – an „Bestellungen Webshop“: „Legt fest, welcher Wert gilt, wenn ein Feld seit dem letzten Abgleich sowohl in „Webshop Cambira“ als auch in SAP Business One geändert wurde.“
Ein Konflikt liegt vor, wenn Quelle und Zielsystem in einem Feld Verschiedenes enthalten und sich nicht nur eine Seite seit dem letzten Abgleich geändert hat. Wie Xchange das feststellt – auch für einen Datensatz, der noch keinen letzten Abgleich hat –, steht unter Woran Xchange einen Konflikt erkennt.

Fehlt der Abschnitt, konnte Xchange beim Öffnen der Route nicht lesen, welche Felder in Konflikt geraten können. Die eingestellten Regeln bleiben erhalten und gelten weiter; beim nächsten Öffnen der Route fragt Xchange erneut.
Die Regeln
| Regel | Wirkung |
|---|---|
| Wert aus … übernehmen | Die Quelle gewinnt immer. Xchange vergleicht nichts und liest dafür nichts aus dem Zielsystem – die Route verhält sich wie eine ohne Regel. |
| Wert in … behalten | Bei einem Konflikt bleibt der Wert im Zielsystem stehen. Die übrigen Felder des Datensatzes werden geschrieben. |
| Zur Klärung vorlegen | Bei einem Konflikt schreibt Xchange das Feld nicht und legt es in der Manuellen Klärung vor. Die übrigen Felder werden geschrieben, und der Vorgang endet mit Manuelle Prüfung. |
Statt der Auslassungspunkte stehen in der Auswahl die Namen der beiden Systeme, an „Bestellungen Webshop“ also Wert aus „Webshop Cambira“ übernehmen und Wert in SAP Business One behalten.
Standard für diese Route gilt für jedes Feld, das keine eigene Regel hat. Voreingestellt ist Wert aus … übernehmen.
Abweichungen je Feld listet die Felder, die in Konflikt geraten können:
| Spalte | Inhalt |
|---|---|
| Zielfeld | das Feld im Zielsystem |
| Regel | Standard (…) – in Klammern die Regel, die der Standard gerade vorgibt – oder eine der drei Regeln für genau dieses Feld. An einer Liste, die das Zielsystem als Ganzes ersetzt, und an ihren Feldern steht nur Wert aus … übernehmen zur Wahl. |
| Gegenrichtung | die Route, die dasselbe Feld in die Gegenrichtung überträgt, mit der Regel, die dort gilt. Beschreibt sie dasselbe Objekt über dasselbe Feld, steht dort „Route: Regel“ als Link auf ihren Reiter Verhalten; erreicht sie das Feld über andere Felder, steht dort der Name der Route und „über“ mit diesen Feldern. „–“ heißt, dass keine Route das Feld zurückschreibt. |
Stellen Sie die Gegenrichtung so ein, dass die beiden Routen dasselbe wollen: Behalten beide den Wert im Zielsystem, wird eine Änderung an diesem Feld in keine Richtung mehr übertragen – darauf weist eine Meldung an beiden Routen hin.
Im Beispiel: Angenommen, A. Vogt hat an „Bestellungen Webshop“ für PaymentMethod Zur Klärung
vorlegen gesetzt; der Standard bleibt Wert aus „Webshop Cambira“ übernehmen. Die Zahlungsart ist
das eine Feld, das der Innendienst in SAP Business One nachträglich ändert – nach einem Anruf, mit
Rechnung statt PayPal –, und eine spätere Lieferung des Shops soll das nicht still überschreiben.
Keine Route schreibt Bestellungen in den Shop zurück, deshalb steht unter Gegenrichtung überall
„–“.
Welche Felder aufgeführt sind
Aufgeführt sind die Felder des Hauptschritts, einzelne Felder wie Listen; wie eine Liste aufgeführt ist, steht unter Listen. Die Felder weiterer Schritte nehmen nicht teil; sie folgen stets der Quelle. Kann kein Feld in Konflikt geraten, steht dort „Kein Feld dieser Route kann in Konflikt geraten.“
Schreibt die Route in SAP Business One, auch in eine andere Firma, sind alle diese Felder aufgeführt: Xchange liest den jetzigen Wert dort bei jedem Vorgang.
Schreibt die Route in ein Fremdsystem, kennt Xchange dessen jetzigen Wert nur aus den Routen, die über dieselbe Anbindung aus dem Fremdsystem lesen. Aufgeführt sind deshalb nur die Felder, die eine solche Route zurückliest. Die übrigen nennt ein Satz über der Tabelle, mit dem Grund; für sie gilt immer der Wert der Quelle. Statt der Auslassungspunkte stehen dort das Fremdsystem, die Felder und die Quelle:
| Satz | Was Sie tun können |
|---|---|
| „Nicht aufgeführt, weil keine Route Daten aus … liest: …. Für diese Felder gilt immer der Wert aus ….“ | eine Route anlegen, die das Objekt aus dem Fremdsystem liest |
| „Nicht aufgeführt, weil keine Route sie aus … liest: …. Für diese Felder gilt immer der Wert aus ….“ | die Felder in die Zuordnung einer Route aufnehmen, die aus dem Fremdsystem liest |
Die Zeile „Gegenseite zuletzt gelesen:“ nennt den Zeitpunkt, zu dem eine dieser Routen zuletzt gelesen hat – so aktuell ist der Wert, gegen den Xchange vergleicht. Ist keine dieser Routen aktiv, bleibt er auf diesem Stand: Was sich seitdem im Fremdsystem geändert hat, erkennt Xchange nicht als Konflikt.
Listen
Wie eine Liste aufgeführt ist, hängt daran, ob Xchange ihre Zeilen auseinanderhalten kann:
| Liste | Aufgeführt als |
|---|---|
| mit Suchen über auf Markierte Felder, in SAP Business One auch mit Verknüpfen über | eine Zeile für die Liste, darunter eingerückt ihre Felder. Die mit dem Schlüsselsymbol markierten Felder fehlen: Sie sagen, welche Zeile gemeint ist, und können deshalb nicht in Konflikt geraten. |
| in SAP Business One, ohne beides | nicht aufgeführt; über der Tabelle steht „Nicht aufgeführt, weil diese Liste in … nur angehängt wird: …. Vorhandene Zeilen bleiben unverändert.“ Die Liste schreibt nur neue Zeilen, ein Konflikt kann darin nicht entstehen. |
| in ein Fremdsystem, ohne markierte Felder | eine Zeile für die Liste mit dem Zusatz „Als Ganzes verglichen“ |
| deren Einträge einzelne Werte sind – Aus Textwert oder eine Quell-Liste aus einfachen Werten | eine Zeile für die Liste mit dem Zusatz „Als Ganzes verglichen“. Auf die Reihenfolge der Werte kommt es dabei nicht an. |
Die Regel der Liste gilt für jede Zeile als Ganzes: ob eine Zeile, die im Zielsystem gelöscht und in der Quelle geändert wurde, wieder angelegt wird. Die Regel eines Felds der Liste gilt für dieses Feld in jeder Zeile; Wie die Liste (…) heißt, dass es der Regel der Liste folgt.
| Zeile in der Quelle | Zeile im Zielsystem | Was geschieht |
|---|---|---|
| neu | neu, mit demselben Schlüssel | Xchange vergleicht die Felder wie bei einem Datensatz ohne letzten Abgleich. |
| seit dem letzten Abgleich geändert | gelöscht | ein Konflikt – die Regel der Liste entscheidet |
| unverändert | gelöscht | Die Zeile bleibt gelöscht. |
| gelöscht | beliebig | kein Konflikt |
Als gelöscht gilt eine Zeile erst, wenn Xchange die ganze Liste gelesen hat und sie darin fehlt.
Ein Fremdsystem ersetzt die Liste als Ganzes: Xchange schickt sie vollständig, sobald sich darin etwas geändert hat. Für eine solche Liste und ihre Felder ist deshalb nur Wert aus … übernehmen möglich. Eine Zeile, die im Zielsystem steht und in der gesendeten Liste fehlt, entfernt das Zielsystem dabei. Xchange meldet sie im Verlauf als Entfernt. Ist eine Zeile in der Quelle gelöscht, die Xchange zuvor übertragen hat, sendet Xchange die Liste auch dann, wenn sich sonst nichts geändert hat. Eine Zeile, die nur im Zielsystem angelegt wurde, ist dafür kein Grund.
Im Beispiel: Bei „Bestellungen Webshop“ steht in der Tabelle die Zeile DocumentLines und
eingerückt darunter Quantity; ItemCode ist markiert und fehlt deshalb. Beide stehen auf dem
Standard, Quantity also auf Wie die Liste (Wert aus „Webshop Cambira“ übernehmen).
Woran Xchange einen Konflikt erkennt
Für jedes Feld mit der Regel Wert in … behalten oder Zur Klärung vorlegen merkt sich Xchange je Datensatz, welcher Wert auf beiden Seiten stand, als das Feld zuletzt abgeglichen wurde – den letzten Abgleich. Bei jedem Vorgang vergleicht es den neuen Wert der Quelle und den jetzigen im Zielsystem mit diesem Abgleich:
| Lage | Was geschieht |
|---|---|
| Beide Seiten enthalten dasselbe | nichts zu entscheiden |
| Nur die Quelle hat sich geändert | Der Wert der Quelle wird geschrieben. |
| Nur das Zielsystem hat sich geändert | Der Wert im Zielsystem bleibt stehen. |
| Beide haben sich geändert und enthalten Verschiedenes | ein Konflikt – die Regel entscheidet |
| Der Wert im Zielsystem ist nicht bekannt – der Datensatz fehlt dort, das Feld wird nicht geliefert, oder das Fremdsystem wurde noch nie gelesen | Der Wert der Quelle wird geschrieben. |
Wie eine Regel bei einem Vorgang entschieden hat, zeigt der Verlauf unter Konflikte.
Ohne letzten Abgleich entscheiden die beiden Werte selbst. Das gilt für einen Datensatz, den Xchange für dieses Feld noch nie abgeglichen hat – etwa gleich nachdem Sie die Regel eingestellt haben:
| Lage | Was geschieht |
|---|---|
| Beide Seiten enthalten dasselbe | nichts zu entscheiden |
| Das Feld ist im Zielsystem leer | Der Wert der Quelle wird geschrieben. |
| Die Quelle liefert keinen Wert | Der Wert im Zielsystem bleibt stehen. |
| Beide Seiten enthalten verschiedene Werte | ein Konflikt – die Regel entscheidet |
Ein entschiedener Konflikt bleibt entschieden. Bleibt der Wert im Zielsystem stehen – nach der Regel oder weil Sie in der Manuellen Klärung das Zielsystem gewählt haben –, merkt sich Xchange beide Werte als neuen Abgleich; schreibt es den Wert der Quelle, steht dieser auf beiden Seiten. Solange sich keine Seite erneut ändert, lässt die Route das Feld deshalb in Ruhe; eine neue Änderung auf einer Seite wird wieder übertragen. Ein vorgelegtes Feld ist noch nicht entschieden: Xchange merkt sich dafür nichts, und jeder weitere Vorgang vergleicht es erneut.
Nicht jeder Vorgang folgt den Regeln. Bei diesen Anlässen schreibt Xchange anders:
| Anlass | Was gilt |
|---|---|
| Eine Löschung – über die Bereinigung oder das Löschkennzeichen | Die Regeln gelten nicht; geschrieben wird der Stand der Quelle. |
| Ein gezielter Lauf – Einzeln übertragen auf der Seite Ausführung oder Erneut verarbeiten im Verlauf oder in der Manuellen Klärung | Die Regeln gelten nicht; geschrieben wird der Stand der Quelle, weil Sie den Lauf genau dafür angestoßen haben. |
| Ausgenommen davon: ein Vorgang, zu dem ein Fall mit der Ursache Feldkonflikt gehört – Entscheidung anwenden und Alle Werte in … behalten im Fall, Erneut verarbeiten im Verlauf, Erneut verarbeiten und Schließen über mehrere Einträge der Manuellen Klärung | Von den vorgelegten Feldern schreibt Xchange die, für die Sie die Quelle oder nichts gewählt haben; wo Sie das Zielsystem gewählt haben, bleibt dessen Wert stehen. Die übrigen Felder vergleicht Xchange nach den Regeln. |
Den letzten Abgleich speichert Xchange erst, wenn das Zielsystem das Schreiben bestätigt hat. Fallen alle Felder eines Vorgangs weg, sendet Xchange nichts, und der Vorgang endet trotzdem Erfolgreich.
Meldungen
| Meldung | Bedeutung |
|---|---|
| „Abweichung für ein Feld, das nicht mehr verglichen wird – „Standard“ wählen“ | Das Feld steht noch mit eigener Regel in der Tabelle, nimmt aber nicht mehr teil. Hinter seinem Namen steht der Grund (Kein Konflikt erkennbar): Keine Route liest das Feld mehr zurück. Mit Standard verschwindet die Zeile. Löschen Sie die Zeile aus der Zuordnung, verschwindet ihre Regel mit ihr. |
| „Das Ziel ersetzt diese Liste als Ganzes – nur „Wert aus der Quelle übernehmen“ ist möglich“ | An einer Liste, die das Zielsystem als Ganzes ersetzt, oder an einem ihrer Felder steht eine andere Regel. Wählen Sie Wert aus … übernehmen. |
| „Beide Richtungen behalten den Zielwert – Änderungen an diesem Feld werden in keine Richtung übertragen“ | Diese Route und ihre Gegenrichtung stehen für dasselbe Feld beide auf Wert in … behalten. Die Meldung steht an beiden Routen. |
| „„Abweichungen je Feld“ sind ungültig“ | Die Regeln je Feld sind als Ganzes nicht lesbar. Aus dem Reiter heraus entsteht das nicht, nur über einen Import. |
Löschverhalten
Das Feld heißt am Bildschirm Strategie und beantwortet eine Frage: Was geschieht mit einem Datensatz, den die Route früher übertragen hat und der in der Quelle nicht mehr gilt?
| Stellung | Wirkung |
|---|---|
| Nichts tun | Der Datensatz bleibt im Zielsystem, wie er ist. Xchange meldet nichts. |
| Im Zielsystem deaktivieren | Xchange meldet dem Zielsystem, dass der Datensatz nicht mehr gilt. Was dort daraufhin geschieht, richtet das Zielsystem ein. |
Es gibt genau diese beiden Stellungen, und löschen oder deaktivieren tut stets das Zielsystem. Im Zielsystem deaktivieren schickt eine Nachricht; ob der Datensatz daraufhin entfernt oder inaktiv gesetzt wird, entscheidet das Zielsystem.
Wirksam wird die Einstellung auf zwei Wegen:
- Die Bereinigung meldet nach einem Lauf die Datensätze, die der Lauf nicht mehr geliefert hat – weil sie aus dem Datenfilter gefallen oder in der Quelle gelöscht sind. Sie ist eine Einstellung des Zeitplans und gibt es nur an Routen, die einen Datenbestand lesen; wo sie eingeschaltet wird, steht unter Nach Zeitplan laufen lassen.
- Das Löschkennzeichen erkennt einen gelöschten Datensatz in dem Moment, in dem die Quelle ihn liefert – an jeder Route, gleich woher sie liest.
Ohne einen der beiden bleibt das Feld folgenlos.
Im Beispiel: Bei „Artikel Cambira Austria“ ist die Bereinigung nur am sonntäglichen Lauf
eingeschaltet. ERS-2087 wurde aus der Artikelgruppe 101 Ersatzteile in die Artikelgruppe 104
Auslaufartikel verschoben und fiel damit aus dem Datenfilter. Der sonntägliche Lauf hat das
gemeldet, und CAMBIRA_AT hat den Artikel daraufhin inaktiv gesetzt; er steht dort weiterhin.
Für die Meldung hebt Xchange den zuletzt übertragenen Stand jedes Datensatzes auf – aber nur, solange Im Zielsystem deaktivieren eingestellt ist. Auf diesen Stand greift die Meldung zurück, wo die Quelle den Datensatz nicht mehr vollständig liefert; beim Löschkennzeichen ist das immer so. Für einen Datensatz, der übertragen wurde, als die Route auf Nichts tun stand, fehlt dieser Stand: Xchange schreibt dann nichts, und der Vorgang geht in die Manuelle Klärung mit der Ursache Löschung ohne gespeicherte Daten.
Löschkennzeichen
Manche Quellen löschen einen Datensatz nicht, sondern liefern ihn weiter – mit einem Feld, das sagt, dass er gelöscht ist, oft ohne seine übrigen Felder:
{ "customer_no": "K-10352", "deleted": true }
Das Löschkennzeichen beschreibt, woran die Route einen solchen Datensatz erkennt. Es ist eine Bedingung über den gelesenen Datensatz, aufgebaut wie die Bedingung eines Schritts: eine Gruppe mit bis zu 10 Bedingungen. Unter dem Titel steht „Datensätze, die diese Bedingung erfüllen, gelten in der Quelle als gelöscht.“ Ab der ersten Bedingung erscheint Verknüpfung mit UND und ODER: ob alle Bedingungen erfüllt sein müssen oder eine genügt.
| Spalte | Inhalt |
|---|---|
| Feld | ein Feld des gelesenen Datensatzes, im Beispiel oben OriginalPayload.deleted. Die Vorschlagsliste bietet die Felder der Quelle an; kennt Xchange keine, steht dort „Keine Quellfelder bekannt. Geben Sie den Feldnamen ein.“ |
| Operator | wie in der Bedingung eines Schritts; welche Operatoren es gibt, steht unter Die Operatoren |
| Wert | ein fester Wert, gegen den verglichen wird – im Beispiel oben true. Ein Operator ohne Vergleichswert blendet die Zelle aus; ein Operator, der gegen mehrere Werte vergleicht, nimmt mehrere auf. |
Ist nichts eingetragen, steht dort „Kein Löschkennzeichen festgelegt. Gelesene Datensätze gelten nie als gelöscht.“
Im Beispiel: Angenommen, Cambira holt zusätzlich die Fachhandelskunden des Shops mit der Route
„Kunden Webshop“, und der Shop liefert ein geschlossenes Kundenkonto noch eine Weile mit, wie oben
K-10352. Die Route steht auf Im Zielsystem deaktivieren und erkennt den Datensatz an einer
Bedingung:

Ein gekennzeichneter Datensatz kommt auch am Datenfilter vorbei. Liefert die Quelle einen gelöschten Datensatz nur noch mit Schlüssel und Kennzeichen, erfüllt er den Datenfilter meist nicht mehr – er wird trotzdem verarbeitet. Damit das geht, fragt eine Route, die einen Datenbestand liest, die Quelle ungefiltert ab und wendet den Datenfilter selbst an, sobald ein Löschkennzeichen eingetragen ist.
Was mit einem gekennzeichneten Datensatz geschieht
| Fall | Ergebnis am Vorgang |
|---|---|
| Löschverhalten Nichts tun | Übersprungen (Gelöscht) – nichts wird geschrieben. |
| Im Zielsystem deaktivieren, der Datensatz wurde schon übertragen | Die Route überträgt den zuletzt übertragenen Stand erneut, mit der Ereignisart Löschung. |
| Im Zielsystem deaktivieren, der Datensatz wurde übertragen, sein Stand aber nicht aufgehoben | Manuelle Klärung mit der Ursache Löschung ohne gespeicherte Daten – nichts wird geschrieben. |
| Im Zielsystem deaktivieren, der Datensatz wurde nie übertragen | Übersprungen (Nie übertragen) – im Zielsystem gibt es nichts zu deaktivieren. |
Die Zuordnung bekommt denselben Stand, den sie zuletzt übertragen hat. Fragt keine ihrer Zeilen das
Quellfeld Header.EventType ab, ergibt sich dasselbe Ergebnis wie beim letzten Mal, und der Vorgang
endet als Übersprungen (Keine Änderung). Das Feld, das im Zielsystem deaktiviert – etwa ein
Aktiv-Kennzeichen –, muss deshalb davon abhängen, ob Header.EventType Löschung ist. Im Testbereich
der Zuordnung zeigt eine gekennzeichnete Testnachricht das Ergebnis,
das auch der Lauf hätte.
Meldungen
Ein leeres Feld oder ein fehlender Wert wird an der Zelle gemeldet wie in jeder Bedingung. Dazu kommen drei Meldungen, die es nur hier gibt:
| Meldung | Bedeutung |
|---|---|
| „„Löschkennzeichen“ ist ungültig“ | Das Löschkennzeichen als Ganzes ist nicht lesbar, etwa weil es mehr als eine Gruppe oder mehr als 10 Bedingungen trägt. Aus dem Reiter heraus entsteht das nicht, nur über einen Import. |
| „„Feld“ liegt nicht im gelesenen Quelldatensatz – ein Feld aus dem Quelldatensatz wählen“ | Das Feld gehört nicht zum gelesenen Datensatz, sondern etwa zu den Zusatzdaten. Die gibt es zum Zeitpunkt der Entscheidung noch nicht. |
| „Löschkennzeichen und ein Datenfilter auf verknüpfte Datensätze sind nicht kombinierbar – eines von beiden entfernen“ | Ein solcher Datenfilter braucht einen zweiten Abruf, den ein gelöschter Datensatz nicht mehr hergibt. |
Lässt sich das Löschkennzeichen an einem gelieferten Datensatz nicht auswerten, geht der Vorgang in die Manuelle Klärung mit der Ursache Löschkennzeichen fehlerhaft.
Siehe auch
- Festlegen, welche Seite bei einem Feldkonflikt gewinnt (Anleitung) – eine Regel für ein Feld einstellen und den ersten Fall entscheiden
- Löschungen übertragen oder bewusst stehen lassen (Anleitung) – Löschverhalten, Bereinigung und Löschkennzeichen Schritt für Schritt
- Nach Zeitplan laufen lassen (Anleitung) – wo die Bereinigung eingeschaltet wird
- Routen – Quelldaten (Referenz) – der Datenfilter, aus dem ein Datensatz fallen kann
- Routen – Zuordnung (Referenz) – die Bedingung eines Schritts und der Testbereich
- Manuelle Klärung (Referenz) – ein vorgelegter Feldkonflikt und wie Sie ihn entscheiden
- Verlauf (Referenz) – wie eine Regel bei einem Vorgang entschieden hat
- Ausführung (Grundkonzept) – warum ein Vorgang übersprungen wird