Das Tool „Workflow-Aktivitäten löschen“ (dltwflact) löscht Aktivitäten auf der angegebenen Datenbank. Optional werden Aufgaben mit einem ungültigen Bearbeiter gelöscht oder einem Workflow-Administrator neu zugeordnet.
1 Zielgruppe
2 Begriffsbestimmung
Aktivitäten
Eine Aktivität beschreibt eine Tätigkeit, die durch einen oder mehrere Benutzer bearbeitet werden kann. Die Bearbeitung der Tätigkeit durch die Benutzer erfolgt aufgrund einer oder mehrerer Aufgaben, in denen die entsprechende Tätigkeit für jeden Benutzer beschrieben ist. Eine Aktivität bildet also eine Klammer um die daraus entstandenen Aufgaben und enthält erforderliche Informationen über die Aufgaben.Aktivitäten entstehen im Rahmen des Workflow-Managements oder des Beziehungs-Managements und sind Teil des Workflows.
Aufgabe
Eine Aufgabe im Workflow-Management stellt die Zuordnung einer aus einer Aktivität resultierenden Tätigkeit zu einem Benutzer dar. Jede Aufgabe hat einen vorgesehenen Bearbeitungszeitraum, der von der übergeordneten Aktivität bestimmt wird, sowie einen Aufgabenstatus. Beim ersten Wechsel in einen neuen Status wird der Zeitpunkt des Wechsels dokumentiert.
Bearbeiter von Aktivitäten
Im Workflow-Management erzeugte Aktivitäten können von mehreren Bearbeitern im Einzel- oder Mehrfachbearbeitung bearbeitet werden. Aus der Menge der Bearbeiter werden zunächst die Benutzer ermittelt. Anschließend wird für jeden Benutzer eine Aufgabe erzeugt, die Eigenschaften wie z. B. Beschreibung und Bearbeitungszeitraum aus der Aktivität erhält. Die Bearbeiter einer Aktivität werden meist über die Ablauforganisation ermittelt. Bei einigen Aktivitätstypen, wie z. B. Skriptknoten und Serviceknoten, werden Aktivitäten nicht von Benutzern sondern vom System oder von einer Hintergrund-Anwendung bearbeitet.
Tool
Ein Tool ist eine spezielle Form einer Anwendung, welche von der Toolshell aus gestartet werden kann.
Workflow-Administrator
Ein Workflow-Administrator ist ein Benutzer, der administrative Aufgaben im Workflow-Management übernimmt. Beispielsweise werden Workflow-Administratoren als Bearbeiter herangezogen, wenn die Workflow-Engine keinen gültigen Bearbeiter für eine Aktivität ermitteln kann, z. B. weil die verendete Workflowrolle keine Inhaber hat. Workflow-Administratoren können auch eine E-Mail-Benachrichtigung erhalten, wenn der Kontrollfluss den Fehlerknoten erreicht, damit sie den Fehler analysieren und die Prozessbeteiligten benachrichtigen können. Workflow-Administratoren werden in der Customizing-Funktion „Workflow-Management“ mithilfe einer Workflowrolle festgelegt. Durch die Festlegung erhalten Workflow-Administratoren keine besonderen Fähigkeiten. Um ihre Aufgaben als Workflow-Administratoren wahrnehmen zu können, wird daher empfohlen, sie der administrativen Fähigkeitsklasse für das Framework „Workflow-Management“ zuzuordnen, damit sie die Fähigkeiten besitzen, um z. B. Prozesse, Aktivitäten und Aufgaben anderer Benutzer anzuzeigen.
3 Beschreibung
Das Tool „Workflow-Aktivitäten löschen“ (dltwflact) löscht Aktivitäten auf der angegebenen Datenbank. Optional werden Aufgaben mit einem ungültigen Bearbeiter gelöscht oder einem Workflow-Administrator neu zugeordnet.
Das Tool sollte unter den folgenden Umständen verwendet werden:
- Vor der Auslieferung eines Systems sollten alle Aktivitäten gelöscht werden, damit neu erstellte Systeme keine Aktivitäten aus der Entwicklungs- und Testphase enthalten.
- Wenn in einem System Aufgaben mit einem ungültigen Benutzer existieren, sollten diese gelöscht oder einem Workflow-Administrator neu zugeordnet werden. Solche Aufgaben können z. B. dann entstehen, wenn Benutzer in einem System gelöscht werden.
- Wenn eine Aktivität einen Fehlerzustand (Exception) hervorruft, der das Erledigen ohne Änderungen verhindert.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| dltwflact | [-db:<str>] |
| [-all] | |
| [-code:<str>] | |
| [-withoutValidUser] | |
| [-delete] |
3.2 Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden, nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
| Parameter | Erläuterung |
| [-db] | Dieser Parameter bestimmt auf welcher Datenbanken Aktivitäten gelöscht werden. Geben Sie den Parameter nicht an, dann werden Aktivitäten auf allen Datenbanken des Systems gelöscht. |
| [-all] | Löscht alle Aktivitäten. |
| [-code] | Dieser Parameter bestimmt die Identifikation der zu löschenden Aktivität. Es können nur Aktivitäten gelöscht werden, die nicht zu einem Prozess gehören. Um Prozesse und ihre zugehörigen Aktivitäten zu löschen, verwenden Sie das Tool „Workflow-Prozesse löschen“ (dltwflprc). |
| [-withoutValidUser] | Ordnet alle Aufgaben, die einem ungültigen Benutzer zugeordnet sind, einem Workflow-Administrator zu.
In der Customizing-Funktion „Workflow-Management“ können Sie eine Workflowrolle für Workflow-Administratoren in OLTP-Datenbanken und in der Repository-Datenbank festlegen. Ist keine Workflowrolle für Administratoren festgelegt oder die hat die Workflowrolle keine gültigen Inhaber in der Datenbank, dann werden die Aufgaben dem Administrator des Systems zugeordnet. Hinweis: Eine Aufgabe muss genau einem Benutzer zugeordnet sein. Hat die Workflowrolle für die Workflow-Administratoren mehrere gültige Inhaber, dann werden Aufgaben mit einem ungültigen Benutzer einem dieser Inhaber neu zugeordnet. |
| [-delete] | Löscht alle Aufgaben, die einem ungültigen Benutzer zugeordnet sind. |
Beispiel 1
Alle Aktivitäten auf der Datenbank QAS60001 sollen gelöscht werden.
dltwflact –db:QAS60001 -all
Beispiel 2
Die Aktivität mit der Identifikation „004711“ auf der Datenbank QAS60001 soll gelöscht werden.
dltwflact –db:QAS60001 –code:004711
Beispiel 3
Alle Aufgaben ohne einen gültigen Benutzer sollen auf allen Datenbanken des Systems einem Workflow-Administrator zugeordnet werden.
dltwflact –withoutValidUser
Beispiel 4
Alle Aufgaben ohne einen gültigen Benutzer sollen auf der Datenbank „QAS60001“ gelöscht werden.
dltwflact –Datenbank:QAS60001 –delete
3.3 Berechtigungen
Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie im Dokument Berechtigungen nachlesen.
Für das Tool „Workflow-Aktivitäten löschen“ (dltwflact) bestehen folgende spezielle Fähigkeit, die sich auf Aktionen bezieht. Für diese Fähigkeit können Sie in der Anwendung „Berechtigungsrollen“ Berechtigungen vergeben.
Aktivitäten und abhängige Objekte löschen
com.cisag.sys.workflow.DeleteActivities