Wie mache ich es?

In der Detailsicht der Aufgaben können Sie festlegen, wann die Aufgabe ausgeführt werden soll und gegebenenfalls, welche Parameter dabei verwendet müssen. Um den Expertenmodus für die manuelle Eingabe eines Cron-Jobs zu aktivieren, müssen Sie in iX-Haus unter Systemeinstellungen Datenbank im Bereich iX-Haus plus Scheduler diese aktivieren. Danach können Sie im Scheduler-Job unter Konfiguration die manuelle Crondefinition (Expertenmodus) auswählen. Im folgenden Abschnitt finden Sie eine Erklärung und Beispiele, wie ein manueller Cron-Job angelegt werden kann.

1. Legen Sie im Scheduler eine neue Scheduleraufgabe über Neue geplante Aufgabe erstellen an. Die Aufgaben werden hier gruppiert unter Buchhaltung, Importe und Exporte oder Weitere Aufgaben angeboten. Alternativ bearbeiten Sie eine vorhandene Scheduleraufgabe mittels Doppelklick auf diese in der Übersicht.
   Bei einer neuen Aufgabe wird automatisch eine Protokollregel erstellt. Sie erhalten einen Hinweis, dass diese ggf. angepasst werden muss, z. B. um E-Mail-Empfänger zu benennen.
2. Es öffnet sich die Hauptansicht der Aufgabe mit den Registern Scheduleraufgabe, Protokollregeln und Terminvorlagen.
3. Im Register Scheduleraufgabe definieren Sie im Abschnitt Einstellungen, on die Aufgabe aktiv sein soll, ggf. geben Sie ihr auch einen individuellen Namen. Über Konfiguration definieren Sie ob die Aufgabe zu bestimmten Zeiten oder Intervallen laufen oder Teil einer Serienaufgabe sein soll.
4. Der Schalter Einmaliger Direktstart kann zur Überprüfung der Aufgabe genutzt werden. Nach spätestens 30 Sekunden wird nach Speichern der Aufgabendefinition diese dann gestartet und hierbei der Schalter wieder zurückgesetzt.
5. Die Kurznotiz nutzen Sie für individuelle Anmerkungen zu der Aufgabe. (Die nachfolgende Beschreibung liefert systemseitige Informationen zur Aufgabe).
6. Im Abschnitt Parameter werden die aufgabenspezifischen Parameter eingesetzt. Diese werden bei Neuanlage teilweise vorgeschlagen und müssen ggf. ergänzt werden.
7. Beim Speichern werden die Parameter validiert und Sie erhalten Hinweise auf fehlende Parameter.
8. Im Register Protokollregeln bearbeiten oder ergänzen Sie bestehende Protokollregeln. Als Standard werden Fehler mit Intervall 0 (also immer) protokolliert.
9. Terminvorlagen können über das gleichnamige Register zugeordnet werden.
10. Speichern Sie die Aufgabendefinition.

Sofern Sie den Expertenmodus in einer Aufgabe eingestellt haben, können Sie im Feld Intervall (manuelle Cron-Definition) eine Crondefinition eintragen. Zur besseren Lesbarkeit wird im Feld Ausführung eine textuelle Darstellung der Definition angezeigt.

Ein Cron definiert sich aus fünf durch jeweils ein Leerzeichen getrennte Bereiche. Beim Speichern wird direkt die Gültigkeit der eingegeben Crondefinition geprüft.

1. Bereich: Angabe Minute(n) (0 - 59)
2. Bereich: Angabe Stunde(n) (0 - 23)
3. Bereich: Angabe Tag(e) im Monat (1 - 31, L, W, LW)
4. Bereich: Angabe Monat(e) (1 - 12) → 1=Januar, 2=Februar, …, 12=Dezember
5. Bereich: Angabe Wochentag (0 - 6) → 0=Sonntag, 1=Montag, …, 6=Samstag

In jeden der fünf Bereiche können Sie Ziffern und Sonderzeichen eingeben. Ein Stern bedeutet ‚alle‘.

Geben Sie einen Stern im Bereich ‚Minute‘ ein, so wird die Aufgabe jede Minute ausgeführt (sofern auch in allen anderen Bereichen ein Stern steht). Die Kombination */Ziffer ergibt in dem ersten Bereich ein Minutenintervall bzw. im zweiten Bereich ein Stundenintervall. Einzelne getrennte Ausführungszeitpukte können Sie mit kommagetrennten Angaben definieren.

Mit dem Buchstaben ‚L‘ im 3. Bereich ‚Tag im Monat‘ legen Sie fest, dass die Aufgabe am letzten Tag im Monat ausgeführt wird. Ein ‚LW‘ bedeutet ‚letzter Werktag im Monat. Der Bindestrich wirkt in Kombination mit L oder LW als Rechenoperator (s. Beispiel).

Bei Wochentagen (5. Bereich) wirkt der Bindestrich als Bereichsangabe.

Der genaue Ausführungszeitpunkt der Aufgabe wird durch die Kombination aller fünf Bereiche festgelegt. Nachfolgend einige beispielhafte Cron-Definitionen.

Beachten Sie, dass Frequenzen im Allgemeinen nicht beliebig benannt werden können. Nur Schrittwerte, die ihren Bereich gleichmäßig teilen, drücken genaue Frequenzen aus (für Minuten sind das /2, /3, /4, /5, /6, /10, /12, /15, /20 und /30, da 60 gleichmäßig durch diese Zahlen teilbar ist; für Stunden sind das /2, /3, /4, /6, /8 und /12, da 24 gleichmäßig durch diese Zahlen teilbar ist). Alle anderen möglichen „Schritte“ und alle anderen Felder ergeben inkonsistente „kurze“ Zeiträume am Ende der Zeiteinheit, bevor sie auf die nächste Minute oder den nächsten Tag „zurückgesetzt“ wird; die Eingabe von */5 für das Tagesfeld führt manchmal nach 1, 2 oder 3 Tagen aus, je nach Monat und Schaltjahr. Dies liegt daran, dass Cron zustandslos ist (es merkt sich weder die Zeit der letzten Ausführung noch zählt es die Differenz zwischen dieser Zeit und jetzt, was für eine genaue Zählung der Häufigkeit erforderlich wäre.)

Ebenso ist die verfügbare Anzahl Tage oder Werktage pro Monat zu beachten. Eine Aufgabe mit Crondefinition aus 0 0 21W * * wird im Februar 2022 z. B. einen 21. Werktag nicht ermitteln können.

Die einzelne Regel definiert sich aus dem Modul, zu welchem sie angelegt wird, der Aktion sowie dem Auslöser (Aktion ausführen bei). Einzelne Regeln können deaktiviert werden. Um eine Protokollregel zu definieren, legen Sie im Register Protokollregeln eine neue Regel an, wählen Aufgabentyp und gewünschte Aktion aus und entscheiden, wann die Aktion ausgeführt werden soll:

• Immer (unabhängig von Aufgabe Ergebnis wird die ausgewählte Aktion durchgeführt)
• Erfolg (wenn Aufgabe erfolgreich war)
• Fehler (wenn Aufgabe nicht erfolgreich war)

Für jede Aufgabe im Scheduler gelten individuelle Protokollregeln. In der Vergangenheit wurden die Regeln pro Modultyp angelegt und dadurch bei allen Aufgaben alle Regeln dieses Typs verwendet. Mit dem aktuellen Stand werden die bestehenden Protokollregeln jeweils den einzelnen Aufgaben zugewiesen. Hierdurch ist es nun z. B. möglich, individuelle E-Mail-Empfänger speziell für eine bestimmte Aufgabe anzugeben. Im Register Protokollregeln werden entsprechend Name und Typ der zugehörigen Aufgabe angezeigt.

In der Übersicht sehen Sie neben diesen Parametern auch, wie die Regeln eingesetzt werden (E-Mail-Betreff, Intervall, Intervalltyp, Verantwortlich (iX-Haus Benutzer), weitere E-Mail-Empfänger, Fremdverwalter, Scheduleraufgabe-Typ und Scheduleraufgabe-Name).

1. Öffnen Sie im Modul Scheduler die Scheduleraufgabe, zu welcher Sie die Protokollregel bearbeiten wollen.
2. Wechseln Sie in das Register Protokollregeln.
3. Öffnen Sie eine bestehende Protokollregel zum Bearbeiten oder legen Sie eine neue Protokollregel an. Es öffnet sich der Dialog Aufgabe.
4. Achten Sie bei Neuanlage von Protokollregeln darauf, dass zur Scheduleraufgabe auch das sinnvolle Modul zugeordnet ist.
5. Legen Sie die Aktion fest. Wenn Sie Protokollieren und E-Mail senden wählen, müssen Sie auch einen E-Mail Betreff sowie mindestens den Verantwortlichen (iX-Hausbenutzer) angeben, welcher eine gültige E-Mailadresse in den Benutzerdaten aufweisen muss. Zudem muss iX-Haus darauf eingerichtet sein, E-Mails auch senden zu können. Die Angabe weiterer E-Mail-Empfänger ist optional.
6. Definieren Sie, wann die Aktion ausgeführt werden soll (nur bei Fehler, nur bei Erfolg oder Immer).
7. Soll die Protokollregel aktuell nicht genutzt werden, setzen Sie den Marker im Feld Deaktiviert.
8. Speichern Sie die Regel.

In der Übersicht und in der einzelnen Detailsicht zu einer Aufgabendefinition sehen Sie, wann eine Aufgabe zum letzten Mal gelaufen ist und wann der nächste Lauf geplant ist. Mittel Kontextmenü bzw. Schalter Protokolle anzeigen können Sie den Dialog Protokoll öffnen. Hier finden Sie dann eine allgemeine Übersicht der Protokolle zu der Aufgabe. Im Kontextmenü haben Sie die Möglichkeit, den Aktionsstatus über Protokoll auf Status 'Erfolg' setzen anzupassen, z. B. nach einer Fehlerbereinigung. Über Filter können Sie die angezeigten Datenmengen einschränken.

Bei Auswahl eines Verantwortlichen (iX-Haus-Benutzers) stellen Sie bitte sicher, dass bei dem Benutzer und allen Vertretungen die jeweiligen E-Mail-Adressen erfasst sind. Falls für den Verantwortlichen Vertretungen aktiv geschaltet sind (Komfortpaket), so erhält auch der Vertreter die E-Mail. Die Protokollausgabe wird in der E-Mail als Text hinzugefügt.

Es können für den Scheduler zwei globale E-Mail-Adressen für entsprechende Empfänger eingerichtet werden, an die im Fall einer Störung, z. B. wenn ein Job nicht gestartet wird oder blockiert, E-Mails zur Kontrolle gesendet werden.

Die Einrichtung erfolgt im Administrationsbereich unter Einstellungen > Globale Einstellungen > SMTP Einstellungen > Scheduler E-Mailempfänger / Weitere Scheduler E-Mailempfänger.

Bei der Eingabe eines Datums zur Ausführung einer Aufgabe per Scheduler stehen Ihnen je nach Bedarf drei Möglichkeiten zur Verfügung:

1. Variante

Festes Datum im Format TT.MM.JJJJ
Beispiel: 08.01.2021

2. Variante

Format AktDatum|Heute
Beispiel: Heute

3. Variante

Format (-)N(N).(Werktag/Kalendertag).AktDatum|Heute|VorvorMonatUltimo|VorvorMonat| VorMonatUltimo|VorMonat|ActMonatUltimo|ActMonat|AktMonatUltimo|AktMonat|FolgeMonatUltimo|FolgeMonat

Die in Klammern gesetzten Begriffe/Eingaben sind optional, d. h. das Minus vorne kann entfallen, die Tageszahl kann ein- oder zweistellig sein. Werktag oder Kalendertag ist optional, standardmäßig wird Kalendertag interpretiert.

Beispiele: