4D Doc Center : WEB GET OPTION

Home

4D v14.3

WEB GET OPTION


WEB GET OPTION ( Selector ; Wert )

Parameter	Typ	Beschreibung
Selector	Lange Ganzzahl	Code der Option, die geändert werden soll
Wert	Lange Ganzzahl, Text	Wert der Option

Beschreibung

Der Befehl WEB GET OPTION erhält den aktuellen Wert einer Option für die Operation des 4D Web Server.

Der Parameter Selector gibt die entsprechende Web Option an. In diesem Parameter übergeben Sie eine der Konstanten unter dem Thema Web Server:

Konstante	Typ	Wert	Meldung
Web character set	Lange Ganzzahl	17	Reichweite: 4D lokal, 4D Server Wird zwischen 2 Sitzungen beibehalten: Ja 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. Dieser Selector ist hilfreich für 4D Web Server mit einkompilierter 4D Desktop, die keinen Zugriff auf den Designmodus zulassen. 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 Beachten Sie, dass die Funktion Get database parameter mit der Konstanten Web Character set im optionalen Parameter StringWert den IANA Namen des Zeichensatzes zurückgibt. • 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 HTTP compression level	Lange Ganzzahl	50	Reichweite: 4D Anwendung Wird zwischen 2 Sitzungen beibehalten: Nein Mögliche Werte: 1 bis 9 (1 = schneller, 9 = stärker komprimiert), -1 = beste Kombination). Beschreibung: Setzt die Komprimierungsebene für jeden über Web Services ausgeführten komprimierten HTTP Austausch (Client Anfragen oder Server Antworten). Der Austausch in komprimierter Form ist eine Optimierung, wenn 4D Anwendungen über Web Services miteinander kommunizieren (siehe Befehl WEB SERVICE SET OPTION. 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: 4D Anwendung Wird zwischen 2 Sitzungen beibehalten: Nein 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 HTTPS port ID	Lange Ganzzahl	39	Reichweite: 4D lokal, 4D Server Wird zwischen 2 Sitzungen beibehalten: Ja 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 SSL (HTTPS protocol) verwendet. Die HTTPS Portnummer wird in den Datenbank-Eigenschaften auf der Seite Web>Konfiguration gesetzt. Weitere Informationen dazu finden Sie im Abschnitt QR DELETE COLUMN. 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 Wird zwischen 2 Sessions beibehalten: Nein, bleibt aber auch bei Neustart des HTTP Server gültig. 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 Session Suspend wird aufgerufen, dann wird der Session-Kontext gelöscht. Werte: Lange Ganzzahl (Minuten) Standardwert: 480 Minuten (zum Wiederherstellen des Standardwerts 0 übergeben)
Web inactive session timeout	Lange Ganzzahl	72	Reichweite: Lokaler Web Server Wird zwischen 2 Sessions beibehalten: Nein, bleibt aber auch bei Neustart des HTTP Server gültig. 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 Wird zwischen 2 Sitzungen beibehalten: Ja Beschreibung: Damit ändern Sie sofort die Web 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 wird in den Datenbank-Eigenschaften auf der Seite Web>Konfiguration festgelegt. Dieser Selector ist hilfreich für 4D Web Server mit einkompilierter 4D Volume Desktop, die keinen Zugriff auf den Designmodus zulassen. Im Parameter Wert übergeben Sie eine hexadezimale IP Adresse. Für die IP Adresse “a.b.c.d” schreiben Sie: `C_LONGINT($addr) $addr:=($a<<24)\|($b<<16)\|($c<<8)\|$d WEB SET OPTION(Web IP address to listen;$addr)`
Web keep session	Lange Ganzzahl	70	Reichweite: Lokaler Web Server Wird zwischen 2 Sessions beibehalten: Nein, bleibt aber auch bei Neustart des HTTP Server gültig. Beschreibung: Aktiviert oder deaktiviert den neuen Modus zum Verwalten der Sessions. Weitere Informationen dazu finden Sie im Abschnitt Web Sessions verwalten 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 Wird zwischen 2 Sitzungen beibehalten: Ja 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 Wird zwischen 2 Sitzungen beibehalten: Ja 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 Zwischen 2 Sessions beibehalten: Nein, bleibt aber auch bei Neustart des HTTP Server erhalten. Beschreibung: Begrenzt die Anzahl gleichzeitiger Sessions. Bei Erreichen des Limits wird die älteste Session geschlossen (die Datenbankmethode On Web Session Suspend 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 Wird zwischen 2 Sitzungen beibehalten: Ja 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 Wird zwischen 2 Sitzungen beibehalten: Nein 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 Wird zwischen 2 Sitzungen beibehalten: Nein, bleibt aber auch bei Neustart des HTTP Server gültig. 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. Mögliche Werte:* Text
Web session cookie name	Lange Ganzzahl	73	Reichweite: Lokaler Web Server Wird zwischen 2 Sitzungen beibehalten: Nein, aber bleibt gültig bei Neustart des HTTP 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 Wird zwischen 2 Sitzungen beibehalten: Nein, bleibt aber auch bei Neustart des HTTP Server gültig. 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. Mögliche Werte: Text