Altova FlowForce Server 2024 Advanced Edition

Erstellen eines "Hello, World!"-Auftrages

Zur Startseite Zurück Nach oben Weiter

In diesem Beispiel wird gezeigt, wie Sie einen einfachen Auftrag erstellen, der im Browser den Text "Hello, World!" ausgibt. Der Text wird mit Hilfe eines FlowForce-Ausdrucks erstellt. Sie können den Auftrag jederzeit bei Bedarf starten, indem Sie im Browser auf einen Link klicken (d.h. der Auftrag wird als Webservice bereitgestellt).

 

Voraussetzungen

Benötigte Lizenzen: FlowForce Server

Der FlowForce Web Server- und der FlowForce Server-Dienst werden an der konfigurierten Netzwerkadresse und am konfigurierten Port ausgeführt und sind dort empfangsbereit.

Sie haben ein FlowForce Server-Benutzerkonto mit Berechtigungen für einen der Container (standardmäßig hat jeder authentifizierte Benutzer Zugriff auf den in diesem Beispiel verwendeten Container /public).

 

Erstellen des Auftrags

1.Melden Sie sich bei FlowForce Server an und navigieren Sie zum Container /public.

2.Klicken Sie auf Erstellen | Container erstellen und erstellen Sie einen neuen Container namens "Examples".

 

Konventionsgemäß wird in den meisten in dieser Dokumentation beschriebenen Aufträgen der Container /public/Examples verwendet. Sie können Ihre Aufträge auch in jedem beliebigen anderen Container erstellen, doch wenn Sie alle folgenden Tutorial-Beispiele aus dieser Dokumentation genau nachstellen möchten, wird empfohlen den Container /public/Examples anzulegen.

 

3.Klicken Sie im Container /public/Examples auf Erstellen | Auftrag erstellen und geben Sie einen Namen und eine Beschreibung für den Auftrag ein.

helloworld01

4.Fügen Sie einen neuen Ausführungsschritt hinzu, der die vordefinierte Funktion builtin_function/system/compute aufruft.

helloworld02

5.Geben Sie im Feld Ausdruck den Text 'Hello, World', ein und setzen Sie ihn in einfache Anführungszeichen. Der Inhalt dieses Felds bildet einen FlowForce Server-Ausdruck.

helloworld03

6.Deklarieren Sie das Ausführungsergebnis als String.

helloworld04

7.Aktivieren Sie das Kontrollkästchen Diesen Auftrag über HTTP zur Verfügung stellen... und geben Sie als Namen des Diensts "HelloWorldService" ein. Nähere Informationen dazu finden Sie unter Bereitstellen von Aufträgen als Web-Dienste.

fs_ex_hello_05

8.Wählen Sie unter "Anmeldeinformationen" einen vorhandenen Eintrag aus oder definieren Sie lokale Anmeldeinformationen. Nähere Informationen dazu finden Sie unter Anmeldeinformationen.

9.Klicken Sie auf Speichern.

 

Ausführung des Auftrags

Sie haben nun einen Auftrag erstellt, der den String-Wert "Hello, World!" berechnet und diesen als Ergebnis des Auftrags zurückgibt. Um den Auftrag auszuführen, wählen Sie eine der folgenden Methoden:

 

Gehen Sie zur Startseite und klicken Sie anschließend auf Alle aktiven Trigger und Dienste anzeigen. Klicken Sie anschließend auf die in der Spalte "Info" angezeigte URL des Auftrags.

Geben Sie in die Adressleiste des Browsers http://127.0.0.1:4646/service/HelloWorldService ein. Beachten Sie, dass diese URL nur funktioniert, wenn der FlowForce Server-Dienst an der Standard-Host-Adresse und am Standard-Port-Namen empfangsbereit ist. Wenn Sie auf der Konfigurationsseite andere Host- und Port-Einstellungen definiert haben, dann ändern Sie die Adresse entsprechend.

Wenn Sie das optionale Feld Host-Name von FlowForce Server über die Setup-Seite definieren, können Sie den Webservice-Aufruf direkt über die Auftragskonfigurationsseite ausführen, indem Sie neben dem Kontrollkästchen Diesen Auftrag über HTTP...zur Verfügung stellen auf die Schaltfläche fs_ic_call_ws klicken. Andernfalls wird diese Schaltfläche nicht angezeigt.

 

Wenn Sie aufgefordert werden, beim Aufrufen des Web-Diensts Anmeldeinformationen anzugeben, so geben Sie dieselben Anmeldeinformationen ein, mit denen Sie sich auch bei FlowForce Server angemeldet haben.

 

Für die HTTP-Authentifizierung sollten Sie Ihre FlowForce Server-Anmeldeinformationen nur zu Testzwecken eingeben. Für Produktionszwecke wird empfohlen, einen neuen FlowForce-Benutzer zu erstellen, diesem Benutzer im Container, in dem sich der Auftrag befindet, die Berechtigung Dienst - Verwenden einzuräumen und den Web-Dienst anschließend über das entsprechende Benutzerkonto aufzurufen. Um die HTTP-Authentifizierung zu deaktivieren, und den Web-Dienst öffentlich zugänglich zu machen, weisen Sie dem Benutzer Anonymous die Berechtigung Dienst - Verwenden zu, siehe Funktionsweise von Berechtigungen.

 

Wenn der Auftrag erfolgreich ausgeführt wurde, wird das folgende Ergebnis im Browser angezeigt:

 

Hello, World!

 

Wenn der Auftrag fehlschlägt, wird die Meldung "Dienstausführung fehlgeschlagen" zurückgegeben. Überprüfen Sie in diesem Fall das FlowForce Server Auftrags-Log, um den Fehler ausfindig zu machen.

© 2017-2023 Altova GmbH