Das Tool „Workflow-Aktivierungen löschen“ (dltwflacv) löscht Aktivierungen von Aktivitätsdefinitionen und alle Zuordnungen von Inhabern zu Workflowrollen auf allen Datenbanken des Systems.
1 Zielgruppe
2 Begriffsbestimmung
Aktivitätsdefinition
Eine Aktivitätsdefinition ist die Vorlage für die aus ihr erzeugten Aktivitäten. Ist eine Aktivitätsdefinition aktiviert, dann erzeugt die Workflow-Engine beim Eintreten des registrierten Ereignisses eine neue Aktivität, sofern die Übergangsbedingung erfüllt ist. Aktivitätsdefinitionen sind unabhängig von der OLTP-Datenbank und dem System, in dem sie erfasst wurden, da sie weder System- noch OLTP-spezifische Daten enthalten. Aktivitätsdefinitionen werden in der Repository-Datenbank gespeichert.
Tool
Ein Tool ist eine spezielle Form einer Anwendung, welche von der Toolshell aus gestartet werden kann.
Workflowrolle
Workflowrollen sind eine Abstraktionsebene, um die vom Workflow-Management verwendete Ablauforganisation abzubilden. Workflowrollen sind unabhängig von der OLTP-Datenbank und dem System, in dem sie erfasst wurden, da sie weder System- noch OLTP-spezifische Daten enthalten. Workflowrollen werden in der Repository-Datenbank gespeichert. Einer Workflowrolle müssen Inhaber zugeordnet werden, damit diese sinnvoll verwendet werden kann. Inhaber können z. B. Benutzer, Personen, Stellen oder Organisationen sein. Die Zuordnung der Inhaber einer Workflowrolle ist datenbankspezifisch, weil bei der Zuordnung nur Objekte in dieser Datenbank benutzt werden können. In unterschiedlichen Datenbanken können einer Workflowrolle unterschiedliche Inhaber zugeordnet werden.
Workflowrolleninhaber
Der Workflowrolleninhaber ist Teil des Workflows. Er ist eine Person oder eine Personengruppe, die einer Workflowrolle in einer Datenbank zugeordnet wurde. Inhaber können z. B. Benutzer, Personen, Organisationen oder Stellen sein. Wenn beim Erzeugen einer Aktivität kein gültiger Benutzer aus den Workflowrolleninhabern ermittelt werden kann, wird die Workflowrolle „cis.WorkflowAdminOLTP“ bzw. „cis.WorkflowAdminRepository“ für die Ermittlung benutzt. Wenn diese Rolle keinen gültigen Benutzer hat, dann wird die Aufgabe dem Benutzer „Administrator“ zugeordnet.
3 Beschreibung
Das Tool „Workflow-Aktivierungen löschen“ (dltwflacv) löscht Aktivierungen von Aktivitätsdefinitionen und alle Zuordnungen von Inhabern zu Workflowrollen auf allen Datenbanken des Systems. Optional werden nur ungültige Aktivierungen und Inhaberzuordnungen gelöscht. Eine Aktivierung bzw. Zuordnung ist ungültig, wenn das Exportpräfix der Aktivitätsdefinition bzw. Workflowrolle und das Exportpräfix des aktuellen Systems unterschiedlich sind.
Das Tool sollte unter den folgenden Umständen verwendet werden:
- Vor der Auslieferung eines Systems. In diesem Fall sollten alle Aktivierungen von Aktivitätsdefinitionen und alle Zuordnungen von Inhabern zu Workflowrollen gelöscht werden, damit neu erstellte Systeme keine Aktivierungen und Inhaber aus der Entwicklungs- und Testphase enthalten.
- Wenn in einem System Aktivitätsdefinitionen mit einem Exportpräfix aus einem anderen System aktiviert sind oder Workflowrollen Inhaber mit einem Exportpräfix aus einem anderen System haben. Solche Aktivierungen oder Inhaberzuordnungen können z. B. dann entstehen, wenn ein System als Kopie aus einem anderen System erstellt wurde. In diesem Fall sollten die ungültigen Aktivierungen und Inhaberzuordnungen gelöscht werden.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| dltwflacv | [-roleMembers] |
| [-activityDefinitionActivation] | |
| [-invalid] |
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 |
| [-roleMembers] | Löscht alle Zuordnungen von Inhabern zu allen Workflowrollen auf allen Datenbanken des Systems unabhängig von deren Exportpräfix. |
| [-activityDefinitionActivation] | Löscht alle Aktivierungen von allen Aktivitätsdefinitionen auf allen Datenbanken des Systems unabhängig von deren Exportpräfix. |
| [-invalid] | Löscht alle ungültigen Aktivierungen von Aktivitätsdefinitionen sowie alle ungültigen Zuordnungen von Inhabern zu Workflowrollen auf allen Datenbanken des Systems. Eine Aktivierung bzw. Zuordnung ist ungültig, wenn das Exportpräfix der Aktivitätsdefinition bzw. Workflowrolle und das Exportpräfix des aktuellen Systems unterschiedlich sind. |
3.3 Berechtigungen
Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie im Dokument Berechtigungen nachlesen.
Für das Tool „dltwflacv“ besteht 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
Beispiel
Alle Aktivitätsdefinitionen sollen auf allen Datenbanken des Systems deaktiviert werden.
dltwflacv – activityDefinitionActivation
Da Prozessdefinitionen über ihren Startknoten aktiviert werden und der Startknoten als Aktivitätsdefinition abgebildet ist, werden auch alle Prozessdefinitionen auf allen Datenbanken des Systems deaktiviert. Auch Zwischenereignisse werden deaktiviert.