Routen – Automatik
Der Reiter Automatik einer Route trägt ihre Auslöser – die Einstellungen, die bestimmen, wann die Route von selbst läuft. Ohne Auslöser läuft die Route nur, wenn jemand sie auf der Ausführung von Hand startet.
Welcher Auslöser wofür taugt, steht unter Auslösung.
Berechtigungen
Der Reiter gehört zur Route und folgt deshalb der Berechtigung Routen:
| Stufe auf Routen | Was Sie auf dem Reiter können |
|---|---|
| Keine | der Menüpunkt Routen fehlt, und mit ihm dieser Reiter |
| Nur lesen | alle Auslöser und alle ihre Felder ansehen; die Felder sind ausgegraut |
| Voll | Auslöser hinzufügen, ändern und löschen |
Die Berechtigung Automatik gehört zu einem anderen Bildschirm, so ähnlich die beiden Wörter klingen. Sie erlaubt, die Automatik einer Route im laufenden Betrieb zu pausieren und wieder aufzunehmen – das passiert auf der Ausführung.
Im Beispiel: A. Vogt hat auf Routen die Stufe Voll und richtet die Auslöser ein. M. Brandt hat Nur lesen – Brandt sieht dieselben Auslöser, alle Felder nur zum Lesen.

Aufbau
Der Reiter besteht aus zwei nebeneinanderliegenden Bereichen.
| Bereich | Inhalt |
|---|---|
| Auslöser (links) | die Liste aller Auslöser dieser Route, je Zeile Typ und eine Kurzfassung der Einstellung – z. B. Zeitgesteuert mit Täglich 02:00. Ein Warnzeichen neben dem Namen zeigt einen Befund an diesem Auslöser, Tooltip Dieser Auslöser hat Validierungsprobleme. Darüber die Schaltfläche Auslöser hinzufügen. |
| Detail (rechts) | alle Felder des in der Liste gewählten Auslösers, und in der Kopfzeile Auslöser löschen. |
Hat die Route noch keinen Auslöser, steht rechts Noch keine Auslöser mit dem Hinweis „Fügen Sie Ihren ersten Auslöser hinzu – er bestimmt, wann die Route automatisch ausgeführt wird.“
Eine Route kann mehrere Auslöser tragen. „Artikel Cambira Austria“ hat zwei: den täglichen Lauf um 02:00 und den wöchentlichen Vollauf am Sonntag um 03:00.
Auslöser löschen fragt nach: „Der Auslöser ‚…‘ wird gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.“ Bestätigt wird mit Löschen.
Einen Auslöser hinzufügen
Auslöser hinzufügen öffnet Auslösertyp wählen. Zur Wahl stehen:
| Typ | Beschreibung im Dialog | Wann angeboten |
|---|---|---|
| Zeitgesteuert | Startet die Route nach einem festen Zeitplan. | immer |
| Ereignis | Reagiert, wenn ein Datensatz angelegt oder geändert wird. | nur bei Richtung Export oder Intern |
Auswählen legt den Auslöser an und öffnet ihn rechts.
Zwei weitere Typen entstehen auf anderem Weg. Verteilungseingang entsteht von selbst, sobald eine Verteilungsroute diese Route als Ziel führt (unten). Manuell ist der Zustand ohne Auslöser: Eine Route, die nur von Hand laufen soll, hat eine leere Liste.
Trägt die Route einen Verteilungseingang, fehlt Auslöser hinzufügen: Der Verteilungseingang bleibt ihr einziger Auslöser.
Zeitgesteuert
Modus
Ein Umschalter mit zwei Stellungen, Einfach und Erweitert. Einfach führt zum geführten Formular, Erweitert zum Cron-Ausdruck. Alles, was das geführte Formular einstellen kann, lässt sich auch als Ausdruck schreiben; der Ausdruck reicht weiter. In beiden Modi stehen unter dem Zeitplan die nächsten Ausführungen.
Einfacher Modus
| Feld | Bedeutung | Erscheint bei |
|---|---|---|
| Häufigkeit | Alle N Minuten, Alle N Stunden, Täglich, Wöchentlich, Monatlich | immer |
| Intervall | das N – wie viele Minuten oder Stunden zwischen zwei Läufen liegen | Alle N Minuten, Alle N Stunden |
| Wochentage | Mo bis So, mindestens einer | Wöchentlich |
| Tag im Monat | 1 bis 31 oder Letzter Tag | Monatlich |
| Uhrzeit | Stunde und Minute, Format HH:mm | Täglich, Wöchentlich, Monatlich |
Das Intervall ist eine Auswahl aus festen Werten:
| Häufigkeit | Angebotene Intervalle |
|---|---|
| Alle N Minuten | 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30 |
| Alle N Stunden | 1, 2, 3, 4, 6, 8, 12 |
Bei Tag im Monat 29, 30 oder 31 erscheint der Hinweis „Monate ohne diesen Tag werden übersprungen – für das Monatsende ‚Letzter Tag‘ wählen.“ Der Lauf entfällt in einem solchen Monat also ganz, statt auf den nächstmöglichen Tag zu rücken.
Erweiterter Modus
Ein Feld Cron-Ausdruck, Beispiel 0 6 * * *. Ein unlesbarer Ausdruck färbt das Feld rot, ein
leeres Feld ebenso.
Auch ein Ausdruck jenseits des geführten Formulars – etwa mehrere Uhrzeiten am Tag – ist erlaubt. Dann steht über dem Feld: „Ausdruck ist zu komplex für den einfachen Modus – beim Wechsel zurück zum einfachen Modus wird der Ausdruck zurückgesetzt.“ Der Wechsel setzt ihn tatsächlich zurück und meldet es kurz: „Erweiterter Ausdruck verworfen – nicht in den einfachen Modus übertragbar“.
Nächste Ausführungen
Zwischen dem Zeitplan und dem Lauftyp stehen in beiden Modi die nächsten Zeitpunkte, zu denen dieser Auslöser fällig wird. An ihnen lässt sich ablesen, ob der Zeitplan trifft, was gemeint war – besonders bei einem Cron-Ausdruck.
Die Zeiten sind Serverzeit, unabhängig von der Zeitzone Ihres Arbeitsplatzes.
Statt der Liste kann dort stehen:
| Meldung | Bedeutung |
|---|---|
| Ungültiger Ausdruck | der Cron-Ausdruck ist unlesbar |
| Vorschau derzeit nicht verfügbar | die Berechnung der Vorschau ist fehlgeschlagen; die Einstellung selbst bleibt davon unberührt |
Lauftyp
Was ein Lauf dieses Auslösers mitnimmt. Welche Lauftypen angeboten werden, entscheidet die Datenherkunft der Route – gewählt beim Anlegen der Route:
| Datenherkunft | Angebotene Lauftypen |
|---|---|
| Datenbestand | Vollständig, Inkrementell |
| Warteschlange | Warteschlange leeren |
| Verteilungseingang | keine – eine so belieferte Route hat keinen Lauftyp |
Ein neu angelegter zeitgesteuerter Auslöser steht auf Inkrementell, wo es diesen Typ gibt, sonst auf dem einzigen angebotenen.
Im Beispiel: „Artikel Cambira Austria“ liest einen Datenbestand und läuft täglich Inkrementell, sonntags Vollständig. Die Verteilungsroute „Statusmeldungen Kessler“ liest eine Warteschlange und läuft alle 10 Minuten mit Warteschlange leeren.
Blättert eine REST-Anbindung über Seitennummer oder Versatz und steht ihr Änderungen erkennen nicht auf Quelle liefert Änderungs-Token, braucht Inkrementell eine Sortierung. Fehlt sie, meldet die Prüfung am Lauftyp „Anbindung ist nicht für sortiertes Lesen eingerichtet“. Behoben wird es an der Anbindung, unter Sammelabruf.
Steht der Lauftyp auf Vollständig und die Häufigkeit auf Alle N Minuten, erscheint der Hinweis: „Ein vollständiger Lauf überträgt jedes Mal alle Daten. In so kurzen Abständen ist das meist unnötig – ‚Inkrementell‘ überträgt nur Änderungen.“ Die Einstellung bleibt trotzdem zulässig.
Datensätze pro Zyklus
Nur beim Lauftyp Warteschlange leeren. Die Obergrenze, wie viele Nachrichten ein Lauf abarbeitet, bevor er endet; der nächste Lauf macht weiter. Leer heißt unbegrenzt. Liefert ein Abruf mehrere Nachrichten, zählt jede einzeln; was nach Erreichen der Grenze in der Liste übrig ist, bleibt unquittiert und kommt beim nächsten Lauf wieder.
Bereinigung
Ein Kontrollkästchen Nicht mehr gelieferte Datensätze melden. Es erscheint nur, wenn beides zutrifft:
- der Lauftyp dieses Auslösers ist Vollständig, und
- im Reiter Verhalten steht unter Löschverhalten die Strategie Im Zielsystem deaktivieren.
Ist es eingeschaltet, meldet Xchange nach dem Lauf jeden Datensatz an das Zielsystem, den die Route früher übertragen hat und den dieser Lauf nicht mehr geliefert hat – weil er aus dem Datenfilter gefallen oder in der Quelle gelöscht ist. Was dort mit ihm geschieht, sagt das Löschverhalten der Route.
Im Beispiel: Am sonntäglichen Vollauf von „Artikel Cambira Austria“ ist die Bereinigung eingeschaltet; am täglichen inkrementellen Lauf fehlt das Kontrollkästchen ganz.
Eine Bereinigung, die ungewöhnlich viele Datensätze melden würde, hält Xchange an und wartet auf eine Entscheidung; das steht auf der Ausführung.
Ereignis
Ein Ereignisauslöser reagiert darauf, dass in SAP Business One ein Datensatz angelegt oder geändert wurde. Es gibt ihn nur an Routen der Richtung Export oder Intern – dort, wo die Route aus SAP Business One liest.

Auslöser
Ein Umschalter Auslöser mit drei Stellungen. Er entscheidet, worauf gehorcht wird – und damit auch, welche Felder darunter überhaupt erscheinen:
| Stellung | Bedeutung | Passt, wenn … |
|---|---|---|
| Wie Abrufendpunkt | horcht auf dasselbe Objekt, aus dem die Route liest, und übernimmt den Datenfilter der Route | die Route genau die Datensätze weitergeben soll, die sich geändert haben – „Artikel Webshop“ horcht so auf Artikel |
| Anderes Objekt | horcht auf ein anderes Objekt als das der Quelldaten | die Änderung an einem anderen Objekt sichtbar wird als an dem, das die Route liest – z. B. am Lagerbestand eines Artikels |
| Benutzerprozedur | horcht auf ein Objekt Ihrer Wahl; statt Feldbedingungen entscheidet eine eigene Datenbankprozedur, was ein Auslösen ist | Feldbedingungen nicht ausdrücken können, was zählt – z. B. nur die Änderung eines bestimmten Felds |
Wie Abrufendpunkt setzt voraus, dass der Abrufendpunkt der Route auf ein Objekt zeigt, das Ereignisse auslöst. Tut er das nicht, steht direkt unter dem Umschalter der Fehler „Der Abrufendpunkt der Route löst kein SAP-Ereignis aus. Wählen Sie ein anderes Objekt für den Auslöser oder rufen Sie über einen Endpunkt ab, der eines auslöst.“ Solange er steht, ist die Aktivierung gesperrt.
Die Felder darunter je Stellung:
| Feld | Wie Abrufendpunkt | Anderes Objekt | Benutzerprozedur |
|---|---|---|---|
| Auslösen bei | ja | ja | ja |
| Objekt | – | ja | ja |
| Abruf-Schlüssel-Feld | – | ja, siehe unten | ja, siehe unten |
| Feldbedingungen | – | ja | – |
| Prozedurname | – | – | ja |
Feldbedingungen gibt es also ausschließlich bei Anderes Objekt. Bei Wie Abrufendpunkt gilt stattdessen der Datenfilter der Route; der Hinweis dort sagt es: „Der Auslöser verwendet den Datenfilter der Route. Ändern Sie ihn im Reiter ‚Quelldaten‘.“
Im Beispiel: „Artikel Webshop“ steht auf Wie Abrufendpunkt mit Angelegt und Geändert, ohne eigenes Objekt und ohne Bedingungen. Weil auch die Route keinen Datenfilter trägt, sieht der Auslöser jede Änderung an einem Artikel, rund 140 am Tag.
Umgekehrt gilt bei Anderes Objekt: Maßgeblich sind allein die Feldbedingungen; der Datenfilter der Quelldaten bleibt für diesen Auslöser außen vor. Trägt die Route einen Datenfilter, sagt es der Hinweis unter dem Umschalter: „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.“ Ohne Datenfilter fehlt der Hinweis.
Benutzerprozedur wählt Objekt und Auslösen bei genauso wie Anderes Objekt. Nur an die Stelle der Feldbedingungen tritt der Prozedurname.
Auslösen bei
Zwei Schalter, Angelegt und Geändert, einzeln oder beide. Mindestens einer muss an sein.
Objekt
Das SAP-Business-One-Objekt, auf dessen Änderungen gehorcht wird – z. B. Artikel. Nur bei Anderes Objekt und Benutzerprozedur.
Abruf-Schlüssel-Feld
Das Feld des gewählten Objekts, aus dem der Schlüssel des abzurufenden Datensatzes kommt. Es erscheint nur, wenn das horchende Objekt ein anderes ist als das der Quelldaten – horcht der Auslöser auf dasselbe Objekt, das die Route liest, ist der Schlüssel schon bekannt.
Beispiel: Die Route liest Artikel, gehorcht aber auf Lagerbestände. Dann sagt dieses Feld, welches Feld des Lagerbestands die Artikelnummer trägt.
Prozedurname
Nur bei Benutzerprozedur: der Name einer gespeicherten Prozedur in der Datenbank, höchstens 200 Zeichen. Gibt es keine mit diesem Namen, steht darunter „Keine gespeicherte Prozedur mit diesem Namen gefunden“.
Vorlage erzeugen öffnet ein Fenster mit einem Gerüst zum Kopieren, im Reiter Gerüst. Führt das Objekt in SAP Business One eine Änderungshistorie, kommt der Reiter Feldänderung dazu – ein Gerüst, das zusätzlich die geänderten Felder auswertet.
Feldbedingungen
Nur bei Anderes Objekt. Die Bedingungen, die ein geänderter Datensatz erfüllen muss, damit der Auslöser greift.
Sie sind in Gruppen geordnet:
| Element | Bedeutung |
|---|---|
| Verknüpfung der Gruppen | UND oder ODER – gilt einmal für alle Gruppen zusammen, für jeden Übergang gleich |
| Gruppe 1, Gruppe 2, … | je Gruppe eine eigene Verknüpfung, wieder UND oder ODER, für die Bedingungen innerhalb dieser Gruppe |
| Bedingung hinzufügen | eine Zeile in dieser Gruppe |
| Gruppe hinzufügen / Gruppe entfernen | eine Gruppe mehr oder weniger |
Die Feldbedingungen fassen bis zu 6 Gruppen mit je bis zu 5 Bedingungen. Ist eine Grenze erreicht, endet dort das Hinzufügen, und der Editor nennt die Grenze, etwa Höchstens 5 Bedingungen je Gruppe.
Jede Bedingung ist eine Zeile aus Feld, Operator und Wert.
| Operatoren | |
|---|---|
| Vergleich | ist gleich, ist ungleich, ist größer als, ist größer oder gleich, ist kleiner als, ist kleiner oder gleich |
| Mengen | ist eines von, ist keines von |
| Text | enthält, enthält nicht, beginnt mit, beginnt nicht mit |
| Belegung | ist leer, ist nicht leer |
Welche Operatoren eine Zeile anbietet, hängt vom gewählten Feld ab – ein Datumsfeld bietet andere als ein Textfeld. Die Aufteilung nach Feldtyp ist dieselbe wie im Datenfilter, siehe Routen – Quelldaten. Bei ist leer und ist nicht leer entfällt die Spalte Wert. Die Werteliste von ist eines von und ist keines von fasst bis zu 20 Werte.
Bis ein Objekt gewählt ist, sagt die Feldauswahl Objekt wählen. Felder, die erst der Abruf liefert, tragen die Markierung Nur beim Abruf auswertbar – sie gehören in den Datenfilter der Quelldaten.
Ohne Bedingungen steht dort Noch keine Bedingung.; der Auslöser greift dann bei jeder Änderung des Objekts. Bedingung entfernen und Gruppe entfernen fragen vorher nach; eine Bedingung ohne Feld und ohne Wert verschwindet ohne Nachfrage.
Eine Route, die sich selbst auslöst
Eine interne Route kann sich selbst auslösen. Horcht ihr Ereignis mit Angelegt auf das Objekt, das ihr Hauptschritt anlegt, löst jeder neue Datensatz die Route erneut aus. Die Route meldet das als Warnung, z. B. „Route legt ‚DeliveryNotes‘ selbst an und kann sich damit erneut auslösen – Ereignis mit einer Bedingung eingrenzen, die die angelegten Datensätze nicht erfüllen“.
Die Warnung bleibt auch mit Feldbedingungen stehen, denn ob die angelegten Datensätze sie verfehlen, lässt sich vorab nicht prüfen. Ein Schritt, der nur aktualisiert, löst sie nicht aus.
Verteilungseingang
Diesen Auslöser legt Xchange an – er steht in der Liste, sobald eine Verteilungsroute diese Route als Ziel einer ihrer Regeln führt. Hier ist er vor dem Löschen geschützt, und er bleibt der einzige Auslöser der Route.
Das Detail zeigt einen von drei Zuständen:
| Zustand | Anzeige |
|---|---|
| Zugeordnet | „Wird von Verteilungsroute ‚…‘ beliefert“ und der Link Verteilungsroute öffnen |
| Ohne Zuordnung, mit möglichen Absendern | der Hinweis, dass noch keine Zuordnung besteht, und darunter die Liste Verteilungsrouten mit derselben Anbindung zur Auswahl |
| Ohne Zuordnung, ohne mögliche Absender | derselbe Hinweis und der Link Verteilungsroute anlegen |
Im zweiten und dritten Zustand ist die Route noch nicht fertig eingerichtet: Eine Route mit Datenherkunft Verteilungseingang bekommt erst etwas zu tun, wenn eine Verteilungsroute sie beliefert.
Im Beispiel: „Abholung Kessler“ wird von der Verteilungsroute „Statusmeldungen Kessler“
beliefert – deren erste Regel gibt jede Nachricht mit status = picked dorthin.
Welche Regel welche Nachricht wohin gibt, steht im Reiter Verteilung der Verteilungsroute.
Was noch gilt
- Eine Änderung hier wirkt erst nach der Aktivierung. Sie steht im Entwurf und greift im Betrieb erst mit dem aktivierten Konfigurationsstand – siehe Prüfen und aktivieren.
- Ob die Route läuft, entscheidet die Ausführung. Eine pausierte Route bleibt stehen, auch wenn ihr Zeitplan fällig wird. Pausieren und Fortsetzen passiert auf der Ausführung.
- Was übertragen wird, sagt der Datenfilter im Reiter Quelldaten. Der Lauftyp sagt nur, wie viel davon jedes Mal mitkommt.
- Der Lauftyp Warteschlange leeren verträgt nur einen Auslöser. Eine Route, die aus einer Warteschlange liest, hat genau einen.
Siehe auch
- Nur Geändertes übertragen (Anleitung) – einen vollen Lauf auf Änderungen umstellen und den Vollauf daneben behalten
- Routen – Quelldaten (Referenz) – Datenquelle und Datenfilter, von denen mehrere Felder dieser Seite abhängen
- Routen – Verteilung (Referenz) – die Regeln, die einen Verteilungseingang beliefern
- Routen – Verhalten (Referenz) – das Löschverhalten, an dem die Bereinigung hängt
- Ausführung (Referenz) – pausieren, von Hand starten, eine angehaltene Bereinigung freigeben
- Auslösung (Grundkonzept) – welcher Weg wofür taugt