A.08 Workflow Laufliste
Laufliste
Lauflisten-Modelle
Ein Lauflisten-Objekt besteht aus einem Model, in dem sich die Eigenschaften der jeweiligen Laufliste befinden, und der API, über die die Laufliste geändert werden kann.
Lauflisten-Model
Eigenschaft | Verfügbar ab | Beschreibung |
|---|---|---|
id | 8.50 SP2 | ID der Laufliste |
activityId | 8.50 SP2 | ID der AdHoc-Container-Aktivität des Workflow-Modells |
processId | 8.50 SP2 | ID des Workflow-Prozesses |
expandable | 8.50 SP2 | Gibt an, ob die Laufliste erweiterbar/reduzierbar ist (true/false). |
groups | 8.50 SP2 | Ein Array der Lauflistengruppen |
adHocData | 8.50 SP2 | Map mit Key-Value-Paaren. Enthält Informationen zu den im Workflow-Modell konfigurierten Aktivitäten und Mahnfristen der AdHoc-Container-Aktivität. |
Lauflisten-Model-AdHocData
Eigenschaft | Verfügbar ab | Beschreibung |
|---|---|---|
activities | 8.50 SP2 | Map mit Key-Value-Paaren. Die Keys entsprechen den Namen der Aktivitäten im AdHoc-Container. Beispiel <Aktivitätsname> : <Aktivität>. |
periods | 8.50 SP2 | Map mit Key-Value-Paaren. Die Keys entsprechen den Namen der Fristen im AdHoc-Container. Beispiel <Fristenname> : <Mahnfrist>. |
defaultActivity | 8.50 SP2 | Standardaktivität des AdHoc-Containers |
defaultPeriod | 8.50 SP2 | Standardmahnfrist des AdHoc-Containers |
Lauflisten-Model-AdHocData-Aktivität
Eigenschaft | Verfügbar ab | Beschreibung |
|---|---|---|
id | 8.50 SP2 | ID der Aktivität |
deletable | 8.50 SP2 | Legt fest, ob die Aktivität durch den Empfänger des AdHoc-Workflows löschbar ist. |
editable | 8.50 SP2 | Legt fest, ob die Aktivität durch den Empfänger des AdHoc-Workflows änderbar ist. |
name | 8.50 SP2 | Name der Aktivität |
participants | 8.50 SP2 | Array mit GUIDs der Workflowbenutzer, die diese Aktivität bearbeiten sollen. |
type | 8.50 SP2 | Typ der Aktivität. Mögliche Werte sind:
|
Lauflisten-Model-AdHocData-Mahnfrist
Eigenschaft | Verfügbar ab | Beschreibung |
|---|---|---|
id | 8.50 SP2 | ID der Mahnfrist |
name | 8.50 SP2 | Name der Mahnfrist |
duration | 8.50 SP2 | Relative Länge der Mahnfrist ab der letzten Weiterleitung |
Lauflisten-API
Neben den Modelldaten verfügt ein Lauflistenobjekt über API-Methoden. Über diese kann eine Laufliste via Skript zusammengestellt, modifiziert oder als Vorlage gespeichert werden.
API-Methode | Verfügbar ab | Beschreibung |
|---|---|---|
setExpandable({expandable}) | 8.50 SP2 | Setzt für die Laufliste die Eigenschaft, ob die Laufliste im Client erweiterbar sein soll. Parameter:
|
isValid() | 8.50 SP2 | Gibt zurück, ob die Laufliste valide ist. Eine Laufliste ist valide, wenn all ihre enthaltenen Gruppen valide sind (siehe Lauflistengruppe API - Is valid). Fehler werden ggf. in der Browserconsole ausgegeben. |
getGroupById({id}) | 8.50 SP2 | Liefert gegebenenfalls die Gruppe mit der übergebenen ID zurück. Parameter:
|
createGroup({expandable}) | 8.50 SP2 | Erstellt eine neue Gruppe und fügt diese am Ende der Laufliste hinzu. Ggf. werden die Properties der Gruppe mit den Informationen aus den Parametern gefüllt. Die erstellte Gruppe wird zurückgeliefert. Optionale Parameter:
|
createGroupAt({index}, {expandable}) | 8.50 SP2 | Erstellt eine neue Gruppe und fügt diese der Laufliste an der angegebenen Position hinzu. Ggf. werden die Properties der Gruppe mit den Informationen aus den Parametern gefüllt. Die erstellte Gruppe wird zurückgeliefert. Parameter:
Optionale Parameter:
|
addGroup({group}, {fromTemplate}) | 8.50 SP2 | Fügt eine Gruppe am Ende der Laufliste hinzu. Sollten Sie über diese Methode einzelne Gruppen einer Lauflistenvorlage manuell einfügen wollen, so kopieren Sie die Laufliste der Vorlage bitte zuvor über 'routingList.api.copy()'. Parameter:
|
addGroupAt({group}, {index}, {fromTemplate}) | 8.50 SP2 | Fügt eine Gruppe der Laufliste an der angegebenen Position hinzu. Sollten Sie über diese Methode einzelne Gruppen einer Lauflistenvorlage manuell einfügen wollen, so kopieren Sie die Laufliste der Vorlage bitte zuvor über 'routingList.api.copy()'. Parameter:
|
removeGroup({group}) | 8.50 SP2 | Entfernt die Gruppe aus der Laufliste. Parameter:
|
removeGroupById({id}) | 8.50 SP2 | Entfernt die Gruppe mit der übergebenen ID aus der Laufliste. Parameter:
|
addList({list}, {fromTemplate}) | 8.50 SP2 | Kopiert die Gruppen einer Laufliste in diese Laufliste. Parameter:
|
addListAt({list}, {index}, {fromTemplate}) | 8.50 SP2 | Kopiert die Gruppen einer Laufliste und fügt die kopierten Gruppen an einer bestimmten Position in dieser Laufliste ein. Parameter:
|
saveAsTemplate(name, isPublic, templateToOverwrite) | 8.50 SP2 | Speichert die Laufliste als Vorlage unter dem angegebenen Namen. Es kann eine Lauflistenvorlage übergeben werden, welche überschrieben werden soll. Parameter:
|
Lauflistengruppe
Ein Lauflistengruppe-Objekt besteht aus einem Model, in dem sich die Eigenschaften der jeweiligen Gruppe befinden, und der API, über die die Gruppe geändert werden kann.
Lauflistengruppe-Modell
Eigenschaft | Verfügbar ab | Beschreibung |
|---|---|---|
id | 8.50 SP2 | ID der Lauflistengruppe |
expandable | 8.50 SP2 | Legt fest, ob die Lauflistengruppe erweiterbar/reduzierbar ist (true/false). |
isNew | 8.50 SP2 | Legt fest, ob die Gruppe der Laufliste neu hinzugefügt wurde, aber noch nicht gespeichert ist (true/false). |
items | 8.50 SP2 | Map mit Key-Value-Paaren. Die Keys entsprechen den IDs der jeweiligen LauflistenItems. Beispiel: <ID> : <LauflistenItem>. |
Lauflistengruppe-API
API-Methode | Verfügbar ab | Beschreibung |
|---|---|---|
setExpandable({expandable}) | 8.50 SP2 | Setzt für die Gruppe die Eigenschaft, ob die Gruppe im Client erweiterbar sein soll. Parameter:
|
isValid() | 8.50 SP2 | Gibt zurück, ob die Gruppe valide ist. Eine Gruppe ist valide, wenn sie mindestens ein Item enthält und alle in ihr enthaltenen Items valide sind (siehe Lauflistenitem API - Is valid). Fehler werden ggf. in der Browserconsole ausgegeben. |
containsItemById({id}) | 8.50 SP2 | Liefert einen boolschen Wert zurück, der angibt, ob die Gruppe ein Lauflisten-Item mit der übergebenen ID enthält. Parameter:
|
getItemById({id}) | 8.50 SP2 | Liefert gegebenenfalls das Lauflisten-Item mit der übergebenen ID zurück. Parameter:
|
createItem({activity}, {period}) | 8.50 SP2 | Erstellt ein neues Lauflisten-Item und fügt dieses der Gruppe hinzu. Ggf. werden die Properties des Items mit den Informationen aus den Parametern gefüllt. Das erstellte Lauflistenitem wird zurückgeliefert. Optionale Parameter: |
addItem({item}) | 8.50 SP2 | Fügt ein Lauflisten-Item der Gruppe hinzu. Parameter:
|
removeItem({item}) | 8.50 SP2 | Entfernt das Lauflisten-Item aus der Gruppe. Parameter:
|
removeItemById({id}) | 8.50 SP2 | Entfernt das Lauflisten-Item mit der übergebenen ID aus der Gruppe. Parameter:
|
moveTo({list}, {index}) | 8.50 SP2 | Entfernt die Gruppe aus seiner momentanen Laufliste und fügt sie in die übergebene Laufliste ein. Parameter:
Optionale Parameter:
|
copy() | 8.50 SP2 | Erstellt mit den Einstellungen der Gruppe eine neue Gruppe und gibt diese zurück. |
Lauflisten-Item
Ein Lauflisten-Item-Objekt besteht aus einem Model, in dem sich die Eigenschaften des jeweiligen Lauflisten-Items befinden, und der API, über die das Lauflisten-Item geändert werden kann. Ggf. enthalten die Eigenschaften die Feldobjekte des Client Grids und können wie Felder bearbeitet werden (für nähere Informationen zu Feldern siehe 2.2 Maskenfelder). So können auch direkt die zugehörigen Felder im Client bearbeitet werden (mit zugehöriger Fehlermeldung invalide gesetzt etc.).
Lauflisten-Item-Modell
Eigenschaft | Verfügbar ab | Beschreibung |
|---|---|---|
id | 8.50 SP2 | ID des Lauflisten-Items |
deletable | 8.50 SP2 | Legt fest, ob das Lauflisten-Item von einem nicht prozessverantwortlichen Benutzer löschbar ist. |
editable | 8.50 SP2 | Legt fest, ob das Lauflisten-Item von einem nicht prozessverantwortlichen Benutzer bearbeitbar ist. |
participants | 8.50 SP2 | Ein Array mit den Namen der Bearbeiter, die der Aktivität des Lauflisten-Items zugewiesen werden. |
remark | 8.50 SP2 | Freitext für Bearbeitungshinweise |
taskName | 8.50 SP2 | Freitext für eine Aktivitätsbezeichnung |
activityName | 8.50 SP2 | Name der Aktivität im Workflow-Modell |
periodName | 8.50 SP2 | Name der Mahnfrist im Workflow-Modell |
dueOn | 8.50 SP2 | Datum, an dem die Mahnfrist gefeuert werden soll. |
timerType | 8.50 SP2 | Gibt an, wie die Eskalationszeit der ggf. ausgewählten Mahnfrist zu werten ist. Folgende Werte sind zulässig: |
Lauflisten-Item-API
API-Methode | Verfügbar ab | Beschreibung |
|---|---|---|
setActivityData({activity}) | 8.50 SP2 | Setzt die Eigenschaften des Lauflisten-Items mit den Daten der übergebenen Aktivität. Parameter:
|
setPeriodData({period}) | 8.50 SP2 | Setzt die Eigenschaften des Lauflisten-Items mit den Daten der übergebenen Mahnfrist. Parameter:
|
isValid() | 8.50 SP2 | Gibt zurück, ob die Eigenschaften des Lauflisten-Items valide sind. Fehler werden ggf. in der Browserconsole ausgegeben. Ein Item ist valide, wenn:
|
remove() | 8.50 SP2 | Entfernt das Lauflisten-Item aus seinem Lauflisteneintrag. |
moveTo({group}) | 8.50 SP2 | Entfernt das Lauflisten-Item aus seiner aktuellen Gruppe und fügt diese in die übergebenen Gruppe ein. Parameter:
|
copy() | 8.50 SP2 | Erstellt mit den Einstellungen des Lauflisten-Items ein neues Lauflisten-Item und gibt dieses zurück. |