Zum Hauptinhalt springen

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 RoutenWas Sie auf dem Reiter können
Keineder Menüpunkt Routen fehlt, und mit ihm dieser Reiter
Nur lesenKonfliktregeln, Löschverhalten und Löschkennzeichen ansehen; die Felder lassen sich nicht ändern, Bedingung hinzufügen und Bedingung entfernen fehlen
Vollalles ändern, Bedingungen hinzufügen und entfernen

Der Reiter Verhalten mit drei Feldern auf dem Standard „Wert aus SAP Business One übernehmen“, dem Löschverhalten „Im Zielsystem deaktivieren“ und einem leeren Löschkennzeichen.

Aufbau​

BereichInhalt
Konfliktewelche 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öschverhaltendas Feld Strategie: was die Route mit einem Datensatz tut, der in der Quelle nicht mehr gilt.
Löschkennzeichendie 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.

Der Abschnitt Konflikte der Route „Bestellungen Webshop“: Standard „Wert aus „Webshop Cambira“ übernehmen“, das Feld PaymentMethod auf „Zur Klärung vorlegen“.

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​

RegelWirkung
Wert aus … übernehmenDie 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 … behaltenBei einem Konflikt bleibt der Wert im Zielsystem stehen. Die übrigen Felder des Datensatzes werden geschrieben.
Zur Klärung vorlegenBei 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:

SpalteInhalt
Zielfelddas Feld im Zielsystem
RegelStandard (…) – 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.
Gegenrichtungdie 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:

SatzWas 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:

ListeAufgeführt als
mit Suchen über auf Markierte Felder, in SAP Business One auch mit Verknüpfen übereine 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 beidesnicht 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 Feldereine 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 Werteneine 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 QuelleZeile im ZielsystemWas geschieht
neuneu, mit demselben SchlüsselXchange vergleicht die Felder wie bei einem Datensatz ohne letzten Abgleich.
seit dem letzten Abgleich geändertgelöschtein Konflikt – die Regel der Liste entscheidet
unverändertgelöschtDie Zeile bleibt gelöscht.
gelöschtbeliebigkein 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:

LageWas geschieht
Beide Seiten enthalten dasselbenichts zu entscheiden
Nur die Quelle hat sich geändertDer Wert der Quelle wird geschrieben.
Nur das Zielsystem hat sich geändertDer Wert im Zielsystem bleibt stehen.
Beide haben sich geändert und enthalten Verschiedenesein 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 gelesenDer 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:

LageWas geschieht
Beide Seiten enthalten dasselbenichts zu entscheiden
Das Feld ist im Zielsystem leerDer Wert der Quelle wird geschrieben.
Die Quelle liefert keinen WertDer Wert im Zielsystem bleibt stehen.
Beide Seiten enthalten verschiedene Werteein 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:

AnlassWas gilt
Eine Löschung – über die Bereinigung oder das LöschkennzeichenDie 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ärungDie 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ärungVon 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​

MeldungBedeutung
„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?

StellungWirkung
Nichts tunDer Datensatz bleibt im Zielsystem, wie er ist. Xchange meldet nichts.
Im Zielsystem deaktivierenXchange 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.

Löschverhalten vor dem ersten vollständigen Lauf einstellen

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.

SpalteInhalt
Feldein 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.“
Operatorwie in der Bedingung eines Schritts; welche Operatoren es gibt, steht unter Die Operatoren
Wertein 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:

Der Abschnitt Löschkennzeichen der Route „Kunden Webshop“: Verknüpfung UND, eine Bedingung mit dem Feld OriginalPayload.deleted, dem Operator „ist gleich“ und dem Wert true.

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​

FallErgebnis am Vorgang
Löschverhalten Nichts tunÜbersprungen (Gelöscht) – nichts wird geschrieben.
Im Zielsystem deaktivieren, der Datensatz wurde schon übertragenDie Route überträgt den zuletzt übertragenen Stand erneut, mit der Ereignisart Löschung.
Im Zielsystem deaktivieren, der Datensatz wurde übertragen, sein Stand aber nicht aufgehobenManuelle 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 muss die Löschung unterscheiden

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:

MeldungBedeutung
„„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​