Wiki-Quellcode von Webservice einrichten

Zuletzt geändert von Form-Solutions GmbH am 15.02.2024
Zeige letzte Bearbeiter
1 ## Webservice Definition
2
3 In der Rubrik „Webservice Definition“ können neue Webservices hinzugefügt bzw. bearbeitet werden. Je nachdem welche Einstellungen der Mandant des Benutzers enthält, stehen bereits Verlagswebservices zur Verfügung.
4
5 ![[Webserviceübersicht|@WebservicesAnsicht.jpg]]
6
7 Über den vorgezeigten Beispielservice „iKfz“ können beispielsweise Fahrzeugdaten an das Kraftfahrtbundesamt übermittelt und von dort empfangen werden.
8
9 Neue Webservices können über die Schaltfläche „Hinzufügen“ in der Übersicht angelegt werden. In der nachfolgenden Eingabemaske müssen ein „Name“ sowie eine „Version“ für den neuen Webservice eingetragen werden. In dem Uploadfeld „Webservicearchiv“ kann die XML-Datei (Zipdatei) hochgeladen werden.
10
11 ![[Webservice neu Anlegen|@WebservicesAnlegen.jpg]]
12
13 ## Webservice Konfiguration
14
15 Unter der Rubrik „Webservice-Konfiguration“ können die angelegten Webservices definiert werden. Hierzu muss über die Dropdownkomponenten der zu bearbeitende Webservice ausgewählt werden. Es gibt bei der WebService Konfiguration nur ein benötigtes Feld, alle weiteren sind optional. Bei näher gehenden Fragen zur Konfiguration wenden Sie sich bitte an unseren [[Support|Main.10_Hilfe]].
16
17 ### Konfigurationsoptionen
18
19 ![[Konfiguration des Webservice|@WebservicesKonfiguration.jpg]]
20
21 #### WebService-Url
22
23 Hier muss die vollständige URL angegeben werden unter die der WebService zu erreichen ist.
24
25 Mit der Schaltfläche "Prüfen" kann ein einfacher Test mit der URL ausgeführt werden. [Details zur Erreichbarkeitsprüfung](https://wiki.form-solutions.de/wiki/admindoku/view/Main/04_Anbindungen/Webservice%20Erreichbarkeitspr%C3%BCfung/)
26
27 Wenn das Kontrollkästchen "Daten per Queue-Messaging übertragen" aktiviert worden ist, wird die Schaltfläche "Prüfen" nicht verfügbar sein.
28
29 #### SOAP-Version
30
31 Hier kann die SOAP Version hinterlegt werden.
32
33 #### Transportmodus für die Anfrage
34
35 Bei Auswahl der Option "MTOM" wird die SOAP-Nachricht mit Transportoptimierung gesendet. Dieser Mechanismus ist für die Übertragung von Binärdaten empfohlen. Die Option "SOAP" ist gleichbedeutend mit dem Direktversand.
36
37 #### Werte für HTTP-Basic Authentifikation
38
39 Die hier angegebenen Werte sind optional, allerdings nur dann, wenn beide Felder frei bleiben.
40
41 Als **Benutzername** muss der nicht-kodierte Benutzername angegeben werden, mit dem der Aufruf authentifiziert werden soll.
42 Als **Passwort** muss das nicht-kodierte Passwort für den angegebenen Benutzernamen eingetragen werden.
43
44 Form-Solutions kann nicht überprüfen, ob diese Form der Authentifikation für den aufzurufenden WebService benötigt wird oder nicht, daher wird es keine Validierungsfehler geben, wenn Benutzername und Password für die Kommunikation benötigt werden, aber nicht angegeben wurden. Weiterhin kann Form-Solutions nicht die Korrektheit von Benutzername und Passwort feststellen.
45
46 #### Werte für Zertifikatsauthentifizierung
47
48 Die hier angegebenen Werte sind optional, allerdings nur dann, wenn beide Felder frei bleiben.
49
50 Als **KeyStore Datei** wird ein gültiger Java-KeyStore erwartet, der ein Client- und ein Server-Zertifikat beinhaltet, um sich am Server des Webservice zu authentifizieren. Beim hochladen darf die WSDL und ZIP nicht in einer Datei sein. Das **Passwort**, welches angegeben wird, muss für den übergebenen Client-Schlüssel und die KeyStore-Datei gleich sein, da ansonsten der Schlüssel nicht entsperrt werden kann.
51
52 Informationen zur Erstellung eines entsprechenden KeyStores entnehmen Sie bitte der Administrationsdokumentation.
53
54 ### Queue-Messaging
55
56 Wenn das Kontrollkästchen "Daten per Queue-Messaging übertragen" aktiviert wird, wird die Oberfläche um fünf neue Felder erweitert. In diesen werden die für die Queue-Kommunikation notwendigen Konfigurationsparameter hinterlegt. Diese Einstellungen sollten nur nach Absprache mit Form-Solutions gesetzt werden, da diese Art der Kommunikation mit WebServices sehr speziell ist.
57
58 ![[Konfiguration Queue-Messaging|@WebServicesQueue.jpg]]
59
60 ### WebService Aktionen
61
62 Sollen unabhängig vom Assistenteninhalt statische Werte beim Webservice-Aufruf übergebenen werden, so kann man diese unter "WebService Aktionen" hinterlegen. Dabei muss darauf geachtet werden, dass als Parametername ein vollqualifizierter XML-Pfad anzugeben ist.
63
64 Bsp.: `{http://webservice.interfaces.formsolutions.de/}writeXMLData.{http://webservice.interfaces.formsolutions.de/}xml*.{http://www.destatis.de/schema/datml-raw/2.0/de}DatML-RAW-D*.{http://www.destatis.de/schema/datml-raw/2.0/de}nachricht*.{http://www.destatis.de/schema/datml-raw/2.0/de}GemeindeName*`
65
66 Die Notation entspricht derjenigen im Fieldmapping zuzüglich der Namespaces.
67
68 ![[Konfiguration Webservice-Aktionen|@WebserviceAktionen.jpg]]
69
70 ### WebService SOAP-Header
71
72 Benötigt der angesprochene Webservice spezielle SOAP-Header zur Verarbeitung, so kann hier ein kompletter XML-Block hinterlegt werden, der zur Ausführung in die entsprechende SOAP-Nachricht innerhalb des Header-Tags eingefügt wird. Dadurch lassen sich auch komplexere XML-Strukturen übergeben.
73
74 ![[Konfiguration Webservice SOAP-Header|@WebserviceSOAPHeader.jpg]]
75
76 Bei der Eingabe des Soap-Headers ist folgendes zu beachten:
77
78 Die "Klammern" des Headers ![[2023-06-23 13_24_35-SoapUI 5.7.0.png|2023-06-23 13_24_35-SoapUI 5.7.0.png]]sollen nicht mit eingetragen werden.
79
80 Ein Beispiel eines gültigen Eintrags (hier für WSSE-Security-Einstellungen) wäre:![[2023-06-23 13_35_44-SoapUI 5.7.0.png|2023-06-23 13_35_44-SoapUI 5.7.0.png]]
81
82 ### WebService-HeaderParameter
83
84 Um zusätzliche HTTP-Header beim Aufruf zu übergeben (z.B. zur Authentifizierung), können diese als Name-/Wertpaare unter dem Punkt "WebService-HeaderParameter" hinterlegt werden. Zu beachten ist dabei, dass diese unabhängig von der aufgerufenen Aktion übergeben werden.
85
86 ![[Konfiguration Webservice-HeaderParameter|@WebserviceHeaderParameter.jpg]]

Navigation