Applikations-Kalender

Applikations-Kalender

• Beschreibung
• Funktionalität
• Verwandte Themen
• Technische Dokumentation

Beschreibung

Für Aufgaben, die im Hintergrund automatisch zu bestimmten Zeitpunkten ausgeführt werden sollen oder die das DV-System im laufenden Betrieb zu stark belasten würden, gibt es die Möglichkeit, Auswertungs-, Abschluss- und Druckaufgaben in einen Applikations-Kalender zu verschieben. Die Aufgaben werden dann nicht direkt ausgeführt, sondern für einen automatischen ClassiX Dienst (Server) eingeplant.

Solche automatisch abzulaufende Aufgaben werden mittels sog. Applikationskalender (auch Automationskalender genannt) und deren Ausführungsschritten verwaltet. Dabei sind grundsätzlich drei verschiedene Typen von Applikationskalendern zu unterscheiden:

• Wiederkehrende Aufgaben (Batchlauf)
• Intervall Aufgaben
• Einmalige Aufgaben

Als "wiederkehrend" wird eine Aufgabe bezeichnet, wenn die kleinste Einheit zur Wiederholung der Aufgabe "ein Tag" ist. Hierbei handelt es sich meist um sog. Nachtläufe, die täglich seitens der System Administration gestartet werden. Um so einen "Nachtlauf"-Server einzurichten, muss auf einem Client per Batch Datei eine ClassiX-Start Datei (z.B. als App Suite (*.cxp) oder direkt die App applicationScheduleExceute.app) ausgeführt werden, die zu einem bestimmten Zeitpunkt (z.B. jede Nacht als ein cron Dienst des Betriebssystems) alle anstehenden Aufgaben prüft und abarbeitet. Daher auch der Name "Batchlauf".

Ein Beispiel für eine in die Nacht verlagerte Auswertung ist die Nachkalkulation von Kundenaufträgen (es handelt sich hierbei um eine sogenannte Systemapplikation). Bei sehr großen und komplexen Aufträgen kann die laufende Nachkalkulation während des Tagesbetriebs für erhebliche Datenbank Blockaden und Wartezeiten sorgen. Ein derartiger Nachlauf wird im Mandaten aktiviert.

Um mehrere "Nacht"-Lauf Instanzen parallel auszuführen, siehe "Skalierbarkeit der Nachtläufe".

Auch Benutzer haben die Möglichkeit, sehr umfangreiche Auswertungen so einzuplanen, dass diese dann am nächsten Morgen in ihren gespeicherten Listen zu finden sind oder diese gespeicherten Listen noch in der Nacht direkt auf dem Standarddrucker des Benutzers ausgedruckt werden (es handelt sich hierbei um sogenannte Benutzerapplikationen). Jeder Benutzer kann jede Auswertung auch mehrfach mit unterschiedlichen Einstellungen einplanen. Pro Benutzer wird mit seiner spezifischen Einstellung eine eigene Benutzergruppe erstellt und der jeweiligen Benutzerapplikation zugeordnet.

Beispiele für Benutzerapplikationen:

• Supply Chain Management
• Lieferantenerklärung

Nur Benutzerapplikationen besitzen untergeordnete Benutzergruppen mit den darin enthaltenen Ausführungsschritten. Systemapplikationen enthalten direkt die Ausführungsschritte.

Sind alle diese wiederkehrenden Aufgaben abgearbeitet, beendet sich der Dienst atomatisch.

Intervall Aufgaben
Sind Aufgaben mit einem "Intervall" definiert, wird intern nach Aufruf ein sog. Zeittrigger aktiviert, der die Aufgabe gemäß des eingestellten Intervalls (z.B. 5min) periodisch aufruft. Die "Intervall" Angabe kann auch mit der Umgebungsvariable CX_APP_SCHEDULE_SNIFFER_INTERVAL gesetzt bzw. überschrieben werden.

Einmalige Aufgaben
Sind Aufgaben weder als "Wiederkehrend (Batchlauf)" oder mit einem "Intervall" definiert, gelten diese als "einmalige" Aufgaben und werden auch nur einmalig ausgeführt. Solche einmalige Aufgaben werden ebenfalls in den sog. Nachtläufen abgearbeitet oder können direkt manuell gestartet werden.

Ausführung als Webservice

Der Applikationskalender kann als MorphIT-Instanz ausgeführt werden.

'static': {
        'request_timeout': 300*1000,
        "webservice": {
            'enabled': true,
            'registration_webservice': false,
            "instances": [
                {
                    'id': 'app_schedule', // To recognize the instance in the admin console
                    "registration_webservice": "EXECUTE_APPLICATION_SCHEDULE?USERID=cx&PASSWORD=cx",
                    'launch': {
                        // Define start command for this webservice instance (first set dlls, then call start batch)
                        'cmd': 'Y:\\classix\\Pythia\\projects\\Pythia\\Pythia.bat',
                        'config': {
                            'env':{  // Custom environment variables
                                'CX_DISABLE_LOGIN_SID':'TRUE', //Set CX_DISABLE_LOGIN_SID for start batch
                                'CX_APP_SCHEDULE_SNIFFER_INTERVAL':'60min', //Set CX_APP_SCHEDULE_SNIFFER_INTERVAL for start batch
                                
                            }
                        }
                    }
                }
            ]
        }
    }

'static': {
        'request_timeout': 300*1000,
        "webservice": {
            'enabled': true,
            'registration_webservice': false,
            "instances": [
                {
                    'id': 'app_schedule', // To recognize the instance in the admin console
                    "registration_webservice": "EXECUTE_APPLICATION_SCHEDULE",
                    'launch': {
                        // Define start command for this webservice instance (first set dlls, then call start batch)
                        'cmd': 'Y:\\classix\\Pythia\\projects\\Pythia\\Pythia.bat',
                        'config': {
                            'env':{  // Custom environment variables
                                'CX_DISABLE_LOGIN_SID':'FALSE', //Set CX_DISABLE_LOGIN_SID for start batch
                                'CX_USER':'cx', //Set CX_USER for start batch
                                'CX_APP_SCHEDULE_SNIFFER_INTERVAL':'60min', //Set CX_APP_SCHEDULE_SNIFFER_INTERVAL for start batch
                                
                            }
                        }
                    }
                }
            ]
        }
    }

Für die oben beschriebene Funktionalität muss am Benutzer cx die SID des Benutzerkontos der MorphIT-Dienste in der Datenbank hinterlegt. Entsprechend muss das Benutzerkonto bei den Diensten manuell hinterlegt werden oder alternativ dafür gesorgt werden, dass der Benutzer der hinterlegten SID immer am Rechner angemeldet ist.
Eine automatische Anmeldung durch zusätzliche Angabe des Passworts als Variable ist nicht möglich, bitte verwenden Sie dafür die Cloudconfig weiter oben.

Funktionalität

• Eingabefenster
• Listenfenster
• Positionsfenster
   
• Anstehende Applikations-Kalendereinträge
   
• Ausführung
• Protokolleintrag
   
• Webservice
   

Eingabefenster

Diese App dient der Pflege von Applikations-Kalender(einträgen).

Toolbar

Symbol	Beschreibung
	Neue(n) Applikations-Kalender(eintrag) anlegen
	Änderungen speichern
	Applikations-Kalender(eintrag) löschen
	Applikations-Kalender(eintrag) drucken
	Notizen anlegen/bearbeiten

"\"PYTHIA Abgleich\""

({ "PYTHIA Abgleich" }) Execute

({
   LocalVar(appStep) -> appStep
   appStep Copy(last.transaction.new.counter) Integer appStep Copy(last.transaction.risk.counter) Integer appStep Copy(last.transaction.changed.counter) Integer
   "Pythia: %i neue Treffer, %i geänderte Whitelist-Einträge, %i geänderte Blacklist Einträge" String(STACK)
}) Execute

Liste

Diese App dient der Auflistung aller Applikations-Kalender(einträge).

Toolbar

Symbol	Beschreibung
	Liste leeren
	Neuen Applikations-Kalender(eintrag) anlegen
	Applikations-Kalender(eintrag)  bearbeiten
	Applikations-Kalender(eintrag)  löschen
	Notizen anlegen/bearbeiten
	Beleghistorie
	Kopieren in Zwichenablage

Positionsfenster

Diese App dient der Bearbeitung eines Applikations-Kalender(eintrags), ob Gruppe oder einzelne Ausführung.

Ausführung

Es gibt eine zentrale App (applicationScheduleExecute.app), mit der alle anstehenden Applikationskalender ausgeführt werden. Diese App kann entweder direkt gestartet werden (z.B. für Nachtläufe) oder in einer App Suite mittels der Message EXECUTE_APPLICATION_SCHEDULE eingebunden werden.

Hierbei wird pro Intervall Applikationskalender ein eigener Time Trigger gesetzt (siehe applicationScheduleTriggeredStart.app), alle anderen wiederkehrende oder einmalige Applikationskalender werden ebenfalls ausgeführt. Sollten laufend neue Applikationskalender ins System kommen (z.B. durch eine API), kann man einen Applikationskalender Sniffer starten (siehe cxApplicationSchedule::StartApplicationScheduleSniffer), der in vorgegebenen Zeitintervallen nach neuen Applikationskalendern sucht und diese - falls an der Reihe - zur Ausführung bringt.

Wurde eine Aufgabe ausgeführt, so wird entweder sie selbst, oder bei wiederholbaren bzw. System-Aufgaben eine Kopie dieser in das Protokoll der Applikationen verschoben.

Sollten bei Abarbeitung einer Aufgabe Warn- oder Fehlermeldungen aufkommen, werden diese unterdrückt und in nach Monaten getrennte Dateien im Verzeichnis ...\System\SystemOut\AppScheduleLog\YYYY-MM\xxxx.log geschrieben. Andere, nocht nicht ausgeführte Aufgaben werden dann aber weiterhin zur Ausführung gebracht.

Skalierbarkeit der Nachtläufe

Da für die Nachtläufe im Regelfall nur ein kurzes Zeitfenster zur Verfügung steht, gibt es die Möglichkeit, mehrere Nachtlaufinstanzen zu starten und sie einer Kategorie zuzuweisen. Die einzelnen Nachtläufe führen dann nur die Aufgaben aus, die ihrer Kategorie zugeordnet sind. Hierbei sollte eine Hauptinstanz, z.B. Kategorie A definiert werden, welche dann kurze Zeit vor den weiteren Instanzen ausgeführt wird, damit sie vorlaufende Systemaufgaben abschließen kann (Statistikperioden starten, neueste Währungstabelle importieren), die die weiteren Instanzen später mitbenutzen werden.

Jeder Applikation kann also eine Kategorie zugeordnet werden. Darüber hinaus kann jeder Applikation eine Kennzahl für die Reihenfolge gegeben werden. Bei der Ausführung der Nachtläufe werden alle Anwendungen nach der Reihenfolge aufsteigend sortiert. Die Aufgabe mit der höchsten Priorität hat also die niedrigste Zahl.

Die Kategorie der Instanz wird mittels Umgebungsvariable CX_BATCH_ID zugewiesen. Diese kann  vor dem Aufruf des Systems mit dem Kommando "SET CX_BATCH_ID=A" oder über die Systemumgebungsvariablen gesetzt werden!
 

Webservice

Applikationskalender können auch mit der POST-Message EXECUTE_APPLICATION_SCHEDULE?USERID=myUserID&PASSWORD=myPassword&BATCHID=A über einen Webservice gestartet werden.
 

Protokolleintrag

Mit dieser App können die Protokolleinträge zum Protokoll von jedem ausgeführten Schritt eingesehen werden.

Anstehende Applikations-Kalendereinträge

Diese App dient der Auflistung der - in nächster Zukunft - auszuführenden Applikations-Kalendereinträge. Hier kann z.B. kontrolliert werden, was heute gestartet werden wird. Auch die Termine von wiederkehrenden Applikationen werden errechnet und berücksichtigt.

Der Benutzer kann als Filter eingestellt werden. In der Benutzerliste werden nur die Benutzer angezeigt, für die fällige Applikationen geplant sind. Wird kein Benutzer eingetragen, werden die offenen Aufgaben aller Benutzer angezeigt.

Über das Datumsfeld und das Feld für die Uhrzeit können die anstehenden Aufgaben näher eingegrenzt werden.

Verwandte Themen

• Index

Technische Dokumentation

• Implementation
• Qualitätssicherung
• Basismodul
  • Editiermodul
  • Selektionsmodul
     

Applikations-Kalender Modul

Modulname

appsched.mod - appscedt.mod - appscsel.mod - appscprn.mod

Klassen

CX_APPLICATION_SCHEDULE

CX_COMPOUND_TXN

CX_TRANSACTION

Security

Neben der Beschränkung der Zugriffsrechte über die Klasse und deren Datenfelder kann das Modul über einige der empfangenen Messages in seiner Nutzung beschränkt werden.