Übergangs-Assistenten

Übergangs-Assistenten ermöglichen es, einen Assistenten auf einfache Weise zu gestalten und festzulegen, welche Werte bei einer Aufgabe geändert werden sollen. Sie können sowohl bei Statusübergängen als auch innerhalb der Status-Aktionen in den Statusabläufen eingesetzt werden, um Änderungen gezielt und strukturiert auszuführen.

Standardmäßig werden mit dem Project Management mehrere Übergangs-Assistenten ausgeliefert.

Die Übergangs-Assistenten können in der Projektmanagement-Applikation unter Konfiguration > Aufgabentyp-Definitionen > Übergangs-Assistenten eingesehen, erstellt und bearbeitet werden. Das Bearbeiten dieser ist ausschließlich Benutzern der Admin-Rolle des Systems vorbehalten (siehe hier).

Danger

Alle Änderungen an Übergangs-Assistenten wirken sich nach Speichern auf die zugehörigen Aufgabentyp-Definitionen, Statusabläufe, Prozesse, Berechtigungen und Projekte aus.

Container-Sichtbarkeit und Bearbeitungslogik

Der Container Allgemein wird bereits bei der Erstellung im Dialog angezeigt. Der Container Attribute erst nach der Initialisierung im Bearbeitungsdialog sichtbar.

Allgemein

Die Bearbeitung des Layouts sowie die Pflege der Attribute ist erst möglich, nachdem der Übergangs-Assistent initial erstellt wurde.

Bei der Erstellung sind folgende Felder Pflicht:

Feld	Beschreibung
Technischer Name	Wird zur technischen Erstellung des Assistenten verwendet und dient als Basis für die zugehörigen Objekte.
Titel	Anzeigename des Assistenten
Aufgabentyp-Definition	Legt fest, für welche Aufgabentyp-Definition der Assistent gilt. Ein Übergangs-Assistent kann - analog zu Statusabläufen - nicht nur für die direkt zugeordnete Aufgabentyp-Definition verwendet werden, sondern auch für alle davon abgeleiteten (untergeordneten) Aufgabentyp-Definitionen.

Optional kann ein Icon angegeben werden. Dieses wird als Symbol der generierten Aktion verwendet, die abhängig von den konfigurierten Übergängen und Status-Aktionen erzeugt und später im Projekt in der Schnellansicht der Aufgabe als Aktion angezeigt wird.

Attribute

In dem Container Attribute definierst du, welche Felder im Übergangs-Assistenten bearbeitet werden können. Jedes Attribut besteht aus folgenden Angaben:

Feld	Beschreibung
Name	Technischer Name für die Verwendung im Layout-Designer.
Schema-Attribut	Der Attributname in der Datendefinition.
Schema-Klasse	Die Datendefinition, aus der das Attribut stammt.
Wert zur Vorbelegung	Optionaler ASQL-Ausdruck, mit dem ein Standardwert gesetzt wird, falls das Attribut noch keinen Wert besitzt.

Das Attribut State kann nicht ausgewählt werden, da der Status automatisch vom System in das Layout integriert wird. Mehr Informationen zu dem Layout des Assistenten findest du hier.

Du kannst Attribute per Doppelklick auf einen Eintrag bearbeiten oder über das Plus-Symbol neue Attribute hinzufügen. Über das Mülleimer-Symbol lassen sich vorhandene Attribute wieder entfernen. Jedes Attribut kann nur einmal erfasst werden. Beim Erstellen oder Bearbeiten eines Attributs öffnet sich ein Assistent, der dich durch die Konfiguration führt. Ein Beispiel hierfür ist im unten stehenden GIF dargestellt.

Warning

Nach Änderungen an den Attributen muss die Layout-Designer-Ansicht des Assistenten neu geöffnet werden, um die Kompatibilität sicherzustellen. Alternativ kann der Cache des Layout-Designers gelöscht werden, bevor weitere Anpassungen vorgenommen werden.

Info

Es werden nur Relationen unterstützt, die direkt in der zugrunde liegenden Datenbanktabelle vorhanden sind. Relationen der Typen N:M sowie (0/1):N werden nicht unterstützt, hingegen wird die Relation N:(0/1) unterstützt. Zudem können keine Multi-Fragmente innerhalb des Objekts bearbeitet werden.

Layout des Assistenten

Das Layout eines Übergangs-Assistenten wird automatisch generiert und kann über die Aktion Layout ändern angepasst werden. Diese Aktion steht in der Aktionsleiste der Schnellansicht des jeweiligen Übergangs-Assistenten zur Verfügung.

Beim Generieren des Layouts werden zwei feste Quellen (Webservices) eingebunden:

Prefill Data
Lädt beim Öffnen des Assistenten die aktuellen Daten der Aufgabe und stellt sie dem Layout zur Verfügung.
Submit Data
Speichert die im Assistenten vorgenommenen Änderungen beim Bestätigen der Aktion.

Wenn zusätzliche Eigenschaften (z. B. Beschreibung) bearbeitet werden sollen, müssen diese aus der Quelle Submit Data per Drag & Drop in das Layout eingefügt werden. Des Weiteren ist es erforderlich, dass diese Eigenschaften unter Attribute im Dialog des Übergangs-Assistenten vorab erfasst wurden. Ein vollständiges Beispiel, wie du neue Eigenschaften dem Layout hinzufügst findest du in dem unten stehenden GIF.

Danger

Die Quellen (Webservices) Prefill Data und Submit Data dürfen nicht verändert werden, damit der Assistent weiterhin korrekt funktioniert.
Ebenso darf der Pfad Context > OuterContext > TaskState nicht angepasst werden, da andernfalls der Statuswechsel nicht mehr durchgeführt werden kann.