Vergleichsreport

Die einzigen Aktionen, die bei solchen Systembenachrichtigungen in der Workflow-Liste "Offene Aufgaben" zur Verfügung stehen, sind:

Eine detaillierte Beschreibung zu den allgemeinen Job-Parametern finden Sie im Kapitel Jobs.

Neue Jobkonfiguration

Um eine neue Konfiguration anzulegen klickt man auf die Schaltfläche "Neue Konfiguration", befüllt die vorgegebenen Felder mit Neuem Job-Namen, wählt, ob der Job aktiv oder nicht-aktiv sein soll. Durch anschließendes speichern kann man weitere Konfigurationsdetails editieren:

Mögliche Velocity-Parameter (Platzhalter für tatsächliche Werte):

Parameter

Beschreibung

Typ

Datum der Systemunregelmäßigkeit

String

year 

Jahr der Systemunregelmäßigkeit

String

month

Monat der Systemunregelmäßigkeit

String

day

Tag im Monat der Systemunregelmäßigkeit

String

appCtx

Spring ApplicationContext (ermöglicht Zugriff auf Services)

Object

eventDate

Datum der Unregelmäßigkeit als Datumsobjekt

Date

ta_id

Ta-ID der Person, für welche die Unregelmäßigkeit eingetreten ist

String

person

PoPerson object der betroffenen Person

PoPerson

Beispiele für Velocity Ausdrücke

#set ($ta_service = $appCtx.getBean("Ta") )
#set ($jvalue = $ta_service.getAccountValue($ta_id, $eventDate, "vkkonto") )
Saldokappung für $person.getFullName() vom $fromdate Stunden $jvalue.getNumValueAsIm()

Wichtiger Tipp zu Velocity: Man kann grundsätzlich über den ApplicationContext auf alle möglichen Service-Objekte zugreifen. Das Erzeugen von neuen Objekten (z.B. Datum, etc.) ist nicht möglich. Nähere Infos zur Syntax findet man auf http://velocity.apache.org

Upload XPDL File

Damit bei Unregelmäßigkeiten aus dem System IF6020 (z.B. vergessene Gehen-Buchung) Systemhinweise erstellt werden können, muss eine XPDL Datei hochgeladen werden.

Die XPDL Datei SystemNotification.xpdl muss derzeit noch manuell in die Workflow-Engine hochgeladen werden.  Die Datei finden Sie hier!

Um die XPDL Datei hochzuladen geht man am besten wie folgt vor:

• XPDL Datei muss lokal gespeichert sein
• Menüpunkt Workflow > Prozessdefinitionen > Neuen Editor starten
• URL-Link kopieren (Strg c) > OK

• Connecting to engine
• File > open > Suche nach XPDL File > öffnen

• opening xpdl

• "Upload xpdl to engine" anklicken (2. Symbol von links) > Programm wird auf den Server geladen

• Prozess ist in der Prozessliste vorhanden (Process definition list > Name: SystemNotification)

Auf diese Weise können auch andere Prozesse, die nicht standardmäßig ausgeliefert,  sondern individuell nach Wunsch erstellt werden, in das System hochgeladen werden.

Zusatzinfos: Link auf Notes-dokument

Zweck

Der Job verarbeitet definierte IF6020-Ereignisse und erzeugt daraus Workflow-Prozesse als Systembenachrichtigungen für betroffene Personen.

Voraussetzungen

• Das Modul TA/IF6020 und Workflow müssen verfügbar sein.
• Die verwendete Prozessdefinition muss die erwarteten Variablen unterstützen. Wird keine gültige Prozessdefinition konfiguriert, verwendet der Job die Standarddefinition WebdeskDefaultProcessDefinitions$SystemNotificationWithRedirect.

Jobkonfiguration

• Monate in die Vergangenheit und Monate in die Zukunft: Zeitraum, in dem IF6020-Ereignisse gesucht werden.
• Mandant: Der Job verarbeitet Personen des gewählten Mandanten, sofern keine Gruppen ausgewählt sind.
• Gruppen: Alternativ wird die Vereinigungsmenge der aktuell gültigen Personen der gewählten Gruppen verarbeitet. Die TA-ID wird für die Ereignissuche verwendet.
• Benachrichtigungszeilen: Jede Zeile beschreibt ein Ereignis und die daraus zu erzeugende Workflow-Aufgabe.
• IF6020-Systemereignis: Das Ereignis, dessen offene Datensätze verarbeitet werden.
• Aktion: Optionale Webdesk-Aktion, auf die aus der Systembenachrichtigung verlinkt wird.
• URL-Anhang: Optionaler Velocity-Ausdruck für Query-Parameter der Aktion.
• List Detail: Velocity-/HTML-Vorlage für die Detailspalte der Workflow-Aufgabe. Zeilenumbrüche werden als <br/> übernommen und das Ergebnis wird vor dem Einfügen in den Workflow bereinigt.
• Zu verwendende Prozessdefinition: Optionale Prozessdefinition im Format Paketname$Prozessdefinitionsname.
• Workflowprozess mit betroffener Person als Autor starten: Wenn aktiviert, wird die betroffene Person als Prozessautor verwendet; ansonsten der Systemadministrator.

Velocity-Kontext

In List Detail und URL-Anhang stehen unter anderem ta_id, fromdate, from_date, fromDate, year, month, day, person und eventDate zur Verfügung. Beispiel: $person.getFullName().

Ablauf

1. Der Job ermittelt die TA-IDs der konfigurierten Personen.
2. Für jede Benachrichtigungszeile werden Ereignisse im konfigurierten Zeitraum gesucht.
3. Für jedes passende Ereignis wird ein Workflow-Prozess mit listDetail und der betroffenen Person als Empfänger erzeugt. Optional werden redirectToUrl und from_date als Prozessvariablen gesetzt, wenn die Prozessdefinition diese Variablen enthält.
4. Nach erfolgreicher Prozesserzeugung wird das Ereignis als verarbeitet markiert.

Die Auswahl des Ereignisses, der Prozessdefinition, der Aktion und der Velocity-Ausdrücke muss zusammenpassen. Prüfen Sie die erzeugte Prozessdefinition und die Variablennamen in einer Testumgebung.