Platzhalter in einem Muster verwenden
Sie können Platzhalter in Ihrem Muster definieren, um Eigenschaften (Projekteigenschaften, benutzerdefinierte Eigenschaften) wie Name, Datum oder Notizen, die dann beim Anwenden des Musters automatisch im Namen oder in die Beschreibung eingefügt werden.
Im Abschnitt Verwendbare Platzhalter finden Sie eine Liste der Platzhalter, die verwendet werden können.
Muster mit Platzhalter anlegen
- Öffnen Sie über das Auge das Fenster Einstellungen, indem Sie auf den Befehl Einstellungen anzeigen klicken.
Die Muster befinden sich im Package Einstellungen/ Musterkatalog.
- Öffnen Sie das Package Musterkatalog und wählen dort ein Package aus oder legen ein neues Package an.
- Über das Kontextmenü des Packages legen Sie über Weitere anlegen/ Muster… ein neues Muster an.
- Geben Sie dem Muster einen Namen.
- Wählen Sie einen Stereotyp aus.
Der Stereotyp richtet sich immer nach dem Artefakt, auf das das Muster später angewendet werden soll. Möchten Sie bspw. das Muster auf eine Aktivität anwenden, wählen Sie im Dialog Muster anlegen den Stereotyp Activity. Das Muster wird dann im Kontextmenü einer Aktivität zur Verfügung gestellt.
- Selektieren Sie das Muster und legen über das Kontextmenü ein weiteres Package an.
- Geben Sie als Namen einen „Platzhalter“ ein, der später über das Muster ersetzt werden soll.
- Bestätigen Sie mit OK und wechseln Sie in Ihr Projekt.
- Legen Sie dort ein Package an und wählen über das Kontextmenü Muster anwenden/ [angelegte Muster].
- Ersetzen Sie den Platzhalter unter Namensersetzungen und bestätigen Sie mit OK.
Haben Sie im Muster Kindelemente definiert, werden diese Elemente im Dialog Musterkonfiguration nicht angezeigt.
Im Projekt wird ein neues Package angelegt. Der Name des Packages wird – gemäß der Musterkonfiguration – aus dem Namen des Projektes und einem benutzerdefinierten Platzhalter gebildet.
Verwendbare Platzhalter
Sie können in Muster auch Platzhalter verwenden, die Sie später beim Anwenden des Musters mit konkreten Namen ersetzt werden. Es gibt drei Platzhalter, die vom System generiert und ersetzt werden: ID des Elements, Name des Elements und das Datum, wann das Element erstellt wurde.
So haben Sie die Möglichkeit
- die generierte ID eines Elements in den Namen,
- den Namen und die generierte ID des neuen Elements in den Beschreibungstext sowie
- den Zeitpunkt (Datum und Uhrzeit) des Erstellens
zu übernehmen.
Ab Version 7.6 können drei weitere Platzhalter verwendet werden, um den Namen von bestehenden Elementen beim Anwenden des Musters ebenfalls verwenden zu können.
- der Namen des Elements, auf dem das Muster angewendet wurde, wird im Namen übernommen
- wenn das Element einem anderen Element untergeordnet ist (Element befindet sich in einem Package), dann wird der Name des Packages übernommen
- beim Anwenden des Musters, wird explizit ein Zielelement ausgewählt, dessen Name übernommen werden kann
Wenn Sie Platzhalter formatieren, achten Sie darauf, dass der gesamte Platzhalter die Formatierung erhält, da dieser sonst nicht funktioniert.
| Automatisch generierte Platzhalter | Bemerkung |
| Name der Organisation = {$organizationName} | |
| Id der Organisation = {$organizationId} | |
| Name des Projektes = {$projectName} | |
| Id des Projektes = {$projectId} | |
| aktuelle Datum mit Uhrzeit = {$timestamp} | |
| aktuelle Datum = {$shortDate} | |
| ID eines Elements = {$identifier} | |
| Name eines Elements = {$name} | |
| aktuelle Benutzer = {$userName} | |
| ab Version 7.6 Name des Kontextelements = {$contextName} |
Name des Elements, auf dem das Muster angewendet wurde |
| ab Version 7.6 Name des Vaterelements = {$contextParentName} |
Name des übergeordneten Elements (Package, Aktivität), auf dem das Muster angewendet wird |
| ab Version 7.6 Name des Zielelements {$targetName} |
Name des Elements, welches als Ziel (-Package, Aktivität) ausgewählt wird |
Platzhalter mit eigenen Ersetzungen
Name eines Artefaktes = {Title}
Beispiel: Muster mit Platzhalter definieren und anwenden
- Erstellen Sie ein neues Muster über das Kontextmenü eines Packages mit dem Befehl Muster anlegen/Muster.
- Benennen Sie das Muster und geben unter Stereotyp des Kontext-Elements den Stereotyp an, auf den später das Muster angewendet werden soll.
- Legen Sie über das Kontextmenü des Musters Elemente an, die das Muster später erstellen soll.
Erstellen Sie im Muster Elemente, die untereinander Beziehungen haben sollen, achten Sie darauf, dass Sie bei der Zuweisung nur die Musterelemente aus dem Muster zuordnen.
- Öffnen Sie den Bearbeitungsdialog des Elements und geben dynamische Platzhalter ins Namensfeld oder im Beschreibungsfeld ein.
- Wenn Sie jetzt das Muster anwenden, brauchen Sie lediglich den Namen Anforderung überschreiben und das Package auswählen, welches als Ablageort verwendet werden soll. Standardmäßig ist das Package ausgewählt, auf das Sie das Muster angewendet haben.
- Klicken Sie OK.
Das Muster legt die Elemente an und überschreibt die definierten Platzhalter mit den Werten.
