Variable aktualisieren
Mit dieser Aktion (Abbildung unten) wird der Wert eine bestehenden benutzerdefinierten Variablen, die Sie durch Auswahl der Variablen in der Aktion identifizieren, ($area in der Abbildung unten) aktualisiert. Bei dem zu aktualisierenden Wert handelt es sich um einen der folgenden:
•das Ergebnis der Auswertung eines von Ihnen eingegebenen XPath-Ausdrucks
•ein Aktionsgruppenergebnis
•ein Unterseitenergebnis
Bei der zu aktualisierenden Variablen kann es sich um jede beliebige benutzerdefinierte Variable handeln, die sich an dem Punkt, an dem die Aktion "Variable aktualisieren" ausgelöst wird, im Geltungsbereich befindet. Dazu gehören: Globale benutzerdefinierte Variablen; in den Aktionen Let und Try/Catch Ausnahmen definierte Variablen; Variablen in Aktionsgruppen; die Parameter einer Unterseite; und die Parameter und Variablen von Steuerelementvorlagen. (Beachten Sie, dass die Aktion "Variable aktualisieren" nicht auf Schleifenvariablen angewendet werden kann.)
Doppelklicken Sie auf das (grün umrandete) Feld und geben Sie entweder den Namen Ihrer benutzerdefinierten Variablen ein oder wählen Sie ihn aus der angezeigten Liste aus.
Wenn zur Laufzeit keine Variable des angegebenen Namens gefunden wird, wird eine entsprechende Fehlermeldung sowie eine Liste der Variablen, die sich an diesem Punkt im Geltungsbereich befinden und eventuell aktualisiert werden könnten, angezeigt.
| Anmerkung: | Durch die Applikation definierte Variablen (wie z.B. dynamische lokale Variablen und statische globale Variablen) können von der Aktion "Variable aktualisieren" nicht geändert werden. |
Die Option "XPath"
Mit der Option XPath können Sie einen statischen Wert eingeben oder mittels XML-Struktur-Nodes einen dynamischen Wert generieren. So werden in der Abbildung unten z.B. die Werte von zwei Nodes miteinander multipliziert (rot umrandet). Der erzeugte Wert wird an die benutzerdefinierte Variable $area übergeben.
Die Option "Aktionsgruppenergebnis"
Mit der Option Aktionsgruppenergebnis (siehe Abbildung unten) wird als Wert der Variablen das Ergebnis der Aktionsgruppe definiert. In der Abbildung unten haben wir der Variablen den Namen $area gegeben und ihr als Wert das Ergebnis der Aktionsgruppe mit dem Namen RectangleArea (unten rot umrandet) zugewiesen. (Alle vorhandenen Aktionsgruppen stehen in der Auswahlliste der Variablen zur Verfügung). Klicken Sie zur Bearbeitung der Aktionsgruppe auf die Bearbeiten-Schaltfläche (grün umrandet). Außerdem haben wir die Werte von zwei Parametern als dynamisch definiert; sie erhalten ihre Werte aus XML-Struktur-Nodes.
Über die Aktion Rückgabewert gibt die Aktionsgruppe ein Ergebnis zurück (siehe Abbildung unten). In der Abbildung unten werden z.B. zwei Parameter ($length und $width) deklariert; in der Aktion Rückgabewert multiplizieren wir die Werte der beiden Parameter miteinander. Beachten Sie, dass die Werte der Parameter zur Laufzeit aus den dafür in der Let-Aktion als Werte der Parameter der Let-Aktion (siehe Abbildung oben) definierten XML-Struktur-Nodes abgerufen werden.
Die Option "Unterseitenergebnis"
Mit der Option Unterseitenergebnis (Abbildung unten) wird als Wert der Variablen des Ergebnis einer Unterseite definiert. Dadurch kann eine Berechnung auf einer anderen Seite durchgeführt werden. Wenn eine Unterseite geschlossen wird, kann optional ein Ergebnis zurückgegeben werden. Dieses Ergebnis ist das Unterseitenergebnis, das als Wert der in der Aktion "Variable aktualisieren" definierten Variablen verwendet wird. In der Abbildung unten wird in der Aktion "Variable aktualisieren" z.B. eine Variable namens $area definiert. Ihrem Wert wird das Ergebnis der Unterseite mit dem Namen RectangleArea zugewiesen.
Die Eigenschaften der Option Unterseitenergebnis sind dieselben wie die der Aktion Gehe zu Unterseite, wo Sie eine nähere Beschreibung dazu finden.
Zur Laufzeit wird bei Ausführung der Let-Aktion die Unterseite geöffnet, die wie in ihrem Design definiert, verarbeitet wird. Die Unterseite wird geschlossen, wenn die Aktion Unterseite schließen ausgeführt wird. Diese Aktion hat einen optionalen Rückgabewert, der mittels eines XPath-Ausdrucks berechnet wird (siehe Abbildung unten). Dieser zurückgegebene Wert wird an die Let-Aktion übergeben und als Wert der in der Let-Aktion verwendeten Variablen verwendet.
MobileTogether-Erweiterungsfunktionen
MobileTogether enthält eine Reihe von XPath-Erweiterungsfunktionen, die speziell für die Verwendung in MobileTogether-Designs erstellt wurden. Einige davon können bei bestimmten Aktionen sehr nützlich sein. So erhalten Sie etwa mit mt-available-languages() die Sprachen, in denen die Lösung zur Verfügung steht. Diese Funktion könnte z.B. mit der Aktion Meldungsfeld verwendet werden. Wenn eine Funktion für diese Aktion besonders relevant ist, ist sie unten aufgelistet. Eine vollständige Liste aller Erweiterungsfunktionen und mit Beschreibungen finden Sie im Kapitel MobileTogether-Erweiterungsfunktionen.