4D Doc Center : SET WEB SERVICE OPTION

4D v12.4

SET WEB SERVICE OPTION


SET WEB SERVICE OPTION ( Option ; Wert )

Parameter	Typ	Beschreibung
Option	Lange Ganzzahl	Code der zu setzenden Option
Wert	Lange Ganzzahl, Text	Wert der Option

Vorbemerkung

Dieser Befehl ist optional. Er richtet sich an fortgeschrittene Nutzer von Web Services.

Beschreibung

Der Befehl SET WEB SERVICE OPTION setzt verschiedene Optionen, die während der nächsten SOAP Anfrage verwendet werden, die über den Befehl CALL WEB SERVICE ausgelöst werden.

Sie können diesen Befehl so oft aufrufen, wie es Optionen gibt, um vor CALL WEB SERVICE zu setzen.

In Option übergeben Sie die Nummer der Option, in Wert ihren neuen Wert. Für den Parameter Option können Sie auch eine vordefinierte Konstante unter dem Thema Web Services (Client) verwenden:

Konstante	Typ	Wert	Meldung
Web Service display auth dialog	Lange Ganzzahl	4	Wert = 0 (Dialogfenster nicht anzeigen) oder 1 (Dialogfenster anzeigen) Diese Option verwaltet die Anzeige des Authentifizierungsdialogs beim Ausführen des Befehls CALL WEB SERVICE. Dieser Befehl zeigt standardmäßig nie den Dialog an; normalerweise müssen Sie dafür den Befehl AUTHENTICATE WEB SERVICE verwenden. Verwenden Sie diese Option, wenn der Authentifizierungsdialog erscheinen soll, damit Benutzer ihre Identifier eintragen können: Übergeben Sie 1 in Wert, um das Dialogfenster anzuzeigen, sonst 0. Das Dialogfenster erscheint nur, wenn der Web Service eine Authentifizierung benötigt.
Web Service HTTP Compression	Lange Ganzzahl	6	Wert = Web Service Deflate Compression Damit können Sie eine interne Komprimierungsoption für SOAP Anfragen aktivieren, um den Austausch zwischen 4D Anwendungen zu beschleunigen. Führen Sie die Anweisung SET WEB SERVICE OPTION (Web Service HTTP Compression; Web Service Deflate Compression) auf dem 4D Client des Web Service aus, werden die Daten der nächsten vom Client gesendeten SOAP Anfrage vor Senden an den 4D SOAP Server über einen Standard HTTP Mechanismus komprimiert. Der Server entkomprimiert, durchläuft die Anfrage und antwortet automatisch über dieselbe Funktionalität. Das gilt jedoch nur für die Anfrage, die dem Aufruf des Befehls SET WEB SERVICE OPTION folgt. Deshalb müssen Sie diesen Befehl für jede Komprimierung erneut aufrufen. 4D komprimiert die Web Service HTTP Anfragen standardmäßig nicht. Hinweis: "Deflate" ist der Name des intern von 4D genutzten Komprimierungsalgorithmus. Er ist für Anfragen, die an einen 4D SOAP Server älter als Version 11.3 gesendet werden, nicht verwendbar. Zur weiteren Optimierung gibt es zusätzliche Optionen für Durchlass- und Komprimierungsrate der Anfragen. Diese Optionen finden Sie unter dem Befehl SET DATABASE PARAMETER.
Web Service HTTP Timeout	Lange Ganzzahl	1	Wert = Timeout des Client Teils, angegeben in Sekunden. Timeout ist die Zeitspanne, die der Web Service Client wartet, wenn der Server nicht antwortet. Ist sie abgelaufen, schließt der Client die Sitzung und die Anfrage geht verloren. Das Timeout beträgt standardmäßig 180 Sekunden. Es kann für spezifische Fälle geändert werden (Netzwerkstatus, Web Service Eigenheiten, etc.).
Web Service reset auth settings	Lange Ganzzahl	5	Wert = 0 (Information nicht entfernen) oder 1 (Information entfernen) Damit können Sie für 4D angeben, ob die Information zur Authentifizierung des Benutzers (Benutzername, Kennwort, Methode, etc.) gespeichert werden soll, um sie in Folge erneut zu verwenden. Diese Information wird standardmäßig nach jeder Ausführung des Befehls CALL WEB SERVICE entfernt. Übergeben Sie 0 in Wert, um die Information zu speichern, 1 um sie zu entfernen. Beachten Sie, dass bei 0 die Information während der Sitzung beibehalten, aber nicht gespeichert wird.
Web Service SOAP Header	Lange Ganzzahl	2	Wert = XML Root Element Referenz, die als Header in der SOAP Anfrage eingegeben werden soll. Damit können Sie einen Header in einer SOAP Anfrage eingeben, die über den Befehl CALL WEB SERVICE erstellt wurde. SOAP Anfragen enthalten standardmäßig keinen spezifischen Header. Bestimmte Web Services benötigen jedoch einen Header, z.B. zur Verwaltung von Parametern zur Identifizierung.
Web Service SOAP Version	Lange Ganzzahl	3	Wert = Web Service SOAP_1_1 oder Web Service SOAP_1_2 Über diese Option können Sie die Version des in der Anfrage verwendeten SOAP Protokolls angeben. Übergeben Sie Web Service SOAP_1_1 für Version 1.1, Web Service SOAP_1_2 für Version 1.2.

Es spielt keine Rolle, in welcher Reihenfolge die Optionen aufgerufen werden. Wird dieselbe Option mehrmals gesetzt, wird nur der Wert des letzten Aufrufs berücksichtigt.

Beispiel 1

Die folgende Anweisung fügt in die SOAP Anfrage einen eigenen Header ein:

  ` Eine XML Referenz erstellen

 C_TEXT(vRootRef;vElemRef)

 vRootRef:=DOM Create XML Ref("RootElement")

 vxPath:="/RootElement/Elem1/Elem2/Elem3"

 vElemRef:=DOM Create XML element(vRootRef;vxPath)

  `SOAP header mit Referenz ändern

 SET WEB SERVICE OPTION(Web Service SOAP Header;vElemRef)

Beispiel 2

Das folgende Beispiel verwendet das SOAP Protokoll Version 1.2:

SET WEB SERVICE OPTION(Web Service SOAP Version;Web Service SOAP_1_2)