Aktionen

Über das Menü Paketdaten→ToDo-Definitionen→Aktionen wird die Übersicht der Aktionen geöffnet.
Ähnlich wie die Zusatzdaten werden Aktionen für einen bestimmten Todo-Typ definiert. Dabei können für einen Typ mehrere Aktionen definiert werden. Die definierten Aktionen werden dann zur Auswahl in der Todo Liste für einen Todo Eintrag angezeigt, oder durch die DPE bei Systemaufgaben ausgeführt.
Welche Aktionen für eine Todo zu einem bestimmten Zeitpunkt möglich sind, hängt von dem derzeitigen Status der Todo ab. Deshalb werden Aktionen nicht nur für einen bestimmten Typ, sondern auch für einen bestimmten Status definiert. Nach der Durchführung einer Aktion hat die Todo üblicherweise einen neuen Status, dies ist jedoch nicht zwingend.
Für eine bestimmte Todo-Typ und Status Kombination kann zudem eine Aktion als Standard-Aktion definiert werden. Diese wird bei Systemaufgaben durch die DPE zur Ausführung gewählt. In Todo-Listen wird die Standard-Aktion üblicherweise durch ein Doppelklick mit der Maus auf der Todo ausgeführt.
Neben „normalen“ Aktionen können auch Eskalationsaktionen definiert werden. Diese werden durch die DPE für eine Todo-Typ und Status Kombination im Eskalationsfall ausgeführt.
Ein dritter Aktionstyp sind Kompensationsaktionen. Diese werden für die Kompensation (Rollback) einer gescheiterten Aktion verwendet, um die Daten wieder in den ursprünglichen konsistenten Stand zu bringen.

Die Benutzung der Maske zum anlegen, ändern und löschen von Aktionen folgt dem Standard, wie im Kapitel "Grundsätzliche Maskenfunktionen" beschrieben.

Dabei haben die einzelnen Felder folgende Bedeutung:

FeldPflichtBedeutung
AktionsnameJVerweis auf den Aktionsnamen.
Todo_TypJFür welchen Todo-Typ diese Aktion gilt.
Von_StatusJFür welchen Status diese Aktion gültig ist.
StandardNEine Aktion für eine Todo-Typ und Statuskombination kann als Standardaktion definiert werden.
EskalationNEine Aktion für eine Todo-Typ und Statuskombination kann als Eskalationsaktion definiert werden.
KompensationNEine Aktion für eine Todo-Typ und Statuskombination kann als Kompensationsaktion definiert werden.
Dialog_notwendigNGibt an, ob für diese Aktion ein DLE Dialog und damit eine Benutzerinteraktion notwendig ist. Solche Aktionen werden nicht durch die DPE ausgeführt und im Dialogmodus gestartet. DPE Aktionen werden im Batchmodus gestartet.
Max_LaufzeitNEine geschätzte maximale Laufzeit dieser Aktion. Dadurch kann die DPE erkennen, welche laufenden Aktionen „überfällig“ sind und auf ein Problem hindeuten.
Funktion_IDNOptional kann eine Aktion mit einer Funktion verknüpft werden, um der Aktion Benutzerrechte zuzuordnen.
PaketJZu welchem Paket diese Funktion gehört.
AuufJManuell oder durch DLE: Die Aktion kann manuell durch einen Benutzer (aus der Todo Liste) oder durch einen DLE Aufruf (Kommando: DPE Aktion ausführen) im Brick aufgerufen werden.
Durch DLE: Aktion kann nur durch einen DLE Brick Aufruf aufgerufen werden.
Nur durch Applikation: Aktion wird nur durch die aufrufende Applikation gestartet.
Nach_StatusJDer Zielstatus der Todo. Der Status wird nicht automatisch gesetzt, sondern muss im aufgerufenen Brick gesetzt werden.
Da die Aktion beim Aufruf mit übergeben wird, kann der Zielstatus im Brick aus der Aktion gelesen werden.
OrdnerNWelcher Ordner (DLE Folder) aufgerufen werden soll. Dieser wird in Zukunft im Format Paketname:EindeutigerOrdnerName angegeben. Ist das Feld leer, wird bei Eskalationen der Ordner DPE:Escalations, bei normalen Aktionen der Ordner DPE:Actions verwendet.
BricknameNDamit wird die interne Standardvariable BASE:BrickName vor dem Aufruf gefüllt.
Mit dieser können dann sprechende Ordnerschlüssel angelegt werden, wenn man direkt Bricks aufrufen will.
Achtung! Dies steht in keinem Zusammenhang mit dem Namen, dem man einen Brick in dessen Kopfzeile geben kann!
Fehler_OrdnerNFalls der Brickaufruf einen Fehler produziert, wird dieser Ordner automatisch im Anschluß ausgeführt.
Fehler_BrickNAnalog zu Brickname.
Parameter 1-3NOptionale Parameter, auf die im brick Bezug genommen werden kann.
BeschreibungNEine Freitextbeschreibung der Aktion.

Wurde für eine Aktion der Aktivitätentyp EXECUTE gewählt, wird bei der Wahl der Aktion für ein Todo ein DLE Aufruf durchgeführt. Als Parameter zu dem Aufruf wird der Todo Datensatz und die Aktion mitgegeben, dazu die interne Variable BASE:BrickName mit dem Inhalt aus dem Feld BrickName der Aktion. Auf all diese Werte kann somit in der Schlüsseldefinition des Ordners, sowie innerhalb der Bricks Bezug genommen werden.
Ist kein Ordner in der Aktion definiert, wird für normale Aktionen der Standardordner DPE:Actions benutzt. Für Eskalationen DPE:Escalations und für Fehler DPE:Errors.
Ist kein Ordner in der Aktion definiert, wird für normale Aktionen der Standardordner DPE:Actions benutzt. Für Eskalationen DPE:Escalations und für Fehler DPE:Errors.
Entsprechend dem definierten Updateverhalten wird zudem der Status der betroffenen Todo verändert, oder nicht verändert.
Wird eine Todo durch die DPE abgearbeitet, sucht diese die erste Batchorientierte Standardaktion für den aktuellen Todo-Typ und –Status.
Wurde eine Aktion gefunden, erfolgt der Aufruf der DLE analog zu einem manuellen Aufruf. Wurde keine Aktion gefunden, wird der Ordner DPE:Actions nur mit der Todo als Parameter aufgerufen, eine Aktion wird dann nicht übergeben, da nicht vorhanden.
Ähnlich erfolgt die Abarbeitung der Eskalationen. Steht für eine Todo eine Eskalation an, sucht die DPE die erste Batchorientierte Eskalationsaktion für diese Todo und ruft dann nach obiger Logik die DLE auf. Wurde keine gefunden, wird der Ordner DPE:Escalations ohne Aktion als Parameter aufgerufen.