# Task-Server

Über den Task-Server können Hintergrund-Jobs automatisch durchgeführt werden, ohne das ERP-System zu überlasten.  
Meistens sind die Hintergrund-Jobs so eingerichtet, dass sie nachts laufen und somit keinen Benutzer bei der Ausführung stören.

#### Hintergrund-Jobs

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

##### Jobverlauf

Eine Liste der ausgeführten Jobs mit Ausführungs- und Endzeitpunkte, Status (läuft/erfolgreich/fehlgeschlagen), und 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.

##### Anlegen von Hintergrund-Jobs

<p class="callout info">Benutzer werden das Anlegen von Hintergund-Jobs normalerweise nicht durchführen.  
Neue Hintergrund-Jobs werden durch opendynamic per Update eingebunden.</p>

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

<table id="bkmrk-attribut-bedeutung-a" style="width: 100%;"><thead><tr><th style="width: 18.4205%;">Attribut</th><th style="width: 81.5795%;">Bedeutung</th></tr></thead><tbody><tr><td style="width: 18.4205%;">Aktiv</td><td style="width: 81.5795%;">aktivieren/deaktivieren des Jobs  
</td></tr><tr><td style="width: 18.4205%;">Ausführungsart</td><td style="width: 81.5795%;">wiederholte Ausführung plant die nächste Ausführung nach dem Beenden des Jobs</td></tr><tr><td style="width: 18.4205%;">Paketname</td><td style="width: 81.5795%;">Welcher Job soll durchgeführt werden  
</td></tr><tr><td style="width: 18.4205%;">Ausführungszeitplan</td><td style="width: 81.5795%;">Ausführungszeitplan, der den Turnus der Ausführung festlegt</td></tr><tr><td style="width: 18.4205%;">Daten</td><td style="width: 81.5795%;">Zusätzliche Daten, die vom Job benötigt werden.  
Müssen im YAML-Format angegeben werden. Abhängig vom gewählten Paket.</td></tr></tbody></table>

**YAML-Format**

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

```

Aufbau:

- Start des YAML-Dokuments mit drei `-`
- In neuer 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. 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.