Auf eine Änderung in SAP reagieren
„Artikel Webshop“ lief ein Vierteljahr lang nach der Uhr: jeden Morgen um 06:00 ein
vollständiger Lauf über den ganzen Artikelstamm. Wer um neun einen Preis korrigierte, sah ihn am
nächsten Morgen im Shop. Am 24.06.2026 um 09:35 wurde der Zeitplan entfernt und durch einen
Ereignisauslöser ersetzt. Seitdem geht die Preiskorrektur in dem Moment hinaus, in dem sie
gespeichert wird.
Im Folgenden hängen Sie einen Ereignisauslöser an eine Route, die ihre Daten aus SAP Business One liest.
Der Takt kommt dann von einem Ereignis statt von der Uhr – und damit ändert sich, was ein gewöhnlicher Lauf ist. Ein Zeitplan sammelt: ein Lauf am Tag, darin so viele Vorgänge, wie sich geändert haben. Ein Ereignis startet für jede einzelne Änderung einen eigenen Lauf mit genau einem Vorgang darin. In den 24 Stunden des 8. Oktober waren das bei „Artikel Webshop“ 141 Läufe und 141 Vorgänge – dieselbe Zahl zweimal.
Hier gibt das Ereignis den Takt. Soll die Route stattdessen zu festen Zeiten laufen – nachts um zwei, sonntags früh –, steht der Weg in Nach Zeitplan laufen lassen.
Was Sie brauchen
- Eine Export- oder interne Route. Ein Ereignisauslöser ist nur auf einer Route möglich, die aus SAP Business One liest. Auf einer Importroute bietet der Dialog Auslösertyp wählen allein Zeitgesteuert an, kommentarlos. Drehen Sie die Richtung einer Route nachträglich, erscheint die Meldung „Ein Ereignisauslöser ist nur für Export- und interne Routen möglich“. Eine interne Route, die das Objekt anlegt, auf das ihr Ereignis hört, kann sich selbst erneut auslösen – was dann zu tun ist, steht in Routen – Automatik.
- Eine Route, deren Daten in SAP Business One liegen und die einen Abrufendpunkt hat. Auf SAP-Ereignisse hören allein solche Routen; eine Route, die eine Warteschlange abarbeitet oder ihre Daten von einer anderen Route zugeteilt bekommt, bleibt dabei außen vor.
- Drei Berechtigungen, jede in der Stufe Voll: Routen legt den Auslöser an, Aktivierung aktiviert den Stand, Automatik gibt die Route am Ende frei – siehe Berechtigungen.
- Den Reiter Automatik der geöffneten Route. Dort stehen die Auslöser links in einer Liste, rechts ihre Einstellungen.
Xchange sichert jede Eingabe automatisch. Im Betrieb wirkt sie erst mit dem aktivierten Konfigurationsstand.
1. Den Ereignisauslöser anlegen
- Im Reiter Automatik der Route oben rechts Auslöser hinzufügen wählen. Der Dialog Auslösertyp wählen geht auf.
- Ereignis wählen – „Reagiert, wenn ein Datensatz angelegt oder geändert wird.“ – und mit Auswählen bestätigen.
Rechts erscheint das Formular. Links in der Liste steht der neue Eintrag als Ereignis; sobald der nächste Schritt getan ist, steht darunter der Name des Objekts, auf das er hört.
2. Sagen, worauf er reagiert
Das erste Feld des Formulars ist eine Umschaltleiste mit drei Stellungen – sie legt die Betriebsart des Auslösers fest:
- Wie Abrufendpunkt – der Auslöser hört auf dasselbe Objekt, das die Route ohnehin liest.
- Anderes Objekt – er hört auf ein anderes.
- Benutzerprozedur – eine im SAP-System hinterlegte Prozedur entscheidet.
Für „Artikel Webshop“ ist die erste Stellung die richtige: Die Route liest den Artikelstamm über den
Abrufendpunkt Items, und genau dessen Änderungen sollen sie starten.
- Die Betriebsart auf Wie Abrufendpunkt stellen.
- Bei Auslösen bei die beiden Schaltflächen Angelegt und Geändert einschalten. Eine eingeschaltete Schaltfläche ist hervorgehoben. Mindestens eine der beiden muss an sein – sonst beanstandet die Prüfung den Auslöser.

„Der Abrufendpunkt der Route löst kein SAP-Ereignis aus.“ Dann braucht diese Route eine andere Betriebsart oder einen anderen Abrufendpunkt, bevor sie sich aktivieren lässt. Stellen Sie auf Anderes Objekt um und wählen Sie ein Objekt, das die Route sinnvoll startet – der Abschnitt weiter unten beschreibt das. Oder lassen Sie die Route über einen Abrufendpunkt lesen, der ein Ereignis auslöst.
In dieser Stellung ist damit alles eingestellt: Objekt, Schlüsselfeld und Einschränkung kommen von der Route. Unter der Leiste steht der Hinweis dazu – „Der Auslöser verwendet den Datenfilter der Route. Ändern Sie ihn im Reiter ‚Quelldaten‘.“ Bei „Artikel Webshop“ ist der Datenfilter leer, also hört der Auslöser auf jede Artikeländerung im Haus.
3. Woher der Datensatz kommt
Ein SAP-Ereignis meldet nur, dass sich etwas geändert hat, und nennt dazu den Schlüssel. Den Datensatz selbst liest Xchange deshalb nach, über den Einzelabruf-Endpunkt der Route.
Bei einer Route, deren Daten in SAP Business One liegen, füllt sich dieses Feld aus dem
Abrufendpunkt und ist schreibgeschützt: Aus Items wird Items('{{ItemCode}}'). Das Feld ist
damit fertig eingerichtet. Steht die Route dagegen auf einer Anbindung, die ihre Adressen anders
ableitet, wird das Feld zum Pflichtfeld, und die Prüfung verlangt es, bevor der Stand aktiviert
werden kann.
4. Prüfen, aktivieren, freigeben
Eine Route startet erst, wenn ihr Stand aktiviert und die Automatik freigegeben ist.
- Entwurf prüfen und aktivieren – der Weg steht in Prüfen und aktivieren.
- Nach Ausführung wechseln und den Schalter in der Spalte Automatik dieser Route umlegen.
Ab jetzt startet jede Änderung am Objekt einen Lauf. Ob der erste davon sauber durchlief, sehen Sie gleich – Prüfen, ob ein Lauf sauber durchlief.
Was danach unter Zurückliegende Läufe steht
Zwei Dinge sehen anders aus als bei einer Route nach Zeitplan, und beide gehören zu dieser Bauart.
Viele kurze Läufe statt weniger langer. Am 8. Oktober zählte „Artikel Webshop“ 141 Läufe mit je einem Vorgang. Eine Tabelle, die sich den ganzen Tag über füllt, ist hier der Normalzustand.
Übersprungene Vorgänge. 33 der 141 endeten als Übersprungen (Keine Änderung). Das SAP-Ereignis feuert bei jeder Änderung am Artikel – auch bei einer, die allein Felder außerhalb der Zuordnung berührt. Dann gibt es nichts zu schreiben, und der Vorgang endet übersprungen. Der Lauf selbst steht weiter als Erfolgreich da; den übersprungenen Vorgang nennt die Spalte Vorgänge. Wollen Sie das enger fassen, tun Sie es im Datenfilter der Route oder mit der Betriebsart Anderes Objekt und eigenen Bedingungen.

Und die Nachrichtenkennung fehlt bei einem solchen Vorgang. Sie gehört zu einer Nachricht, die von außen hereinkam; hier hat ein Ereignis im eigenen Haus den Vorgang gestartet. Den Weg zum einzelnen Vorgang beschreibt Einen einzelnen Vorgang finden und nachvollziehen.
Wenn der Auslöser auf etwas anderes hören soll
Die beiden übrigen Betriebsarten sind für die Fälle da, in denen die Änderung an einem anderen Objekt zählt als dem, das die Route liest.
Anderes Objekt. Hier wählen Sie Objekt und Abruf-Schlüssel-Feld selbst, und darunter steht derselbe Bedingungsbau wie beim Datenfilter – Gruppe hinzufügen, Bedingung hinzufügen. Darüber steht der Hinweis: „Der Datenfilter der Quelldaten wirkt auf diesen Auslöser nicht. Maßgeblich sind allein die Bedingungen unten. Nehmen Sie eine Einschränkung, die auch für das Ereignis gelten soll, dort mit auf.“ Manche Felder tragen in der Auswahl den Zusatz Nur beim Abruf auswertbar – sie stehen erst beim Abruf zur Verfügung, nach dem Ereignis.
Benutzerprozedur. Objekt und Auslösen bei wählen Sie wie bei Anderes Objekt. Statt der Bedingungen tragen Sie einen Prozedurnamen ein; die Entscheidung, ob ein Ereignis die Route startet, fällt dann in dieser Prozedur. Die Schaltfläche Vorlage erzeugen gibt Ihnen das Gerüst dafür.
Die Felder beider Betriebsarten im Einzelnen stehen in Routen – Automatik.
Wie es weitergeht
Ob der erste Lauf, den ein Ereignis auslöst, sauber durchlief, zeigt Prüfen, ob ein Lauf sauber durchlief.
Siehe auch
- Den passenden Auslöser wählen (Anleitung) – Uhr, Ereignis oder von Hand
- Nach Zeitplan laufen lassen (Anleitung) – derselbe Reiter, der andere Takt
- Mit einem Datenfilter einschränken (Anleitung) – die Einschränkung, die auch für diesen Auslöser gilt
- Routen – Automatik (Referenz) – jedes Feld des Reiters im Einzelnen
- Auslösung (Grundkonzept) – Lauftypen, Auslöser und ihr Zusammenspiel