Zum Inhalt springen
Version 4.1 von MACH ProForms GmbH am 05.04.2024
Zeige letzte Bearbeiter
1 == Wo wird die Webservice Erreichbarkeitsprüfung eingesetzt? ==
2
3 * Bei der Einrichtung eines Webservice in der Mandanten-Modulkonfiguration durch die "Prüfen"-Schaltfläche. Die Einrichtung findet sich unter //Web Services //- //WebService Konfiguration.//
4 * Beim Assistentenstart wird die Erreichbarkeit des Webservices unter der in der Modulkonfiguration hinterlegten URL geprüft. Dabei werden sowohl die //Webservice-Komponente[[image:icon:thumb_down]]//, als auch die //WebService-Anfrage während der Einreichung// berücksichtigt.
5
6 == Wie funktioniert die Erreichbarkeitsprüfung? ==
7
8 Als Endpunkt für die Erreichbarkeitsprüfung dient die in der Modulkonfiguration (siehe oben) hinterlegte "WebService-Url".
9
10 Es wird versucht eine Verbindung zu dieser URL aufzubauen. Dazu wird eine Reihe von HTTP-Requests an die URL geschickt, von denen **mindestens einer** eine "positive" Antwort erhalten muss, um die Erreichbarkeitsprüfung erfolgreich zu bestehen.
11
12 Eine "positive" Antwort gilt als gegeben, wenn ein HTTP-Status-Code vom Server empfangen werden konnte und dieser nicht der **5xx-Serie** (Server-Fehler) angehört und auch nicht einem der Client-Error Codes **401**,** 403 **oder** 404 **entspricht.
13
14 Die nachfolgenden HTTP-Requests werden nach einander gesendet, **es sei denn es wird vorher eine positive Antwort empfangen **oder** der HTTP-Status-Code der Antwort kann nicht ermittelt werden**:
15
16 1. HEAD-Request an die URL
17 1. GET-Request an die URL
18 1. GET-Request an die URL mit angehängtem Query-Parameter "**wsdl**"
19 11. Beispiel 1: https:~/~/ws.form-solutions.test?wsdl
20 11. Beispiel 2: https:~/~/ws.form-solutions.test?param=1&wsdl
21
22 Jeder der gesendeten Requests sendet den Header "**Accept**" mit dem Wert "***/***" (wodurch signalisiert wird, dass jede Art von Daten bzw. auch keine Daten im Response-Body akzeptiert werden).
23
24 Sind in der Modulkonfiguration neben der URL auch **Authentisierungsdaten** (HTTP-Basic und/oder Zertifikats-Key-/Truststore) hinterlegt, so werden diese ebenfalls mit den oben genannten Requests mitgesendet.