Aktionen definieren
Aktionen für Aktivitäten und Projektelemente
Folgende Aktionen stehen Ihnen für Aktivitäten, Artefakte und Elementtypen zur Verfügung:
Angemeldeten Benutzer in benutzerdefinierte Eigenschaft setzen
Beim Zustandsübergang wird der Benutzer, der den Zustandswechsel auslöst, in einer benutzerdefinierten Eigenschaft gespeichert.
Die Aktion können Sie mehrfach verwenden.
Beispiel: Setzt den angemeldeten Benutzer in der benutzerdefinierten Eigenschaft ‘Autor‘.
Eigenschaft Wählen Sie die Eigenschaft aus. Die Eigenschaft muss vom Typ Text sein.
Bearbeiter benachrichtigen
Beim Zustandswechsel wird an denjenigen, der das Element angelegt oder bearbeitet hat, eine Mail gesendet. Die Aktion können Sie mehrfach verwenden.
Beispiel: Mitarbeiter mit ‘Benutzerdefinierter Text‘ benachrichtigen, welcher das Element ‘erstellt‘ hat.
Standardtext Per Klick kommen Sie in einen weiteren Dialog, über den Sie eine E-Mail vorbereiten können, die dann an Mitarbeiter versendet werden kann. Den Text können Sie mit Platzhaltern versehen, um bspw. einen Link zum Element, das Projekt und weitere Eigenschaften zu übermitteln. Nutzen Sie dazu die Felder Platzhalter und Eigenschaften.
‘…‘ Geben Sie an, ob E-Mails an den Benutzer gesendet werden, der das Element angelegt hat oder an die, die das Element seitdem bearbeitet haben. Welche Benutzer die Bearbeiter sind, können Sie in der Historie des jeweiligen Elements sehen.
Dokument generieren (ab Version 7.8)
Beim Zustandsübergang wird das Element in ein Dokument generiert. Die dafür verwendete Dokumentvorlage wird in den Eigenschaften des Stereotyps hinterlegt.
Beispiel: Dokumentvorlagenbefehl ‘Anforderung mit ID, Name und Zustand‘ verwenden.
[…] Wählen Sie eine Dokumentvorlage aus.
Eigenschaft aus Projekt-Eigenschaften kopieren (ab Version 9.1)
Beim Zustandsübergang wird ein Wert einer Projekteigenschaft in eine bestehende Eigenschaft eines Elements kopiert. Dabei müssen die Datentypen der Eigenschaften von Ziel- und Quellelement nicht zwingend identisch sein. Wenn Sie Aufzählungswerte kopieren möchten, stellen Sie sicher, dass die Eigenschaftswerte namentlich identisch sind.
Beispiel: Setze ‘Anforderung‘ ‘Hyperlink‘ = ‘Hyperlink‘.
Entity Setzen Sie den Elementtyp, der die kopierte Eigenschaft erhalten soll.
Eigenschaft Wählen Sie die Eigenschaft aus, die kopiert werden soll.
Projekt-Eigenschaft Wählen Sie die Projekteigenschaft aus, die kopiert werden soll.
Eigenschaft nach Projekt-Eigenschaften kopieren (ab Version 9.1)
Beim Zustandsübergang wird ein Wert eines Elements in eine bestehende Projekteigenschaft kopiert. Dabei müssen die Datentypen der Eigenschaften von Ziel- und Quellelement nicht zwingend identisch sein. Wenn Sie Aufzählungswerte kopieren möchten, stellen Sie sicher, dass die Eigenschaftswerte namentlich identisch sind.
Beispiel: Setze ‘Anforderung‘ ‘Hyperlink‘ = ‘Hyperlink‘.
Projekt-Eigenschaft Wählen Sie die Projekteigenschaft aus, die kopiert werden soll.
Entity Setzen Sie den Elementtyp, der die kopierte Eigenschaft erhalten soll.
Eigenschaft Wählen Sie die Eigenschaft aus, in die kopiert werden soll.
Eigenschaft kopieren (ab Version 7.6)
Beim Zustandsübergang wird ein Eigenschaftswert eines Elements in eine andere Eigenschaft eines anderen Elements kopiert. Dabei müssen die Eigenschaften von Ziel- und Quellelement nicht zwingend identisch sein. So ist es bspw. möglich, den Planaufwand einer Anforderung (was eine Zahl ist) in ein Beschreibungsfeld (Text) zu kopieren. Die Aktion kann auch projektübergreifend definiert werden.
Wenn der Wert einer Zieleigenschaft aus mehreren Werten ermittelt wird, wie bspw. der Planaufwand einer Anforderung, der untergeordnete Anforderungen besitzt, dann kann der summierte Planaufwand in eine Zieleigenschaft kopiert werden.
Handelt es sich stattdessen um Texte, dann werden diese kommasepariert in die Zieleigenschaft kopiert. Zum Beispiel, wenn Sie die Namen von abgeleiteten Anforderungen in das Beschreibungsfeld der Basisanforderung kopieren möchten.
Beispiel: Setze ‘Anforderung‘ ‘Planaufwand‘ = ‘Abgeleitete Anforderungen(Beziehungen).Abgeleitete Anforderung.Planaufwand‘.
Entity Wählen Sie einen Elementtypen aus.
Eigenschaft Wählen Sie die Eigenschaft aus, die kopiert werden soll.
Eigenschaft Wählen Sie die Eigenschaft des Zielelements aus, in die die Eigenschaft kopiert werden soll.
Eigenschaft setzen
Beim Zustandsübergang wird ein Eigenschaftswert durch einen anderen Wert ersetzt.
Beispiel: Setze ‘Priority‘ = ‘hoch‘.
Eigenschaft Wählen Sie die Eigenschaft aus, deren Wert durch einen anderen ersetzt werden soll.
‘…‘ Geben Sie hier den Wert ein, der übernommen werden soll. Der Wert muss in den Eigenschaften angelegt und vom Typ Text, Boolean, Datum oder Aufzählung sein. Beachten Sie außerdem die genaue Schreibweise beim Eintragen des Wertes.
Element benachrichtigen
Beim Zustandswechsel sendet das Element an alle Elemente, die mit ihm in Beziehung stehen, ein Ereignis.
Die Aktion können Sie mehrfach verwenden.
Beispiel: Sendet von ‘Anforderung‘ an alle Elemente mit der Beziehung ‘Übergeordnete Anforderungen(Beziehung).Übergeordnete Anforderung‘ das Ereignis ‘Realisierung beendet‘.
ContextEntity Wählen Sie den Stereotypen aus, für den die Aktion gelten soll.
NavigationPath Wählen Sie eine gerichtete Beziehung (z.B. Ableitungsbeziehung, Konfliktbeziehung etc.) aus.
Event Tragen Sie ein Ereignis ein, das gesendet werden soll. Die existierenden Ereignisse können Sie dem Zustandsautomaten entnehmen.
Element verschieben
Beim Zustandsübergang wird das Element in ein anderes Package verschoben.
Beispiel: Element nach ‘Archiv‘ verschieben (relatives Package/ Verzeichnis-Pfad).
‘…‘ Geben Sie hier den Pfad zum neuen Ablageort ein. Der Pfad muss vorher als benutzerdefinierte Eigenschaft vom Typ Link in den Eigenschaften angelegt sein. Beachten Sie außerdem die genaue Schreibweise.
Erweiterungsfunktion ausführen
Beim Zustandsübergang wird eine Erweiterungsfunktion ausgeführt.
Die Aktion können Sie mehrfach verwenden.
Beispiel: Erweiterungsfunktion ‘Identifier aktualisieren‘ ausführen.
‘…‘ Geben Sie hier den Namen der Erweiterungsfunktion an. Beachten Sie die genaue Schreibweise.
Projektgruppe benachrichtigen
Beim Zustandswechsel wird an alle, die einer bestimmten Projektgruppe angehören, eine Mail gesendet. Die Aktion können Sie mehrfach verwenden. Die Aktion setzt voraus, dass im Service-Manager in der Registerkarte E-Mails ein E-Mail Service eingerichtet und zu den Projektmitarbeitern, die der Projektgruppe angehören, eine gültige E-Mailadresse hinterlegt ist.
Beispiel: ‘Projektmanager‘ per E-Mail mit ‘Benutzerdefinierter Text‘ benachrichtigen.
‘…‘ Wählen Sie aus der Liste eine Projektgruppe aus.
Standardtext Per Klick kommen Sie in einen weiteren Dialog, über den Sie eine E-Mail vorbereiten können, die dann an Mitarbeiter versendet werden kann. Den Text können Sie mit Platzhaltern versehen, um bspw. einen Link zum Element, das Projekt und weitere Eigenschaften zu übermitteln. Nutzen Sie dazu die Felder Platzhalter und Eigenschaften.
Projektmitarbeiter benachrichtigen
Beim Zustandswechsel wird an einen Projektmitarbeiter eine Mail gesendet. Die Aktion können Sie mehrfach verwenden. Die Aktion setzt voraus, dass im Service-Manager in der Registerkarte E-Mails ein E-Mail Service eingerichtet und zu den Projektmitarbeitern eine gültige E-Mailadresse hinterlegt ist.
Beispiel: ‘Armin Röder‘ mit ‘Benutzerdefinierter Text‘ benachrichtigen.
‘…‘ Wählen Sie hier einen Projektmitarbeiter aus.
Standardtext Per Klick kommen Sie in einen weiteren Dialog, über den Sie eine E-Mail vorbereiten können, die dann an den Mitarbeiter versendet werden kann. Den Text können Sie mit Platzhaltern versehen, um bspw. einen Link zum Element, das Projekt und weitere Eigenschaften zu übermitteln. Nutzen Sie dazu die Felder Platzhalter und Eigenschaften.
Revision für Referenzen anlegen
Beim Zustandswechsel werden alle Elemente, die mit dem Element oder der Aktivität in Beziehung stehen, versioniert. Die Aktion können Sie mehrfach verwenden.
Beispiel: Revision von ‘Anforderung‘ für alle Elemente mit der Beziehung ‘Testfall-Anforderung(Prüfbeziehungen)‘ anlegen
ContextEntity Wählen Sie den Elementtyp aus.
NavigationPath Wählen Sie eine Beziehung aus.
Revision anlegen
Beim Zustandswechsel wird das Element bzw. die Aktivität versioniert.
Beispiel: Legt eine Revision vom Element an
Sich selbst erneut benachrichtigen
Beim Zustandswechsel wird ein Ereignis an eine Aktivität oder das Element gesendet. Die Aktion können Sie nutzen, wenn Sie bspw. eine Bedingung für untergeordnete Aktivitäten bzw. Kindelemente einer Anforderung definiert haben und das übergeordnete Element erst den Zustand ändern soll, wenn sich alle Kindelemente in einem definierten Zustand befinden. Die Aktion können Sie mehrfach verwenden.
Beispiel: Sendet das Ereignis ‘Zustimmen‘ an sich selbst.
Event Wählen Sie das Ereignis aus, das gesendet werden soll.
Verzeichnis auf Laufwerk anlegen
Beim Zustandswechsel wird in einem Verzeichnispfad ein Ordner angelegt. Der Pfad zum Verzeichnis wird über eine benutzerdefinierte Eigenschaft angegeben.
Beispiel: Das Verzeichnis ‘Kundenanforderungen‘ anlegen
Pfad-Eigenschaft Wählen Sie eine benutzerdefinierte Eigenschaft vom Typ Text aus.
zugeordnete Projektmitarbeiter benachrichtigen
Beim Zustandswechsel wird an die zugeordneten Projektmitarbeiter eine Mail gesendet. Die Aktion können Sie mehrfach verwenden.
Beispiel: ‘Reviews.Kind Review-Kommentare.Reviewer‘ mit ‘Benutzerdefinierter Text‘ benachrichtigen.
‘…‘Wählen Sie die Beziehung aus, über die die Projektmitarbeiter zugeordnet werden. Damit Beziehungen auswählbar sind, müssen Sie als Projektmitarbeiter zugeordnet sein.
Standardtext Per Klick kommen Sie in einen weiteren Dialog, über den Sie eine E-Mail vorbereiten können, die dann an den Mitarbeiter versendet werden kann. Den Text können Sie mit Platzhaltern versehen, um bspw. einen Link zum Element, das Projekt und weitere Eigenschaften zu übermitteln. Nutzen Sie dazu die Felder Platzhalter und Eigenschaften.
Aktionen für Anforderungen
Folgende Aktion können Sie für Anforderungen definieren:
Aktuellen Benutzer als Mitarbeiter hinzufügen
Beim Zustandsübergang wird der Benutzer, der den Zustandswechsel auslöst, dem Element als Bearbeiter zugeordnet und erscheint in der Registerkarte Mitarbeiter.
Beispiel: Fügt den aktuellen Benutzer als beteiligten Mitarbeiter hinzu
Aktionen nur für Aktivitäten
Folgende Aktionen stehen Ihnen nur für Aktivitäten zur Verfügung:
Aktivität beenden
Die Aktion setzt intern beim Zustandswechsel ein Flag (gesetzt= wahr; nicht gesetzt = falsch), wenn bspw. der Zielzustand ein Endzustand sein soll. Mit dieser Aktion wird verhindert, dass sich die Aktivität verschiebt, wenn sich bspw. eine Vorgängeraktivität – ausgelöst durch eine Berechnung – verändert.
Beispiel: Setze Aktivität beendet = ‘wahr‘.
‘…‘ Wählen Sie einen Wert aus:
- wahr
- falsch
Aktivität beginnen
Die Aktion setzt intern ein Flag (gesetzt= wahr; nicht gesetzt = falsch), wenn die Aktivität begonnen wurde.
Beispiel: Setze Aktivität begonnen = ‘wahr‘.
‘…‘ Wählen Sie einen Wert aus:
- wahr
- falsch
Aktivitätstermine setzen
Mit der Aktion können Sie das Start- und Enddatum einer Aktivität ändern. Verwenden Sie die Aktion, um das Enddatum einer Aktivität anzupassen, wenn bspw. die Aktivität vorzeitig beendet wurde. Die Aktion können Sie mehrfach verwenden.
Beispiel: Setzt ‘den Ist-Beginn‘ der Aktivität auf ‘das aktuelle Datum‘.
‘…‘ Wählen Sie das Datum aus, das geändert werden soll.
- das Ist-Ende das aktuelle Enddatum der Aktivität
- den Ist-Beginn das aktuelle Startdatum der Aktivität
‘…‘ Wählen Sie neue Datum aus, das gesetzt werden soll.
- den Plan-Termin Das Start- bzw.- Enddatum der Aktivität erhält das geplante Datum.
- das aktuelle Datum Die Aktivität erhält als Start- bzw.- Enddatum das aktuelle Datum.
- das aktuelle Datum, wenn der Plan-Termin in der Zukunft liegt Die Aktivität erhält als Startdatum das aktuelle Datum, sofern das Startdatum in der Zukunft liegt. Die Aktivität erhält als Enddatum das aktuelle Datum, sofern das geplante Enddatum in der Zukunft liegt.
Aufwand übernehmen
Beim Zustandswechsel wird der Aufwand aller zugeordneten Anforderungen summiert und der Aktivität als Aufwand übertragen.
Beispiel: Kopiert den Aufwand von den zu realisierenden Anforderungen.
Eingaben/ Ausgaben der Aktivität prüfen
Elemente, die einer Aktivität als Ein- und/ oder Ausgaben zugeordnet sind, werden auf ihren Zustand überprüft und senden an die Aktivität(en) ein Ereignis. So kann ein Zustandswechsel der Aktivität ausgelöst werden, sobald Ein-/ Ausgaben sich bspw. in einem akzeptierten Endzustand befinden.
Beispiel: Sendet an alle Eingaben/ Ausgaben der zugehörigen Aktivitäten das Ereignis ‘Eingabe/Ausgabe prüfen‘.
Event Wählen Sie das Ereignis aus, das gesendet werden soll.
- Eingabe/Ausgabe prüfen Hier wird überprüft, ob sich zugeordnete Elemente im Zustand „akzeptiert“ oder „nicht akzeptiert“ befinden.
- ActivityPortDeleted (BuildIn) Hier wird überprüft, ob zugeordnete Ein- Ausgaben gelöscht wurden.
Termine nach Exchange exportieren (ab Version 6.1)
Beim Zustandswechsel wird das Start- und Enddatum in die Kalender der zugeordneten Mitarbeiter eingetragen.
Beispiel: Exportiert die Termine der Aktivitäten nach Exchange in die Kalender der zugeordneten Mitarbeiter.