Hintergrund-Jobs Anlegen

Infos zu Hintergrund-Jobs

Hintergrund-Jobs werden nicht durch den "normalen" ERP-Prozess ausgeführt, sondern durch einen "Task-Server". Das erlaubt es, aufwendige Vorgänge durchzuführen, ohne den ERP-Server zu überlasten.

Jobs können in zwei Arten aufgeteilt werden: geplant und ausgelöst. Geplante Jobs werden bei ihrer Erstellung mit einem Cronjob Ausführungszeitplan versehen und nach diesem ausgeführt. Ausgelöste Jobs werden durch einen Benutzer aktiviert und lagern aufwendige Vorgänge aus, z.B. der Massendruck von ERP-Dokumenten. Es können nur geplante Jobs angelegt werden.

Anlegen von Hintergrund-Jobs

Unter System->Hintergrund-Jobs und Task-Server->Aktuelle Hintergrund-Jobs anzeigen, können alle zur Zeit angelegten Hintergrund-Jobs und ihre Optionen eingesehen werden. Hier kann auch über "Erfassen" ein neuer Job angelegt werden.

Attribut	Bedeutung
Aktiv	Ob der Job am nächsten Ausführungszeitpunkt ausgeführt wird
Ausführungsart	wiederholte Ausführung plant die nächste Ausführung nach dem Beenden des Jobs
Paketname	Welcher Code vom Job ausgeführt wird
Ausführungszeitplan	Cronjob Ausführungszeitplan, der den Ausführ-Turnus festlegt
Daten	Zusätzliche Daten, die vom Job benötigt werden. Müssen im YAML-Format angegeben werden. Abhängig vom gewählten Paket.

YAML-Format

---
test_key: 123456789
test_customer: 
  name: Musterfirma 1
  city: 99999 Musterhausen
test_attributes: [attr1, attr2, attr3]

Zunächst wird der start des YAML-Dokuments mit drei - gesetzt. Dann in neue Zeilen Benennung und Wert von Variablen. WICHTIG: Hier muss zwischen Benennung und Wert ein Doppelpunkt und ein Leerzeichen gesetzt werden. String-Werte müssen nicht in Anführungszeichen gesetzt werden. Unter-Attribute werden über Einrückung markiert (wie python). Listen werden mit eckigen Klammern markiert. Sollte ein Paket Daten verwenden und diese nicht im korrekten Format angegeben werden, schlägt die Ausführung fehl.

Jobverlauf

Eine Liste der Ausführungs- und Endzeitpunkte, Status (läuft/erfolgreich/fehlgeschlagen), das Paket und die verwendeten Daten. Ergebnis enthält die Werte, die bei einer erfolgreichen Ausführung durch das Paket zurückgegeben werden, Fehler enthält die Fehlermeldung, falls die Ausführung nicht möglich ist.