Zum Hauptinhalt springen

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 RoutenWas Sie auf dem Reiter können
Keineder Menüpunkt Routen fehlt, und mit ihm dieser Reiter
Nur lesenalle Auslöser und alle ihre Felder ansehen; die Felder sind ausgegraut
VollAuslö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.

Der Reiter Automatik mit der Auslöserliste links und dem gewählten wöchentlichen Auslöser rechts.

Aufbau​

Der Reiter besteht aus zwei nebeneinanderliegenden Bereichen.

BereichInhalt
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:

TypBeschreibung im DialogWann angeboten
ZeitgesteuertStartet die Route nach einem festen Zeitplan.immer
EreignisReagiert, 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​

FeldBedeutungErscheint bei
HäufigkeitAlle N Minuten, Alle N Stunden, Täglich, Wöchentlich, Monatlichimmer
Intervalldas N – wie viele Minuten oder Stunden zwischen zwei Läufen liegenAlle N Minuten, Alle N Stunden
WochentageMo bis So, mindestens einerWöchentlich
Tag im Monat1 bis 31 oder Letzter TagMonatlich
UhrzeitStunde und Minute, Format HH:mmTäglich, Wöchentlich, Monatlich

Das Intervall ist eine Auswahl aus festen Werten:

HäufigkeitAngebotene Intervalle
Alle N Minuten1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30
Alle N Stunden1, 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:

MeldungBedeutung
Ungültiger Ausdruckder Cron-Ausdruck ist unlesbar
Vorschau derzeit nicht verfügbardie 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:

DatenherkunftAngebotene Lauftypen
DatenbestandVollständig, Inkrementell
WarteschlangeWarteschlange leeren
Verteilungseingangkeine – 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.

Der Ereignisauslöser von „Artikel Webshop“: Auslöser auf Wie Abrufendpunkt, Auslösen bei Angelegt und Geändert, darunter der Hinweis auf den Datenfilter der Route.

Auslöser​

Ein Umschalter Auslöser mit drei Stellungen. Er entscheidet, worauf gehorcht wird – und damit auch, welche Felder darunter überhaupt erscheinen:

StellungBedeutungPasst, wenn …
Wie Abrufendpunkthorcht auf dasselbe Objekt, aus dem die Route liest, und übernimmt den Datenfilter der Routedie Route genau die Datensätze weitergeben soll, die sich geändert haben – „Artikel Webshop“ horcht so auf Artikel
Anderes Objekthorcht auf ein anderes Objekt als das der Quelldatendie Änderung an einem anderen Objekt sichtbar wird als an dem, das die Route liest – z. B. am Lagerbestand eines Artikels
Benutzerprozedurhorcht auf ein Objekt Ihrer Wahl; statt Feldbedingungen entscheidet eine eigene Datenbankprozedur, was ein Auslösen istFeldbedingungen 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:

FeldWie AbrufendpunktAnderes ObjektBenutzerprozedur
Auslösen beijajaja
Objekt–jaja
Abruf-Schlüssel-Feld–ja, siehe untenja, 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:

ElementBedeutung
Verknüpfung der GruppenUND 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ügeneine Zeile in dieser Gruppe
Gruppe hinzufügen / Gruppe entferneneine 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
Vergleichist gleich, ist ungleich, ist größer als, ist größer oder gleich, ist kleiner als, ist kleiner oder gleich
Mengenist eines von, ist keines von
Textenthält, enthält nicht, beginnt mit, beginnt nicht mit
Belegungist 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:

ZustandAnzeige
Zugeordnet„Wird von Verteilungsroute ‚…‘ beliefert“ und der Link Verteilungsroute öffnen
Ohne Zuordnung, mit möglichen Absendernder Hinweis, dass noch keine Zuordnung besteht, und darunter die Liste Verteilungsrouten mit derselben Anbindung zur Auswahl
Ohne Zuordnung, ohne mögliche Absenderderselbe 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​