4D v14.3

WEB GET OPTION

Home

 
4D v14.3
WEB GET OPTION

WEB GET OPTION 


 

WEB GET OPTION ( Selector ; Wert ) 
Parameter Typ   Beschreibung
Selector  Lange Ganzzahl in Code der Option, die geändert werden soll
Wert  Lange Ganzzahl, Text in Wert der Option

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Web Server
Nummer: 1209

 
GESCHICHTE 

Erstellt: 4D v13
Geändert: 4D v13.2

 
SIEHE AUCH 

WEB SET OPTION

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)