Zum Hauptinhalt springen

Den ersten Lauf begrenzen

Als „Artikel Webshop“ im März zum ersten Mal lief, ging der ganze Artikelstamm in einem Zug in den Shop: 2.180 Vorgänge. Das ging gut. Es hätte auch anders kommen können – ein falsch zugeordnetes Feld oder eine Anbindung, die anders antwortet als gedacht, fällt bei 2.180 Datensätzen genauso auf wie bei fünfzig, nur ist die Aufräumarbeit im Zielsystem eine andere.

Diese Anleitung geht den vorsichtigen Weg: erst einen kleinen Ausschnitt übertragen, das Ergebnis ansehen, dann öffnen.

Begrenzen lässt sich dabei nur die Menge, die die Route überhaupt sieht. Der Lauftyp ist dafür das falsche Werkzeug: Ein inkrementeller Lauf knüpft an den Stand des vorigen inkrementellen Laufs an; beim ersten fehlt dieser Stand, deshalb liest er denselben Umfang wie ein vollständiger. Und ein vollständiger Lauf nimmt stets alles mit, was die Route sieht. Das Werkzeug ist also der Datenfilter.

Unterschied zu Mit einem Datenfilter einschränken

Dort legt der Filter fest, was die Route dauerhaft überträgt. Hier ist derselbe Filter ein Provisorium, das nach dem Probelauf wieder weicht – und der letzte Schritt dieser Anleitung ist der, ihn wegzunehmen.

Was Sie brauchen​

  • Vier Berechtigungen, jede in der Stufe Voll: Routen setzt den Filter, Aktivierung aktiviert den Stand, Ausführung startet den Lauf, Automatik gibt die Route am Ende frei. Das sind selten alle vier in einer Hand – siehe Berechtigungen.
  • Eine Route, die fertig konfiguriert ist und deren Quelle einen Abrufendpunkt hat. Erst der Abrufendpunkt gibt der Route einen Datenumfang zum Begrenzen; fehlt er, meldet der Start „Diese Route reagiert nur auf Ereignisse – es gibt keinen Datenumfang zum Starten“.

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

1. Die Automatik geschlossen lassen​

Eine neue Route bleibt zunächst ruhig, auch wenn sie bereits einen Auslöser trägt: Im Screen Ausführung ist ihr Schalter in der Spalte Automatik aus, und in der Spalte Zustand steht Noch nie gestartet.

Lassen Sie den Schalter aus. Von Hand starten können Sie trotzdem, und zwar jederzeit. Nur der Auslöser der Route ruht, solange der Schalter aus ist.

War die Route schon einmal im Betrieb, legen Sie den Schalter um, bevor Sie den Filter ändern. In der Spalte Zustand steht dann Pausiert (Manuell).

2. Den Filter enger stellen, als er bleiben soll​

Setzen Sie auf dem Reiter Quelldaten einen Datenfilter, der einen überschaubaren Ausschnitt beschreibt – bei einem Artikelstamm z. B. eine einzige Artikelgruppe:

  1. Abschnitt Datenfilter aufklappen, Gruppe hinzufügen, dann Bedingung hinzufügen.
  2. Feld ItemsGroupCode, Operator ist gleich, Wert 100 – die Artikelgruppe Armaturen.
  3. Treffer zählen wählen.

Die Zahl daneben ist der Umfang Ihres Probelaufs. Fällt sie größer aus als gewünscht, stellen Sie die Bedingung enger, bevor Sie weitermachen – nachher ist die Übertragung geschehen. Der ausführliche Weg mit mehreren Bedingungen steht in Mit einem Datenfilter einschränken.

Wählen Sie einen Ausschnitt, den Sie im Zielsystem nachsehen können.

3. Aktivieren und von Hand starten​

  1. Entwurf prüfen und aktivieren – der Weg steht in Prüfen und aktivieren.
  2. Nach Ausführung wechseln und die Route auswählen.
  3. Lauf starten wählen und den Dialog mit Starten bestätigen.

„Artikel Webshop“ hat keinen Änderungsfilter; der Dialog stellt deshalb statt einer Lauftypwahl den Satz „Vollständigen Lauf für diese Route jetzt starten?“. Auf einer Route, die Änderungen erkennt, steht dort stattdessen die Wahl – beim ersten Lauf führen beide Lauftypen zum selben Umfang. Was der Dialog wann anbietet, steht in Von Hand nachschieben – ein Lauf oder ein einzelner Datensatz.

Steht im Dialog ein Kästchen Bereinigung, lassen Sie es aus. Es meldet Datensätze an das Zielsystem, die früher übertragen wurden und aus dem Datenfilter herausgefallen sind – und Ihr Filter ist gerade absichtlich eng. Eine eingeschaltete Bereinigung würde dem Zielsystem alles melden, was Sie für den Probelauf ausgeschlossen haben. Wovon es abhängt, ob das Kästchen überhaupt erscheint, steht in Nach Zeitplan laufen lassen.

4. Das Ergebnis ansehen​

Warten Sie ab, bis der Lauf durch ist, und sehen Sie sich zwei Dinge an:

  • Den Lauf selbst: Wie viele Vorgänge erfolgreich waren und was in der Manuellen Klärung gelandet ist. Der Weg dorthin steht in Prüfen, ob ein Lauf sauber durchlief.
  • Das Zielsystem: Sehen Sie einen der übertragenen Datensätze dort an. Stehen die Werte in den Feldern, in denen Sie sie erwarten? Ein Vorgang kann erfolgreich sein und trotzdem den falschen Wert geschrieben haben – das sieht nur das Zielsystem.

Der abgeschlossene Probelauf mit 608 erfolgreichen Vorgängen.

Stimmt etwas nicht, bessern Sie die Route nach und starten Sie erneut – mit demselben engen Filter. Ein zweiter Probelauf kostet nichts.

5. Die Begrenzung lösen​

Führen Sie diesen Schritt unbedingt aus. Bleibt der Filter stehen, überträgt die Route auf Dauer nur die eine Artikelgruppe – und die Läufe melden dabei durchweg Erfolg, sodass die Lücke leicht unbemerkt bleibt.

  1. Zurück auf den Reiter Quelldaten, Abschnitt Datenfilter.
  2. Die Gruppe löschen: in ihrer Kopfzeile ganz rechts das Kreuz – es trägt den Hinweistext Gruppe entfernen. Xchange fragt nach: „Die Gruppe und alle ihre Bedingungen werden entfernt. Diese Aktion kann nicht rückgängig gemacht werden.“
  3. Im Abschnitt steht danach Keine Bedingung – alle Datensätze einbezogen.
  4. Entwurf prüfen und aktivieren.

Soll dauerhaft ein Filter stehen, nur ein weiterer als der Probelauf-Filter, ändern Sie die Bedingung und lassen die Gruppe stehen – und zählen Sie die Treffer noch einmal.

Zum Schluss geben Sie die Automatik frei: In Ausführung den Schalter in der Spalte Automatik umlegen. Ab jetzt startet der Auslöser der Route die Läufe.

Wie es weitergeht​

Siehe auch​