Aktionsgruppen mit Parametern
Parameter in Aktionsgruppen werden folgendermaßen verwendet:
•Sie deklarieren Parameter in einer Aktionsgruppe und definieren anschließend Aktionen (in dieser Aktionsgruppe), in denen diese Parameter verwendet werden
•Die Werte von Parametern werden an die Parameter übergeben, wenn die Aktionsgruppe über eine "Aktionsgruppe ausführen"-Aktion aufgerufen wird.
Deklarieren von Parametern in Aktionsgruppen und Definieren von Aktionen, in denen diese Parameter verwendet werden
Deklarieren Sie in der Aktionsgruppe die zur Generierung des gewünschten Ergebnisses benötigten Parameter. Klicken Sie dazu auf das Symbol Parameter hinzufügen (siehe Abbildung unten). Doppelklicken Sie nach Hinzufügung des neuen Parameters an die Stelle rechts vom \$ Symbol des Parameters und geben Sie den Namen des Parameters ein.
In der Abbildung unten sehen Sie eine Aktionsgruppe namens RectangleArea, in der wir zwei Parameter namens \$length und \$width deklariert haben. Die Parameter sind nicht als optional gekennzeichnet, d.h. die Aktionsgruppe muss die Werte für beide Parameter zur Laufzeit erhalten (siehe Bereitstellung von Parameterwerten mit "Aktionsgruppe ausführen" weiter unten), da sonst ein Fehler ausgegeben wird. (Informationen zum Kontrollkästchen Aktionsgruppe finden Sie im Abschnitt Aktionsgruppen mit Aktionsgruppenparametern.)
Die Aktionsgruppe in der Abbildung besteht aus zwei Aktionen:
•einer Node aktualisieren-Aktion, die die beiden Parameter \$length und \$width miteinander multipliziert, um einen Wert zu generieren, mit dem der Node Area aktualisiert wird.
•einer Aktion Meldungsfeld, die ein Meldungsfeld mit dem Wert anzeigt, der durch Multiplikation der beiden Parameter \$length und \$width erzeugt wird.
Beachten Sie, dass wir in der Aktionsgruppe Parameter deklarieren und Aktionen definieren, die diese Parameter verwenden. Die Werte der Parameter werden zur Laufzeit über die Aktion "Aktionsgruppe ausführen" zur Verfügung gestellt.
Variablen in Aktionsgruppen
Sie können in Aktionsgruppen auch Variablen definieren, d.h. Sie können Variablen deklarieren und für jede davon einen Wert definieren. Beachten Sie zu Variablen die folgenden wichtigen Punkte:
•Variablen befinden sich innerhalb der Aktionsgruppe im Gültigkeitsbereich und können nur innerhalb der Aktionsgruppe verwendet werden.
•In der Definition des Werts einer Variablen können bereits zuvor in der Variablenliste deklarierte Parameter und Variablen verwendet werden. Beispiel: Wenn eine Aktionsgruppe die Parameter \$a, \$b, \$c und die Variablen \$x, \$y, \$z (in dieser Reihenfolge) hat, können die folgenden Parameter und Variablen zum Generieren des Werts der Variablen \$y verwendet werden: \$a, \$b, \$c, \$x, (nicht aber \$z).
Bereitstellen von Parameterwerten mit "Aktionsgruppe ausführen"
Sie können für ein Ereignis eine "Aktionsgruppe ausführen"-Aktion definieren und in der Aktion definieren, welche Parameterwerte an die ausgewählte Aktionsgruppe übergeben werden sollen. Bei Auslösung des Ereignisses werden die Parameterwerte übergeben und die Aktionsgruppe führt die in der Aktionsgruppe definierten Aktionen anhand dieser Werte aus.
Um eine Aktion "Aktionsgruppe ausführen" zu erstellen, ziehen Sie die gewünschte Aktionsgruppe (aus dem Bereich Aktionsgruppen) in die Definition der Aktionen eines Ereignisses. Wenn Sie die Maustaste loslassen, wird die Aktionsgruppe als eine "Aktionsgruppe ausführen"-Aktion angezeigt. In der Abbildung unten wurde eine "Aktionsgruppe ausführen"-Aktion für ein BeiSchaltfächenklick-Ereignis definiert. Dazu haben wird die Aktionsgruppe RectangleArea unter das Bei Klick-Ereignis gezogen. Die Auswahl der auszuführende Aktionsgruppe kann in der Auswahlliste "Aktionsgruppe ausführen" (in der Abbildung unten rot umrandet) geändert werden. Klicken Sie auf die Schaltfläche Zusätzliche Optionen, um die ausgewählte Aktionsgruppe zu öffnen. Alternativ dazu können Sie die Aktionsgruppe auch mit Hilfe eines XPath-Ausdrucks auswählen. Bei Verwendung eines XPath-Ausdrucks können Sie die Aktionsgruppe dynamisch auswählen (z.B. durch Abruf des Namens der Aktionsgruppe aus einem Seitenquellen-Node). Das Ergebnis des XPath-Ausdrucks muss ein String sein, der der Name einer im Projekt definierten Aktionsgruppe ist.
Wenn in der aktuell ausgewählten Aktionsgruppe Parameter deklariert wurden, so werden diese in der Aktion "Aktionsgruppe ausführen" angezeigt. Hier geben Sie die Werte an, die zur Laufzeit an Parameter übergeben werden sollen. In der Abbildung oben sehen Sie, dass die Aktionsgruppe RectangleArea zwei Parameter hat: \$length und \$width. Wir haben in die zur Generierung der Werte dieser beiden Parameter verwendeten XPath-Ausdrücke einfache statische Werte (3 und 4) eingegeben. Sie können Werte aber auch dynamisch aus XML-Strukturquellen abrufen oder komplexe XPath-Berechnungen definieren. Wenn die Parameter in der Aktionsgruppe als obligatorisch (nicht optional) deklariert wurden, werden sie hier rot angezeigt, wenn keine Werte bereitgestellt werden.
Zur Laufzeit geschieht Folgendes:
1.Bei Auslösung des Ereignisses werden die Parameterwerte (wie in der Aktion "Aktionsgruppe ausführen" definiert) an die entsprechenden Parameter in der Aktionsgruppe übergeben.
2.Die Aktionen der Aktionsgruppe werden verarbeitet. Wo in diesen Aktionen die deklarierten Parameter der Aktionsgruppe verwendet werden, werden die bereitgestellten Parameterwerte ersetzt.
Arten von Parameterwerten
Parameterwerte in der Aktion "Aktionsgruppe ausführen" können die folgenden Typen haben und entweder direkt eingegeben oder dynamisch (mit Hilfe von XPath-Ausdrücken) generiert werden:
•Atomare Werte, z.B. Strings wie "Altova" oder Zahlen wie 1 oder 2.56
•Arrays: z.B. [(2010,2019), ("StartYear","EndYear")]
•Zuordnungen: z.B. map{"StartYear":2010, "Offices":("Boston","Vienna")}