WEB SET OPTION

Home

4D v16.3

WEB SET OPTION


WEB SET OPTION ( Selector ; Wert )

Parameter	Typ	Beschreibung
Selector	Lange Ganzzahl	Code der Option
Wert	Lange Ganzzahl, Text	Wert der Option

Beschreibung

Der Befehl WEB SET OPTION ändert den aktuellen Wert verschiedener Optionen zur Funktionsweise des 4D Web Server.

Im Parameter Selector übergeben Sie eine Konstante unter dem Thema Web Server und in Wert den neuen Wert der Option:

Konstante	Typ	Wert	Kommentar
Web character set	Lange Ganzzahl	17	Reichweite: 4D lokal, 4D Server Beschreibung: Damit können Sie sofort den Zeichensatz ändern, den der 4D Web Server mit 4D im lokalen Modus und 4D Server für die Kommunikation mit Browsern verwenden soll, die sich an die Datenbank anmelden. Die aktuelle Standardeinstellung richtet sich nach der Sprache des Betriebssystems. Dieser Parameter wird in den Einstellungen der Datenbank festgelegt. Mögliche Werte: Der Wert richtet sich nach dem jeweiligen Ausführungsmodus der Datenbank • Unicode Modus: Wird die Anwendung im Modus Unicode ausgeführt, müssen jetzt für diesen Parameter Zeichensatz Identifier übergeben werden. Das sind Identifier vom Typ MIBEnum Lange Ganzzahl oder Name String, definiert IANA (siehe unter http://www.iana.org/assignments/character-sets) Nachfolgend sehen Sie die Liste der Identifier, der dem von 4D Web Server unterstützten Zeichensatz entspricht: 4 = ISO-8859-1 12 = ISO-8859-9 13 = ISO-8859-10 17 = Shift-JIS 2026 = Big5 38 = euc-kr 106 = UTF-8 2024 = Windows-31J 2250 = Windows-1250 2251 = Windows-1251 2253 = Windows-1253 2255 = Windows-1255 2256 = Windows 1256 • ASCII Kompatibilitätsmodus 0: Western European 1: Japanisch 2: Chinesisch 3: Koreanisch 4: Benutzerdefiniert 5: Reserviert 6: Central European 7: Kyrillisch 8: Arabisch 9: Griechisch 10: Hebräisch 11: Türkisch 12: Baltisch
Web Client IP address to listen	Lange Ganzzahl	23	Reichweite: Alle 4D remote Rechner Mögliche Werte: Siehe Selector 16 Beschreibung: Dient zur Angabe dieses Parameters für alle Rechner mit remote 4D, die als Web Server verwendet werden (gilt nur für den remote Web Server).
Web debug log	Lange Ganzzahl	84	Reichweite: Lokaler Web Server Hinweis: Nach Neustart des HTTP Server wird ein neues Protokoll verwendet. Beschreibung: Ermöglicht, den Status des HTTP Anfrageprotokolls des 4D Web Server zu erhalten oder zu setzen. Ist er aktiviert, wird diese Datei mit Namen "HTTPDebugLog_nn.txt", im Ordner "Logs" der Anwendung gespeichert (nn ist die Dateinummer). Das ist hilfreich zum Debuggen bei Problemen mit dem Web Server. Die Datei protokolliert jede Anfrage und Antwort im Rohmodus. Die Anfragen werden mit Kopfteilen protokolliert; optional lassen sich auch Body-Bereiche mitprotokollieren. Weitere Informationen dazu finden Sie im Anhang E: Beschreibung der Protokolldateien. Werte: Eine der Konstanten mit der Vorsilbe "wdl" (siehe Beschreibung dieser Konstanten unter diesem Thema). Standardwert: 0 (nicht aktiviert)
Web HTTP compression level	Lange Ganzzahl	50	Reichweite: Lokaler Web Server Mögliche Werte: 1 bis 9 (1 = schneller, 9 = stärker komprimiert), -1 = beste Kombination Beschreibung: Setzt die Komprimierungsebene für jeden komprimierten HTTP Austausch für den 4D HTTP Server (Client Anfragen oder Server Antworten, Web und Web Service). Mit diesem Selektor können Sie den Austausch entweder über die Ausführungsgeschwindigkeit (weniger Komprimierung) oder die Komprimierungsmenge (weniger Geschwindigkeit) optimieren. Die Auswahl des passenden Wertes richtet sich nach der Größe und der Art der ausgetauschten Daten. Im Parameter Wert können Sie einen Wert von 1 bis 9 übergeben, wobei 1 die schnellste und 9 die höchste Komprimierung ist. Für einen Kompromiss zwischen Geschwindigkeit und Komprimierungsrate übergeben Sie -1. Standardmäßig ist als Komprimierungsebene 1 eingestellt (schnellere Komprimierung).
Web HTTP compression threshold	Lange Ganzzahl	51	Reichweite: Lokaler HTTP Server Mögliche Werte: Jeder Wert vom Typ Lange Ganzzahl Beschreibung: Setzt den Schwellwert, bis zu dem der Austausch von Daten im Rahmen von 4D Web Services nicht komprimiert werden soll. Diese Einstellung ist hilfreich, um beim Austausch geringer Datenmengen zu verhindern, dass Rechenzeit für die Komprimierung beansprucht wird. In Wert übergeben Sie eine Größe in Bytes. Standardmäßig ist als Schwellwert für Komprimierung 1024 Bytes eingestellt.
Web HTTP TRACE	Lange Ganzzahl	85	Reichweite: Lokaler Web Server Wird zwischen 2 Sitzungen beibehalten: Nein Beschreibung: Ermöglicht, die Methode HTTP TRACE im 4D Web Server zu aktivieren/deaktivieren. Ab 4D v15 R2 weist der 4D Web Server aus Sicherheitsgründen HTTP TRACE Anfragen standardmäßig mit dem Fehler 405 ab (HTTP TRACE ist deaktiviert). Bei Bedarf können Sie die Methode HTTP TRACE für die Sitzung aktivieren, indem Sie für diese Konstante den Wert 1 übergeben. Dann sendet der 4D Web Server bei HTTP TRACE Anfragen die Anfragezeile, Kopfteil und Hauptteil. Mögliche Werte: 0 (deaktiviert) oder 1 (aktiviert) Standardwert: 0 (deaktiviert)
Web HTTPS port ID	Lange Ganzzahl	39	Reichweite: 4D lokal, 4D Server Mögliche Werte: 0 bis 65535 Beschreibung: Mit diesem Selector können Sie per Programmierung die TCP Portnummer ändern, die der Web Server von 4D im lokalen Modus und von 4D Server für sichere Verbindungen via TLS (HTTPS protocol) verwendet. Die HTTPS Portnummer wird in den Datenbank-Eigenschaften auf der Seite Web>Konfiguration gesetzt. Der Wert ist standardmäßig 443. Für den Parameter Wert können Sie Konstanten unter dem Thema TCP Port Nummern einsetzen.
Web inactive process timeout	Lange Ganzzahl	78	Reichweite: Lokaler Web Server Mögliche Werte: Lange Ganzzahl (Minuten) Beschreibung: Ändert die Lebensdauer des inaktiven Prozesses, der Sessions zugeordnet ist. Am Ende des Timeout wird der Prozess auf dem Server gestoppt, die Datenbankmethode On Web Close Process wird aufgerufen, dann wird der Session-Kontext gelöscht. Standardwert: 480 Minuten (zum Wiederherstellen des Standardwerts 0 übergeben)
Web inactive session timeout	Lange Ganzzahl	72	Reichweite: Lokaler Web Server Beschreibung: Ändert die Lebensdauer inaktiver Sessions (Dauer wird in Cookie gesetzt). Endet diese Periode, läuft das Cookie der Session ab und wird nicht mehr vom HTTP Client gesendet. Mögliche Werte: Lange Ganzzahl (Minuten) Standardwert: 480 Minuten (zum Wiederherstellen des Standardwerts 0 übergeben)
Web IP address to listen	Lange Ganzzahl	16	Reichweite: 4D lokal, 4D Server Beschreibung: IP Adresse, unter der der 4D Web Server HTTP Anfragen mit 4D im lokalen Modus und 4D Server empfängt. Standardmäßig ist keine bestimmte Adresse definiert (Wert = 0). Dieser Parameter lässt sich in den Datenbank-Eigenschaften auf der Seite Web>Konfiguration festlegen. Dieser Selector ist hilfreich für 4D Web Server mit einkompilierter 4D Volume Desktop, die keinen Zugriff auf den Designmodus zulassen. Mögliche Werte: IP Adresse String. Beide Formate werden unterstützt: IPv6, z.B. "2001:0db8:0000:0000:0000:ff00:0042:8329") und IPv4 (z.B. "123.45.67.89"). Hinweis: Zur Wahrung der Kompatibilität werden überholte IPv4 Adressen in Form von hexadezimalen Langen Ganzzahlen noch unterstützt.
Web keep session	Lange Ganzzahl	70	Reichweite: Lokaler Web Server Beschreibung: Aktiviert oder deaktiviert den neuen Modus zum Verwalten der Sessions. Weitere Informationen dazu finden Sie im Abschnitt Web Sessions verwalten Mögliche Werte: 1 (Modus aktivieren) oder 0 (Modus deaktivieren) Standardwert: 1 für mit v13 erstellte Datenbanken, 0 für konvertierte Datenbanken. Beachten Sie, dass dieser Modus auch den Mechanismus zum Wiederverwenden temporärer Kontexte im remote Modus ermöglicht. Weitere Informationen dazu finden Sie im Abschnitt Web Server, Einstellungen
Web log recording	Lange Ganzzahl	29	Reichweite: 4D lokal, 4D Server Beschreibung: Startet oder stoppt das Speichern von Web Anfragen, die vom Web Server von 4D im lokalen Modus oder 4D Server empfangen werden. Der Standardwert ist 0, d.h. Anfragen werden nicht gespeichert. Das Logbuch von Web Anfragen wird als Textdatei mit Namen “logweb.txt” gespeichert, die automatisch in den Ordner Logs neben der Strukturdatei der Anwendung gesetzt wird. Das Format dieser Datei richtet sich nach dem übergebenen Wert. Weitere Informationen zu Formaten für Web Logfiles finden Sie im Abschnitt Information über die Web Site . Diese Datei lässt sich auch in den Datenbank-Eigenschaften auf der Seite Log (Typ) aktivieren. Mögliche Werte: 0 = Nicht speichern (Standard), 1 = In CLF Format speichern, 2 = In DLF Format speichern, 3 = In ELF Format speichern, 4 = In WLF Format speichern. Warnung: Format 3 und 4 sind individuell anpassbare Formate, d.h. Sie müssen den Typ zuvor in den Datenbank-Eigenschaften auf der Seite Log (Typ) definieren. Verwenden Sie diese Formate, ohne zuvor den Typ festzulegen, wird kein Logbuch angelegt.
Web max concurrent processes	Lange Ganzzahl	18	Reichweite: 4D lokal, 4D Server Werte: Sie können jeden Wert zwischen 10 und 32 000 übergeben. Der Standardwert ist 100. Beschreibung: Damit setzen Sie die maximale Anzahl aller gleichzeitig laufenden Web Prozesse (kontextuell, nicht kontextuell oder die zum Pool der Prozesse gehören), die der 4D Web Server mit 4D im lokalen Modus und 4D Server unterstützt. Ist die maximale Anzahl erreicht, erstellt 4D keinen weiteren Prozess und gibt den HTTP Status 503 zurück - Dienst für weitere neue Anfragen nicht verfügbar. Dieser Parameter verhindert die Übersättigung des 4D Web Server. Sie kann eintreten, wenn gleichzeitig eine zu große Anzahl an Anfragen gesendet wird oder zu viele Kontext-Erstellungen angefordert werden. Theoretisch ist die max. Anzahl der Web Prozesse das Ergebnis der folgenden Formel: Verfügbarer Speicher/Stapelgröße der Web Prozesse. Sie können sich auch die Information über die Web Prozesse im Runtime Explorer ansehen: Er zeigt die aktuelle Anzahl der Web Prozesse und die max. erreichte Anzahl seit dem Hochfahren des Web Server an.
Web max sessions	Lange Ganzzahl	71	Reichweite: Lokaler Web Server Beschreibung: Begrenzt die Anzahl gleichzeitiger Sessions. Bei Erreichen des Limits wird die älteste Session geschlossen (die Datenbankmethode On Web Close Process wird aufgerufen), wenn der Web Server eine neue erstellen muss. Mögliche Werte: Lange Ganzzahl. Die Anzahl gleichzeitiger Sessions kann nicht größer sein als die Gesamtzahl der Web Prozesse (Option Web Max Concurrent Processes, standardmäßig 100). Standardwert: 100 (zum Wiederherstellen des Standardwerts 0 übergeben)
Web maximum requests size	Lange Ganzzahl	27	Reichweite: 4D lokal, 4D Server Mögliche Werte: 500 000 bis 2 147 483 648 Beschreibung: Maximale Größe (in Bytes) hereinkommender HTTP Anfragen (POST), die der Web Server akzeptiert. Standardmäßig ist der Wert 2 000 000 vorgegeben, z.B. etwas unter 2 MB. Übergeben Sie den maximalen Wert (2 147 483 648), wird praktisch keine Grenze gesetzt. Die Begrenzung sorgt dafür, dass der Web Server nicht überlastet wird durch zu große eingehende Anfragen. Erreicht eine Anfrage den Grenzwert, weist der 4D Web Server diese zurück.
Web port ID	Lange Ganzzahl	15	Reichweite: 4D im lokalen Modus und 4D Server Beschreibung: Setzt oder erhält die Nummer des TCP Port, den 4D Web Server mit 4D im lokalen Modus und mit 4D Server (Lange Ganzzahl) verwendet. Standardmäßig ist der Wert 80. Die TCP Port Nummer wird in den Einstellungen der Datenbank auf der Seite "Web/Konfiguration" gesetzt. Für den Parameter Wert können Sie eine Konstante unter dem Thema TCP Port Nummern verwenden. Dieser Selector ist im Rahmen von 4D Web Servern mit einkompiliertem 4D Desktop hilfreich (kein Zugriff auf die Design-Umgebung). Mögliche Werte: Weitere Informationen über die TCP Port Nummer finden Sie im Abschnitt Web Server, Einstellungen. Standardwert: 80
Web session cookie domain	Lange Ganzzahl	81	Reichweite: lokaler Web Server Mögliche Werte: Text Beschreibung: Setzt oder erhält den Wert des Feldes "domain" des Session Cookie (Text). Dieser Selektor, sowie Selektor 82 sind hilfreich zum Überprüfen der Reichweite von Session Cookies: Haben Sie z.B. für diesen Selektor den Wert "/*.4d.fr" gesetzt, sendet der Client ein Cookie nur, wenn die Anfrage an die Domaine ".4d.fr" gerichtet ist. Das schließt Server aus, die externe statische Daten hosten.
Web session cookie name	Lange Ganzzahl	73	Reichweite: Lokaler Web Server Beschreibung: Setzt den Namen des Cookie zum Sichern der Session ID Mögliche Werte: Text Standardwert: "4DSID" (zum Wiederherstellen des Standardwerts leeren String übergeben)
Web session cookie path	Lange Ganzzahl	82	Reichweite: lokaler Web Server Mögliche Werte: Text Beschreibung: Setzt oder erhält den Wert des Feldes "path" des Session Cookie (Text). Dieser Selektor, sowie Selektor 81 sind hilfreich zum Überprüfen der Reichweite von Session Cookies: Haben Sie z.B. für diesen Selector den Wert "/4DACTION" gesetzt, sendet der Client ein Cookie nur für dynamische Anfragen, die mit 4DACTION beginnen und nicht für Bilder, statische Seiten, etc.
Web session enable IP address validation	Lange Ganzzahl	83	Reichweite: Lokaler Web Server Beschreibung: Damit können Sie die Überprüfung der IP Adresse für Session Cookies aktivieren oder deaktivieren. Aus Sicherheitsgründen prüft der 4D Web Server standardmäßig die IP Adresse einer Anfrage mit einem Session Cookie und weist sie ab, wenn sie nicht zur IP Adresse passt, über die das Cookie erstellt wurde. Sie können diese Überprüfung bei bestimmten Applikationen deaktivieren und das Session Cookie akzeptieren, auch wenn die IP Adresse nicht dazu passt. Wechseln z.B. mobile Geräte zwischen Wifi und 3G/4G Netzwerken, ändert sich die IP Adresse. In diesem Fall übergeben Sie den Wert 0, damit Clients weiterhin ihre Web Sessions verwenden können, auch wenn sie die IP Adresse wechseln. Beachten Sie, dass diese Einstellung die Sicherheitstufe Ihrer Applikation herabsetzt. Die Einstellung ist sofort wirksam, d.h. Sie müssen den HTTP Server nicht neu starten. Mögliche Werte: 0 (deaktiviert) oder 1 (aktiviert) Standardwert: 1 (IP Adressen werden geprüft)

Verwenden Sie den Selector Web debug log, können Sie im Parameter Wert eine der folgenden Konstanten übergeben:

Konstante	Typ	Wert	Kommentar
wdl disable	Lange Ganzzahl	0	Web HTTP Fehlerprotokoll ist deaktiviert
wdl enable with all body parts	Lange Ganzzahl	7	Web HTTP Fehlerprotokoll ist aktiviert mit Body Bereichen der Anfrage und der Antwort
wdl enable with request body	Lange Ganzzahl	5	Web HTTP Fehlerprotokoll ist aktiviert nur mit Body Bereichen der Anfrage
wdl enable with response body	Lange Ganzzahl	3	Web HTTP Fehlerprotokoll ist aktiviert nur mit Body Bereichen der Antwort
wdl enable without body	Lange Ganzzahl	1	Web HTTP Fehlerprotokoll ist aktiviert ohne Body Bereiche (in diesem Fall wird die Body Größe angezeigt)

Beispiel

Das http Fehlerprotokoll ohne Body Bereiche aktivieren:

WEB SET OPTION(Web debug log;wdl enable without body)

Das Protokoll lautet wie folgt:

# REQUEST
# SocketID: 1592
# PeerIP: 127.0.0.1
# PeerPort: 54912
# TimeStamp: 39089388
#ConnectionID: 9808E3B4B06E4EB5A60E9A3FC69116BD
#SequenceNumber:5
GET /4DWEBTEST HTTP/1.1
Accept: text/html,(...)
Accept-Encoding: gzip, deflate
Connection: keep-alive
Host: 127.0.0.1
User-Agent: 4D_HTTP_Client/0.0.0.0

# RESPONSE
# SocketID: 1592
# PeerIP: 127.0.0.1
# PeerPort: 54912
# TimeStamp: 39089389 (elapsed time: 1 ms)
#ConnectionID: 9808E3B4B06E4EB5A60E9A3FC69116BD
#SequenceNumber:6
HTTP/1.1 200 OK
Accept-Ranges: bytes
Connection: keep-alive
Content-Encoding: gzip
Content-Length: 3555
Content-Type: text/plain; charset=UTF-8
Date: Thu, 20 Apr 2017 10:51:29 GMT
Expires: Thu, 20 Apr 2017 10:51:29 GMT
Server: 4D/16.0.1

[Body Size: 3555]

Siehe auch

WEB GET OPTION
WEB GET SESSION EXPIRATION