erstellen (Konfiguration)

Februar 2016
AFS-Tutorials
Webservice anbinden
Daten mittels Webservice abrufen
Gezeigt wird die flexible Anbindung an externe Schnittstellen am Beispiel eines „lesenden“ Webservices der Daten
der Sportergebnis-Datenbank www.openligadb.de zur Verfügung stellt. Es werden im Formular, je nach ausgewählter Saison, die Torschützen der deutschen Bundesliga angezeigt. Die Konfiguration eines „sendenden“ Webservices funktioniert analog.
Bild 1: Auswahl der Saison die abgefragt werden (Parametrierung des Webservice)
Bild 2: Ergebnisse nach Webservice Abfrage
Schritt 1: In AFS-Webadmin einloggen:
Loggen Sie sich mit folgenden Zugangsdaten in den AFS-WebAdmin ein.
Demo-WebAdmin
Falls Sie noch keine Zugangsdaten haben, können Sie diese unter folgendem Link anfordern:
Zugangsdaten anfordern
Seite 2 / 5
Abbildung 3: Loginfenster AFS-WebAdmin
Schritt 2: Formular auswählen:
Im aktuellen Beispiel handelt es sich um das fertige Formular „Ligaabfrage_Demo“, in welchem bereits ein Webservice Extender konfiguriert wurde und das Formular „Ligaabfrage_Demo_Leer“ in welchem Sie anhand dieses Tutorials selbst einen Extender konfigurieren können. Sie können die beiden Formulare per „Lupensymbol“ aufrufen und
vergleichen. Bei „Ligaabfrage_Demo_Leer“ kommen Sie auf die nächste Seite, jedoch bleibt die angezeigte Tabelle
leer.
Abbildung 4: Voransicht des Formulars öffnen
Klicken Sie nun auf in der Spalte „Formularname“ auf das Formular „Ligaabfrage_Demo_Leer“ um dieses zu bearbeiten.
Seite 3 / 5
Schritt 3: Konfiguration „Webservice Extender“
Unter dem Punkt „Extender“ klicken Sie nun auf „Hinzufügen“ und wählen den Extender „WebService Extender“
Abbildung 5: Neuen Extender hinzufügen
Hier konfigurieren Sie den Extender. Setzen Sie zuerst ein Häkchen unter „Selbstersteller Verwendungszweck“ und
benennen diesen im Feld „Verwendungszweck“. Dies dient Ihnen später als Hilfe um in der Übersicht sofort zu sehen, was für eine Funktion der Extender erfüllen soll. In diesem Fall nennen wir ihn „Goalgetter“, da wir mithilfe des
Extenders die Torschützen abfragen möchten. Danach geben Sie im Feld „WebServiceWSDLURL“, die WSDL des
WebServices an und klicken auf die beiden grünen Pfeile um diese zu aktualisieren. Im Fall der Openligadb, lautet
diese http://www.openligadb.de/Webservices/Sportsdata.asmx?WSDL.
Abbildung 6: Eingabe Verwendungszweck und der Webservice WSDL-URL
Der AFS-Webservice-Extender analysiert die WSDL und listet die verfügbaren Funktionen auf. Nach Auswahl der
gewünschten Operation (GetGoalGettersByLeagueSaison:soap) aus der „Operation“-Dropdown Liste wird auch der
„Event“ „NEXT_PRESSED“ ausgewählt. Damit wird der Extender so konfiguriert, dass die Webservice-Abfrage beim
Klick auf den „Weiter“-Button im Formular ausgelöst wird.
Nach Klick auf das Symbol „Aktualisieren“ neben der gewählten Operation, werden die Operation-Parameter in das
Feld Eingabemapping eingetragen. Nun können die beiden Variablen für Eingabefelder, die als Parameter an den
Webservice übergeben sollen mittels Fieldpicker bestimmt werden. Hier wird für (1) „Eingabefelder 1“ das Feld „Saison (Saison)“ und (2)„Eingabefelder 2“ das Feld „Liga (Liga)“ ausgewählt.
Anmerkung: Das Feld Saison ist das Auswahlfeld von Formularseite 1. Das Feld Liga ist in diesem Beispiel ein
Fixwert für die gewählte Bundesliga. Die Variable für die Bundesliga ist in einem versteckten Feld hinterlegt, da sie
im gezeigten Beispiel bei jeder Abfrage gleich bleiben soll.
Nun werden die Variablen (1&2) im Feld „Eingabemapping“ eingetragen:
inputMsg.leagueSaison={1} und inputMsg.leagueShortcut={2}
Mit diesem Schritt ist die Definition der Auswahl und Parametrierung des Eingabemappings abgeschlossen
Definition der Operation, der Eingabefelder und des Mappings
Seite 4 / 5
Zur Anzeige der Ergebnisse der Webservice-Abfrage im Formular wird analog vorgegangen:
Die beiden Variablen für Ergebnisfelder, in die das Ergebnis des Webservice geschrieben werden soll, werden mittels
Fieldpicker bestimmt. In diesem Beispiel sollen mit „Ergebnisfelder 1“ das Feld „Name (Name)“ und „Ergebnisfelder
2“ das Feld „Tore (Tore)“ verknüpft werden.
Im Feld „Ergebnismapping“ wird automatisch die Struktur des Ergebnisses der gewählten Operation vorbefüllt. Es
muss nur noch die Variablennummer des zuvor festgelegten Ergebnisfeldes angegeben werden. Durch den Zusatz
[*] werden die Ergebnisse automatisch in einer AFS-Tabelle angezeigt.
Mit diesem Schritt ist Konfiguration des Webservice-Extenders abgeschlossen.
Definition der Ausgabefelder und des Mappings
Klicken Sie nun unten auf „Übernehmen“ und auf der Seite „Formulardetails“ auf „Speichern.“ In der Ansicht „Liste
der Formulare“ klicken Sie nun noch auf den Button „Voll-Abgleich“ um die Bearbeitungen auch mit dem Server zu
synchronisieren.
Abbildung 9: Änderungen mit dem Server abgleichen.
Sie können das Formular nun wie zuvor über das „Lupensymbol“ aufrufen und testen.
Kontakt
aforms2web solutions & services GmbH
Alser Straße 4/Hof 1, 1.17, A-1090 Wien
www.aforms2web.com
Peter Marvin Behrendt, MSc. MBA.
Tel: +43 676 305 44 04
[email protected]
Mag. Kurt Waldherr, MSc. MBA.
Tel : +43 664 455 83 62
[email protected]
David Glieber
Tel : +43 664 384 63 67
[email protected]
Geschäftsführung
Geschäftsführung
IT-Beratung & Vertrieb
Für den Inhalt verantwortlich: aforms2web solutions & services GmbH, A-1090 Wien, Alser Str. 4/Hof 1, 1.17. Alle Rechte vorbehalten. Die verwendeten Namen sind Handelsnamen und/oder Marken der jeweiligen Hersteller. aforms2web übernimmt weder Verantwortung noch Verpflichtungen in
Bezug auf dieses Dokument. Druckfehler und Änderungen vorbehalten.
Copyright © aforms2web, 2016
Seite 5 / 5