Nur Geändertes übertragen
„Artikel Cambira Austria“ läuft nachts um 02:00 Uhr und liest jedes Mal alle 1.186 Artikel, die ihr Datenfilter umfasst, jeden als eigenen Vorgang – geändert haben sich davon rund 70. Übertragen werden nur diese 70, die übrigen enden als Übersprungen (Keine Änderung). Diese Anleitung stellt die Route so ein, dass sie nur noch die geänderten liest. Warum das die Regel und der vollständige Lauf die Ausnahme ist, steht im Grundkonzept Auslösung.
Dafür sind drei Stellen zuständig: Der Änderungsfilter entscheidet, welche Datensätze überhaupt gelesen werden, der Lauftyp schaltet den Zeitplan darauf um, und die Änderungserkennung sortiert aus, was gelesen, aber unverändert ist.
Was Sie brauchen
- Die Berechtigung Routen in der Stufe Voll – siehe Berechtigungen.
- Eine Route mit Zeitplan und einem Abrufendpunkt, deren Feldstruktur aufgelöst ist.
- Einstieg: Konfiguration → Routen, dann die Route auswählen.
Xchange sichert jede Eingabe automatisch. Im Betrieb wirkt sie erst mit dem aktivierten Konfigurationsstand – das ist Schritt 4.
1. Den Änderungsfilter prüfen
Er steht auf dem Reiter Quelldaten im aufklappbaren Abschnitt Änderungsfilter, neben dem Hinweis „für inkrementelle Läufe“.
- Reiter Quelldaten öffnen, Abschnitt Änderungsfilter aufklappen.
- Meist steht dort schon etwas: Xchange trägt die Datumsfelder der Quelle einmal selbst
ein, sobald deren Feldstruktur vorliegt – bei SAP-Artikeln
UpdateDateundCreateDate. Prüfen Sie nur, dass die Zeilen stehen. - Ist der Abschnitt leer: Feld hinzufügen und das Datumsfeld der Quelle wählen. Mehr ist nicht einzustellen – einen Operator oder einen Wert gibt es nicht.
- Bei mehreren Feldern kommt ein Datensatz mit, sobald eines davon sich seit dem letzten Lauf
geändert hat. Ein Zahlenfeld wie
DocEntryerkennt nur neu angelegte Datensätze – für Änderungen braucht es ein Datumsfeld.

Ist an der Anbindung unter Änderungen erkennen Quelle liefert Änderungs-Token gewählt, steht im Abschnitt statt der Felder der Satz „Der Abrufendpunkt liefert nur die Änderungen seit dem letzten Lauf. Ein Änderungsfilter ist hier nicht erforderlich.“ – dann gehen Sie gleich weiter zu Schritt 2.
Die Felder des Abschnitts stehen in Routen – Quelldaten.
2. Den Lauftyp auf „Inkrementell“ stellen
- Reiter Automatik öffnen und den zeitgesteuerten Auslöser der Route auswählen.
- Unter Lauftyp Inkrementell wählen.
Fehlt der Änderungsfilter aus Schritt 1, meldet ihn der Reiter Quelldaten jetzt als Pflichtfeld – deshalb diese Reihenfolge.
Liest die Route über eine REST-Anbindung, die über Seitennummer oder Versatz weiterblättert, braucht diese eine Sortierung – es sei denn, sie steht auf Quelle liefert Änderungs-Token. Fehlt die Sortierung, meldet die Prüfung am Lauftyp „Anbindung ist nicht für sortiertes Lesen eingerichtet“. Was an der Anbindung einzutragen ist, steht unter Anbindungen – Sammelabruf.
Hängt an der Route eine Bereinigung, lassen Sie daneben einen vollständigen Lauf stehen, etwa wöchentlich: eine Route darf mehrere Auslöser tragen, und die Bereinigung läuft nur am vollständigen Lauf mit. Die Felder des Auslösers stehen in Routen – Automatik.
3. Felder aus der Änderungserkennung nehmen
Vor jeder Übertragung vergleicht Xchange das Ergebnis der Zuordnung mit dem, was es zuletzt für denselben Datensatz gesendet hat. Sind beide gleich und hat sich der Datensatz im Zielsystem seither nicht geändert, entfällt die Übertragung.
Dieser Vergleich läuft ins Leere, wenn die Zuordnung bei jedem Lauf einen neuen Wert erzeugt – eine Zeile mit der Transformation Aktueller Zeitstempel oder Neue GUID etwa. Dann unterscheidet sich das Ergebnis immer, und jeder gelesene Datensatz gilt als geändert. Nehmen Sie solche Zeilen aus dem Vergleich heraus:
- Reiter Zuordnung öffnen und die betreffende Zeile suchen.
- Am Ende der Zeile auf das Zahnrad klicken.
- Im Dialog auf den Reiter Optionen wechseln.
- Unter Änderungserkennung das Kästchen Feld ausschließen ankreuzen.
- Dialog schließen.

Lassen Sie mindestens eine Zeile im Vergleich. Xchange weist darauf hin: „Alle Zuordnungen sind von der Änderungserkennung ausgeschlossen – Änderungen werden nie erkannt“. Die übrigen Felder des Dialogs stehen in Routen – Zuordnung.
4. Prüfen und aktivieren
Ihre Änderungen liegen im Entwurf. Prüfen Sie ihn und aktivieren Sie ihn – erst dann läuft der nächste nächtliche Lauf inkrementell. Der Weg dorthin steht in Prüfen und aktivieren.
Den Stand, ab dem gelesen wird, merkt sich nur ein inkrementeller Lauf: je Feld des Änderungsfilters den größten Wert, den er gelesen hat. Der erste inkrementelle Lauf nach der Aktivierung hat diesen Stand noch nicht und verarbeitet deshalb einmal den vollständigen Umfang – die Oberfläche sagt es an, mit „verarbeitet den vollständigen Umfang – es ist noch kein Stand gespeichert.“. Bei „Artikel Cambira Austria“ liest also die erste Nacht noch alle 1.186 Artikel, und erst ab der zweiten nur noch die geänderten. Wie Sie diesen Lauf klein halten, steht in Den ersten Lauf begrenzen.
5. Nachsehen, ob es wirkt
Den ersten inkrementellen Lauf können Sie sofort starten, ohne Warten auf die Nacht:
- Ausführung öffnen und die Route in der Liste auswählen.
- Lauf starten, als Lauftyp Inkrementell wählen, Starten.
Bietet der Dialog keinen Lauftyp an, sondern fragt nur „Vollständigen Lauf für diese Route jetzt starten?“, kann die Route keinen inkrementellen Lauf. Den Grund nennt der Satz darunter:
| Satz | Was fehlt |
|---|---|
| „Ein inkrementeller Lauf ist erst möglich, wenn der Änderungsfilter der Route mindestens ein Feld enthält.“ | Schritt 1 |
| „Die Anbindung liest nicht sortiert. Richten Sie an der Anbindung eine Sortierung ein, dann ist ein inkrementeller Lauf möglich.“ | die Sortierung der Anbindung aus Schritt 2 |
| „Für die gewählte Änderungserkennung fehlen an der Anbindung Angaben. Ergänzen Sie sie, dann ist ein inkrementeller Lauf möglich.“ | die Angaben der Option, die an der Anbindung unter Änderungen erkennen gewählt ist |
Brechen Sie dann ab, statt vollständig zu starten.
Zwei Stellen zeigen danach, dass es wirkt:
- In der Ausführung steht bei der Route Nächster inkrementeller Lauf und darunter je Feld des
Änderungsfilters eine Zeile wie „liest UpdateDate ab …“, mit dem größten Wert, den der Lauf
gelesen hat. Weil SAP Business One
UpdateDatenur tagesgenau führt, liest der nächste Lauf die Datensätze dieses Tages erneut – aussortiert werden sie von der Änderungserkennung aus Schritt 3. Bei einem Feld mit Uhrzeit beginnt der Lauf fünf Minuten früher, damit zeitgleich gespeicherte Änderungen nicht verloren gehen. - Im Verlauf tragen die unveränderten Datensätze den Status Übersprungen (Keine Änderung). Liest ein späterer Lauf bei „Artikel Cambira Austria“ rund 143 Artikel und steht etwa die Hälfte davon auf diesem Status, sitzt die Einstellung.
Siehe auch
- Mit einem Datenfilter einschränken (Anleitung) – weniger übertragen, indem die Route von vornherein nur einen Ausschnitt in ihren Umfang nimmt
- Den ersten Lauf begrenzen (Anleitung) – damit der erste inkrementelle Lauf klein bleibt, statt den ganzen Altbestand mitzunehmen
- Verlauf (Referenz) – die Statuswerte eines Vorgangs im Einzelnen
- Auslösung (Grundkonzept) – wann ein vollständiger Lauf trotzdem der richtige ist