Zum Hauptinhalt springen

Löschungen übertragen oder bewusst stehen lassen

Ein Artikel verlässt den Ausschnitt, den eine Route überträgt: ERS-2087 „Dichtungssatz Nordfluss“ stand in der Artikelgruppe 101 Ersatzteile und wurde in die Artikelgruppe 104 Auslaufartikel verschoben. Die Route „Artikel Cambira Austria“ hat ihn monatelang in den österreichischen Mandanten gestellt – seit der Umstellung fällt er aus der Übertragung heraus. Drüben steht er unverändert weiter und sieht aus, als würde er noch gepflegt.

Vorweg die wichtigste Aussage: Xchange löscht im Zielsystem nichts. Auch die stärkere der beiden Einstellungen meldet nur – was das Zielsystem daraus macht, entscheidet es selbst. Im Beispiel setzt der österreichische Mandant den Artikel inaktiv.

Was Sie brauchen​

  • Die Berechtigung Routen in der Stufe Voll – siehe Berechtigungen.
  • Eine Route vom Typ Verarbeitung. Nur sie hat den Reiter Verhalten.
  • Damit ein Austritt aus dem Datenfilter gemeldet wird: die Datenherkunft Datenbestand und einen Zeitplan mit dem Lauftyp Vollständig – siehe Nach Zeitplan laufen lassen. Einen Bestand, aus dem etwas herausfallen könnte, durchsucht allein eine Route mit Datenbestand; eine Warteschlangenroute bekommt gereicht, was fällig ist. Kennzeichnet die Quelle gelöschte Datensätze selbst, gilt das nicht – siehe Wenn die Quelle Löschungen kennzeichnet.
  • Einstieg: Konfiguration → Routen → die Route → Reiter Verhalten.

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

1. Das Löschverhalten wählen​

Im Reiter Verhalten, Abschnitt Löschverhalten, steht ein Feld Strategie mit zwei Stellungen:

StellungWas sie bedeutet
Nichts tunDer Datensatz bleibt im Zielsystem so stehen, wie er zuletzt übertragen wurde. Xchange bleibt still. Das ist die Vorgabe.
Im Zielsystem deaktivierenXchange meldet den Datensatz an das Zielsystem, sobald er den Ausschnitt verlässt. Was dort geschieht, richtet das Zielsystem ein – üblicherweise setzt es ihn inaktiv.

Für „Artikel Cambira Austria“ steht die Stellung auf Im Zielsystem deaktivieren: Ein Auslaufartikel, der im österreichischen Mandanten aktiv bleibt, wird dort weiter bestellt.

Nichts tun passt, wo das Zielsystem die Daten ohnehin selbst pflegt oder wo ein Austritt vorübergehend sein kann.

Wählen Sie die Stellung, bevor die Route den Bestand zum ersten Mal vollständig überträgt. Den zuletzt übertragenen Stand, auf den eine Meldung zurückgreift, hebt Xchange nur unter Im Zielsystem deaktivieren auf. Fehlt er für einen früher übertragenen Datensatz, wird dessen Löschung nicht übertragen, sondern landet in der Manuellen Klärung – siehe Routen – Verhalten.

2. Das Melden einschalten​

Die Stellung braucht einen zweiten Schalter. Sie sagt, wie ein Austritt behandelt wird. Wann Xchange nachsieht, ob es einen gibt, ist eine zweite Einstellung, und sie steht an einer anderen Stelle: am Zeitplan.

  1. Wechseln Sie in den Reiter Automatik und öffnen Sie den zeitgesteuerten Auslöser.
  2. Stellen Sie den Lauftyp auf Vollständig.
  3. Setzen Sie das Häkchen Nicht mehr gelieferte Datensätze melden unter der Beschriftung Bereinigung.

Ein zeitgesteuerter Auslöser mit Lauftyp Vollständig und gesetztem Häkchen zum Melden.

Das Häkchen erscheint nur, wenn beides zusammentrifft – Lauftyp Vollständig und Löschverhalten Im Zielsystem deaktivieren. Fehlt es, prüfen Sie zuerst diese beiden Felder. Stellen Sie den Lauftyp später auf Inkrementell zurück, nimmt Xchange das Häkchen wieder weg.

Warum nur ein vollständiger Lauf: Ein inkrementeller Lauf sieht sich nur an, was sich seit dem letzten Mal geändert hat. Ein Datensatz, der aus dem Datenfilter gefallen ist, ist für ihn schlicht verschwunden. Erst ein vollständiger Lauf kennt den ganzen aktuellen Ausschnitt und kann ihn mit dem vergleichen, was die Route früher übertragen hat.

Bei „Artikel Cambira Austria“ steht das Häkchen deshalb am sonntäglichen Lauf um 03:00 Uhr, der vollständig läuft; der tägliche um 02:00 Uhr läuft inkrementell und bleibt ohne Häkchen. ERS-2087 fiel unter der Woche aus dem Filter und wurde am Sonntag gemeldet.

Denselben Schalter finden Sie im Dialog Lauf starten, wenn Sie einen vollständigen Lauf von Hand anstoßen – siehe Von Hand nachschieben – ein Lauf oder ein einzelner Datensatz.

3. Prüfen und aktivieren​

Aktivieren Sie den Konfigurationsstand – siehe Prüfen und aktivieren. Erst damit wirkt die Einstellung.

Der nächste vollständige Lauf zeigt das Ergebnis: Im Verlauf steht hinter ihm ein zweiter Lauf vom Typ Bereinigung, der auf ihn verweist. Er enthält genau die gemeldeten Datensätze – im Beispiel einen, ERS-2087. In seinen Vorgangsdetails steht unter Anlass Löschung – nicht mehr geliefert – siehe Verlauf.

Was Xchange für einen Austritt hält​

Ein Austritt ist ein Datensatz, den diese Route früher übertragen hat und der im vollständigen Lauf diesmal fehlt.

Daraus folgt eine Abgrenzung, die im Alltag wichtig wird:

Der Datensatz …Was Xchange sieht
… fällt aus dem Datenfilter, existiert aber weiterEr fehlt im Lauf. Austritt.
… wurde im Quellsystem gelöschtEr fehlt im Lauf. Austritt – derselbe Fall.

Beides ist für Xchange dasselbe Ereignis. Der Ereignisauslöser reagiert nur auf Angelegt und auf Geändert; eine Löschung in SAP Business One bleibt für ihn stumm. Ein gelöschter Datensatz wird deshalb erst beim nächsten vollständigen Lauf mit gesetztem Häkchen bemerkt.

Einen Unterschied merken Sie doch, und zwar an dem, was übertragen wird: Bei einem herausgefilterten Datensatz kann Xchange die aktuellen Felder noch abrufen. Bei einem gelöschten ist das vorbei – dann greift Xchange auf die zuletzt übertragenen Daten zurück. Fehlen auch die, schreibt Xchange nichts, und der Vorgang liegt mit der Ursache Löschung ohne gespeicherte Daten in der Manuellen Klärung – siehe Manuelle Klärung.

Als gesehen gilt jeder Datensatz, den der vollständige Lauf gelesen hat – auch einer, dessen Übertragung dabei fehlgeschlagen ist. Gemeldet wird also allein, was im gelesenen Bestand fehlt.

Wenn die Quelle Löschungen kennzeichnet​

Manche Quellen lassen einen gelöschten Datensatz nicht verschwinden, sondern liefern ihn weiter – mit einem Feld, das ihn als gelöscht ausweist, oft nur noch mit seinem Schlüssel:

{ "customer_no": "K-10352", "deleted": true }

Für eine solche Quelle brauchen Sie weder den vollständigen Lauf noch das Häkchen. Die Route erkennt die Löschung in dem Moment, in dem der Datensatz ankommt – gleich, ob sie einen Datenbestand liest oder aus einer Warteschlange.

  1. Wählen Sie im Reiter Verhalten unter Löschverhalten die Stellung Im Zielsystem deaktivieren.
  2. Tragen Sie unter Löschkennzeichen die Bedingung ein, an der ein gelöschter Datensatz zu erkennen ist – im Beispiel Feld OriginalPayload.deleted, Wert true.
  3. Lassen Sie die Zuordnung die Löschung unterscheiden: Setzen Sie das Feld, das im Zielsystem deaktiviert, abhängig davon, ob das Quellfeld Header.EventType Löschung ist. Im Testbereich der Zuordnung prüfen Sie das mit einer gekennzeichneten Testnachricht.

Ohne Schritt 3 kommt im Zielsystem nichts an: Die Route überträgt den zuletzt übertragenen Stand erneut, die Zuordnung macht daraus dasselbe wie beim letzten Mal, und der Vorgang endet als Übersprungen (Keine Änderung). Lief der Vorgang als Löschung, steht in seinen Vorgangsdetails unter Anlass Löschung – Löschkennzeichen in der Quelle.

Ein gekennzeichneter Datensatz, den die Route nie übertragen hat, endet als Übersprungen (Nie übertragen); steht das Löschverhalten auf Nichts tun, endet jeder als Übersprungen (Gelöscht). Alle Felder und Meldungen des Löschkennzeichens stehen unter Routen – Verhalten.

Wenn auf einmal sehr viele austreten​

Fällt bei einem Lauf ein großer Teil des Bestands aus dem Ausschnitt, hält Xchange die Nachrichten an, statt sie zu schicken. Der Lauf steht dann auf Bereinigung angehalten, und jemand entscheidet zwischen Freigeben und Verwerfen.

Der Halt schützt vor einem versehentlich zu eng gesetzten Datenfilter: Er macht aus halbem Bestand einen Austritt, und ohne diesen Halt stünde die halbe Artikelliste drüben inaktiv, bevor es jemand merkt. Wie Sie so einen Fall entscheiden, steht unter Eine angehaltene Bereinigung freigeben oder verwerfen.

Siehe auch​