Verwenden einer Server-Aktionsbibliothek
Eine Server-Aktionsbibliothek wird verwendet, um von einer Lösung aus aufgerufen zu werden. Dabei können zwei Situationen auftreten:
•Wenn eine Aktionsgruppe einer Server-Aktionsbibliothek so konzipiert ist, dass sie einen Wert an die aufrufende Lösung retourniert, muss der Aufruf mittels einer Let-Aktion erfolgen, da eine Let-Aktion mit einer Variablen, die das Ergebnis der Aktionsgruppe aufnehmen soll (siehe Abbildung unten), definiert wird. Diese Variable kann anschließend innerhalb der aufrufenden Lösung verwendet werden. In der Abbildung unten sehen Sie den Aufruf der ScanFolder-Aktionsgruppe einer Server-Aktionsbibliothek über eine Let-Aktion. Das Ergebnis der Aktionsgruppe wird an die Variable \$FolderReadout der aufrufenden Lösung übergeben.
•Wenn die Aktionsgruppe der Server-Aktionsbibliothek so konzipiert ist, dass sie Aktionen auf dem Server ausführt (d.h. Aktionen, die unabhängig von der aufrufenden Lösung und dem Client-Gerät sind), gibt es keinen Rückgabewert, der an die aufrufende Lösung gesendet werden muss. Die Aktionsgruppe muss daher nur an dem Punkt, an dem sie benötigt wird, aufgerufen werden; eine Let-Aktion ist nicht notwendig. Ziehen Sie die Aktionsgruppe der Server-Aktionsbibliothek in diesem Fall einfach an die Stelle, an der sie bei der Verarbeitung der Aktionen eines Ereignisses ausgeführt werden soll (siehe Abbildung unten).
Aufrufen der Aktionsgruppe einer Server-Aktionsbibliothek
Um in der Hauptlösung einen Server-Aktionsbibliotheksaufruf einzurichten, gehen Sie folgendermaßen vor:
1.Klicken Sie im Fenster "Dateien" mit der rechten Maustaste auf den Eintrag Server-Aktionsbibliotheken und wählen Sie im daraufhin angezeigten Kontextmenü den Befehl Server-Aktionsbibliothek hinzufügen (siehe Abbildung unten). Verwenden Sie alternativ dazu den Menübefehl Umgestalten | Server-Aktionsbibliothek hinzufügen.
2.Navigieren Sie im daraufhin angezeigten Dialogfeld zur gewünschten Server- Aktionsbibliothek und klicken Sie auf Öffnen. Daraufhin wird die Server-Aktionsbibliothek zu Liste der Server-Aktionsbibliotheken hinzugefügt und ihre Aktionsgruppen stehen nun für Aufrufe zur Verfügung.
3.Gehen Sie zum Dialogfeld "Aktionen" des Ereignisses, für das Sie die Server-Aktionsbibliothek verwenden möchten.
4.Im Dialogfeld "Aktionen" stehen alle Aktionsgruppen der hinzugefügten Server-Aktionsbibliothek für die Verwendung zur Verfügung (siehe Abbildung unten). Beachten Sie, dass Aktionsgruppen der Server-Aktionsbibliothek ein anderes Symbol als lokale Aktionsgruppen haben.
5.Ziehen Sie die Aktionsgruppe an die gewünschte Stelle (siehe erste Abbildung am Anfang dieses Kapitels).
6.Nachdem Sie die Lösung gespeichert haben, stellen Sie sie auf demselben MobileTogether Server, auf dem sich auch die Server-Aktionsbibliothek befindet, bereit.
Wichtige Punkte
Beachten Sie zur Verwendung von Server-Aktionsbibliotheken die folgenden Punkte:
•Sie können mehrere Server-Aktionsbibliotheken zu einer Lösung hinzufügen. Die Aktionsgruppen aller hinzugefügten Server-Aktionsbibliotheken stehen automatisch für die Verwendung in der Lösung zur Verfügung.
•Wenn Sie an einer Server-Aktionsbibliothek eine wichtige Änderung vornehmen, z.B. einen Parameter umbenennen, müssen Sie die aufrufende Lösung entsprechend ändern.
•Wenn Sie eine Server-Aktionsbibliothek ändern, müssen Sie die Server-Aktionsbibliothek im Fenster "Dateien" der Lösung neu laden, damit die Änderungen in der aufrufenden Lösung und für Simulationen zur Verfügung stehen.
Beispiel
In unserer Beispieldatei, MainSolution.mtd, geschieht Folgendes, wenn der Benutzer in der Auswahlliste Scan this folder (siehe Abbildung unten) eine Sammlung auswählt:
1.Der Sammlungsname (Books, Films oder Music) wird in der Hauptlösung im Seitenquellen-Node \$PERSISTENT/Root/UserSelection gespeichert, nachdem er in der Auswahlliste der Lösung ausgewählt wurde (siehe erste Abbildung in diesem Kapitel und Abbildung unten).
2.Die Aktionsgruppe ScanFolder der Server-Aktionsbibliothek ServerLibrary.mtd wird aufgerufen und der von Benutzer ausgewählte Sammlungsname wird als Wert des Parameters \$FolderToScan übergeben (siehe erste Abbildung in diesem Kapitel).
3.Die Aktionsgruppe wird ausgeführt und der Ordner, der dem gesendeten Namen der Sammlung entspricht, wird mit Hilfe der Aktion Ordner lesen der Aktionsgruppe der Server-Aktionsbibliothek durchsucht (siehe Kapitel Erstellen einer Server-Aktionsbibliothek).
4.Die beim Durchsuchen erzeugte Datenstruktur wird an die aufrufende Lösung MainSolution.mtd zurückgegeben und in der Variablen \$FolderReadout der aufrufenden Lösung gespeichert (siehe erste Abbildung oben in diesem Kapitel).
5.Die Datenstruktur in \$FolderReadout ersetzt die Struktur in \$XML1.
6.Die Seitenquelle \$XML1 wird als Tabelle angezeigt (Abbildung unten).
