Parametergruppen aktivieren

In einem benutzerdefinierten Muster kann abhängig von den Werten der Musterparameter gesteuert werden, welche Parametergruppen aktiviert sind.

Vorbereitungen

Führen Sie die folgenden Tasks aus:

Informationen zu dieser Task

Wenn Musterbenutzer eine Instanz eines benutzerdefinierten Musters konfigurieren, werden standardmäßig alle im benutzerdefinierten Muster definierten Parametergruppen aktiviert. Die aktivierten Parametergruppen sowie die darin befindlichen Musterparameter werden auf der Seite zum Konfigurieren von Parametern für die Musterbenutzer angezeigt. Mit einem XPath-Ausdruck können Sie festlegen, ob eine Parametergruppe in einer Instanz eines benutzerdefinierten Musters aktiviert ist:
  • Wenn die Auswertung des Ausdrucks den Booleschen Wert true (Wahr) ergibt, ist die Parametergruppe aktiviert. Wenn ein Musterbenutzer eine Instanz eines benutzerdefinierten Musters konfiguriert, werden die Parametergruppe sowie die darin befindlichen Musterparameter auf der Seite zum Konfigurieren von Parametern für die Musterbenutzer angezeigt. Mit den Werten der Musterparameter in den aktivierten Parametergruppen werden die Zieleigenschaften des benutzerdefinierten Musters gefüllt.
  • Wenn die Auswertung des Ausdrucks den Booleschen Wert false (Falsch) ergibt, ist die Parametergruppe inaktiviert. Wenn ein Musterbenutzer eine Instanz eines benutzerdefinierten Musters konfiguriert, wird die Parametergruppe auf der Seite zum Konfigurieren von Parametern nicht für die Musterbenutzer angezeigt. Musterparameter in inaktivierten Gruppen werden für Musterbenutzer nicht angezeigt und die Zieleigenschaften in einer Instanz des benutzerdefinierten Musters werden nicht mit den Werten dieser Parameter gefüllt.
Wird kein XPath-Ausdruck für eine Parametergruppe eingegeben, wird die Parametergruppe aktiviert. XPath-Referenzinformationen, einschließlich Informationen zu XPath-Funktionen finden Sie unter W3C XPath 1.0 Specification.
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:
  1. Doppelklicken Sie im Mustererstellungseditor auf der Registerkarte Musterkonfiguration auf eine Parametergruppe oder wählen Sie eine Parametergruppe aus und klicken Sie auf Bearbeiten. Das Fenster Gruppe bearbeiten wird geöffnet.
  2. Klicken Sie auf die Registerkarte Visibility (Anzeige). Die Parameter-IDs der Musterparameter werden in der Spalte Parameter-ID der Tabelle 'Musterparameter' angezeigt. Informationen zum Ändern von Parameter-IDs finden Sie unter Musterparameter-IDs ändern.

Vorgehensweise

So legen Sie mit einem XPath-Ausdruck fest, ob eine Musterparametergruppe aktiviert ist:

  1. Doppelklicken Sie auf der Registerkarte Musterkonfiguration des Mustererstellungseditors auf die Parametergruppe, die Sie steuern möchten, oder wählen Sie die Parametergruppe aus und klicken Sie auf Bearbeiten.
    Das Fenster Gruppe bearbeiten wird geöffnet.
  2. Klicken Sie auf die Registerkarte Aktivieren . Erstellen Sie einen XPath-Ausdruck für die ausgewählte Parametergruppe:
    • Zur Auswahl einer Funktion:
      1. 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.
      2. Klicken Sie auf Verwenden. Die Funktion wird an der aktuellen Cursorposition in das Feld Ausdruck eingefügt.
    • Zur Auswahl eines Operators:
      1. Klicken Sie im Abschnitt 'Operatoren' auf einen Operator. Der Operator wird im Feld Operator angezeigt.
      2. Klicken Sie auf Verwenden. Der Operator wird an der aktuellen Cursorposition in das Feld Ausdruck eingefügt.
    • Zur Auswahl eines Musterparameters:
      1. 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.

      2. Klicken Sie auf Verwenden. Die Parameter-ID wird an der aktuellen Cursorposition in das Feld Ausdruck eingefügt. Informationen zum Ändern von Parameter-IDs finden Sie unter Musterparameter-IDs ändern.
    • Der Ausdruck im Feld Ausdruck kann auch direkt bearbeitet werden.
  3. Wiederholen Sie die Aktionen in Schritt 2nach Bedarf, um Ihren XPath-Ausdruck zu erstellen.
  4. Sie können jetzt wählen, ob Sie den Ausdruck testen möchten:
    • Informationen zum Testen Ihres Ausdrucks finden Sie unter Gruppenaktivierungsausdruck testen.
    • Wenn Sie den Ausdruck ohne Test übernehmen möchten, klicken Sie auf OK. Das Fenster Gruppe bearbeiten wird geschlossen.