Über die Werte von Musterparametern kann gesteuert werden, ob
ein Projekt erstellt wird, wenn ein Benutzer eines Musters eine Instanz eines benutzerdefinierten
Musters generiert.
Bevor Sie beginnen:
Führen Sie folgende Task aus:
Sie können steuern, ob Projekte, die als Quellendateien in einem benutzerdefinierten
Muster ausgewählt sind, mithilfe von XPath-Ausdrücken erstellt werden.
Referenzinformationen zu XPath einschließlich Informationen zu XPath-Funktionen finden Sie in der
W3C
XPath 1.0 Spezifikation.
- Zusätzlich zu den Funktionen der XPath 1.0-Spezifikation ist auch die Funktion
pp:getValue() enthalten. Die Funktion pp:getValue() akzeptiert die Parameter-ID eines Musterparameters und gibt den Wert dieses Musterparameters zurück. So ermitteln Sie die Parameter-ID eines Musterparameters:
- Klicken Sie auf der Musterkonfiguration tab des Musterauthoringeditors doppelt auf einen Parameter oder wählen Sie den Parameter aus und klicken Sie auf Bearbeiten. Das Fenster Parameter bearbeiten wird geöffnet.
- Klicken Sie auf die Registerkarte Transformieren. Die Parameter-IDs der Musterparameter werden in der Spalte Parameter-ID der Tabelle 'Musterparameter' angezeigt.
- Wenn ein Musterbenutzer eine Musterinstanz erstellt hat, werden zunächst alle Transformationsausdrücke verarbeitet, bevor Java™- bzw. PHP-Code hinzugefügt werden kann, um Musterinstanzen zu verändern. Die Verarbeitungsschritte zur Transformation der Musterparameter finden in folgender Reihenfolge statt:
- Jeder Parameter, der einen XPath-Transformationsausdruck aufweist, wird ausgewertet.
- Der Wert jedes Parameters, der einen XPath-Transformationsausdruck aufweist, wird durch das Ergebnis seiner Auswertung aktualisiert. Dadurch wird der vom Musterbenutzer eingegebene Wert überschrieben.
- Die Parameter werden von oben nach unten in der Reihenfolge ausgewertet, in der sie auf der Registerkarte Musterkonfiguration tab des Musterauthoringeditors aufgeführt sind.
So steuern Sie die Projekterstellung mithilfe eines XPath-Ausdrucks:
- Öffnen Sie den Musterauthoring-Editor.
- Klicken Sie auf der Registerkarte Quelle im Bereich 'Quellendateien
auswählen' doppelt auf das Projekt, das Sie steuern möchten, oder wählen Sie das Projekt aus und
klicken Sie auf Bearbeiten. Das Fenster Projekt bearbeiten wird geöffnet.
- Klicken Sie auf die Registerkarte Erstellen. Erstellen Sie einen
XPath-Ausdruck für das ausgewählte Projekt:
- Zur Auswahl einer Funktion:
- Erweitern Sie im Abschnitt 'Funktionen' die Einträge Boolesch, Zahl, Muster oder Zeichenfolge und klicken Sie dann auf eine Funktion. Die Funktion wird im Feld Funktionsname angezeigt.
- Klicken Sie auf Verwenden. Die Funktion wird an der aktuellen Cursorposition in das Feld Ausdruck eingefügt.
- Zur Auswahl eines Operators:
- Klicken Sie im Abschnitt 'Operatoren' auf einen Operator. Der Operator wird im Feld Operator angezeigt.
- Klicken Sie auf Verwenden. Der Operator wird an der aktuellen Cursorposition in das Feld Ausdruck eingefügt.
- Zur Auswahl eines Musterparameters:
- Klicken Sie in der Tabelle 'Musterparameter' auf einen Musterparameter. Die ID des ausgewählten Parameters aus der Spalte Parameter-ID der Tabelle 'Musterparameter' wird im Feld Parameter-ID angezeigt.
Sie können keinen Musterparameter auswählen, der einen Tabellentyp verwendet.
- Klicken Sie auf Verwenden. Die Parameter-ID wird an der aktuellen Cursorposition in das Feld Ausdruck eingefügt.
- Der Ausdruck im Feld Ausdruck kann auch direkt bearbeitet werden.
- Wiederholen Sie, falls erforderlich, die Aktionen in Schritt
3, um den XPath-Ausdruck zu erstellen.
- Sie können jetzt wählen, ob Sie den Ausdruck testen möchten:
- Informationen zum Testen des Ausdrucks finden Sie im Abschnitt Projekterstellungsausdruck testen.
- Wenn Sie den Ausdruck ohne Test übernehmen möchten, klicken Sie auf OK.
Das Fenster Projekt bearbeiten wird geschlossen.