4D Doc Center : WEB GET OPTION

4D v13.4

WEB GET OPTION


WEB GET OPTION ( selector ; valor )

Parámetro	Tipo	Descripción
selector	Entero largo	Código de la opción a modificar
valor	Entero largo, Texto	Valor de la opción

Descripción

El comando WEB GET OPTION permite leer el valor actual de una opción de funcionamiento del servidor web de 4D.

El parámetro selector indica la opción web a leer. Pase en este parámetro una constante del tema Servidor web:

Constante	Tipo	Valor	Comentario
Web Character set	Entero largo	17	Alcance: 4D local, 4D Server Se conserva entre dos sesiones: Sí Descripción: conjunto de caracteres que el servidor Web 4D (con 4D en modo local y 4D Server) utiliza para comunicarse con los navegadores web que se conectan a base. El valor por defecto depende del lenguaje del sistema operativo. Este parámetro se define en las Propiedades de la base. Valores: los valores posibles dependen del modo de ejecución de la base relativos al conjunto de caracteres. Modo Unicode: cuando la aplicación se ejecuta en modo Unicode, los valores a pasar para este parámetro son los identificadores de conjunto de caracteres (MIBEnum longint o Name string, identificadores definidos por IANA, consulte: http://www.iana.org/assignments/character-sets). Está es la lista de los identificadores correspondientes a los conjuntos de caracteres que admite el servidor Web de 4D: 4=ISO-8859-1 12=ISO-8859-9 13=ISO-8859-10 17=Shift-JIS 2024=Windows-31J 2026=Big5 38=euc-kr 106=UTF-8 2250=Windows-1250 2251=Windows-1251 2253=Windows-1253 2255=Windows-1255 2256=Windows-1256 Modo compatibilidad ASCII: 0: Occidental 1: Japonés 2: Chino 3: Coreano 4: Definido por el usuario 5: Reservado 6: Europa central 7: Cirílico 8: Árabe 9: Griego 10: Hebreo 11: Turco 12: Nórdico
Web HTTP Compression Level	Entero largo	50	Alcance: Servidor web local Se conserva entre dos sesiones: No Descripción: nivel de compresión para todos los intercambios HTTP comprimidos efectuados para el servidor HTTP de 4D (peticiones cliente o respuestas servidor, Web y servicio web). Este selector permite optimizar los intercambios con un enfoque en la velocidad de ejecución (menor compresión) o la cantidad de compresión (menor velocidad). La elección de un valor depende del tamaño y la naturaleza de los datos intercambiados. Pase de 1 a 9 en el parámetro valor, 1 es la compresión más rápida y 9 la más alta. También puede pasar -1 para obtener un compromiso entre velocidad y tasa de compresión. El nivel de compresión por defecto es 1 (compresión rápida). Valores posibles: 1 a 9 (1 = más rápido, más comprimido = 9) o -1 = mejor compromiso.
Web HTTP Compression Threshold	Entero largo	51	Alcance: Servidor HTTP local Se conserva entre dos sesiones: No Descripción: en intercambios HTTP optimizados, límite de tamaño de petición por debajo del cual los intercambios no deben comprimirse. Esta opción es útil para evitar pérdidas de tiempo de máquina para comprimir intercambios muy pequeños. Pase en valor un tamaño en bytes. Por defecto, el límite de compresión se establece en 1024 bytes. Valores posibles: todo valor de tipo entero largo. El parámetro valor contiene una tamaño expresado en bytes. Por defecto, el umbral de compresión está definido en 1024 bytes.
Web HTTPS Port ID	Entero largo	39	Alcance: 4D local, 4D Server Se conserva entre dos sesiones: Sí Valores posibles: 0 a 65535 Descripción: número del puerto TCP utilizado por el servidor web de 4D en modo local y de 4D Server para conexiones seguras vía SSL (protocolo HTTPS). El número de puerto HTTPS se define en la página "Web/Configuración" de la caja de diálogo Propiedades de la base. Por defecto, el valor es 443 (valor estándar). Puede utilizar las constantes del tema Números de puerto TCP para el parámetro valor.
Web Inactive process timeout	Entero largo	78	Alcance: servidor web local Se conserva entre sesiones: No, pero permanece válido si el servidor HTTP se reinicia Descripción: permite modificar el timeout del proceso utilizado para la sesión (opción relativa al proceso). Después del timeout, el proceso se elimina en el servidor, se llama al y luego el contexto de la sesión se destruye. Valores: Entero largo (minutos) Valores por defecto: 480 minutos (pase 0 para restablecer el valor por defecto)
Web Inactive session timeout	Entero largo	72	Alcance: servidor web local Se conserva entre dos sesiones: no, pero permanece válido si el servidor HTTP se reinicia Descripción: permite modificar la duración de vida de las sesiones inactivas (duración definida en cookie). Al final de este periodo, la cookie de sesión expira y no se envía más al cliente HTTP. Valores: Entero largo (minutos) Valores por defecto: 480 minutos (pase 0 para restablecer el valor por defecto)
Web IP Address to listen	Entero largo	16	Alcance: 4D local, 4D Server Se conserva entre dos sesiones: Sí Descripción: dirección IP web en la que el servidor web debe recibir las peticiones HTTP con 4D en modo local y 4D Server. Por defecto, ninguna dirección se especifica específica (valor = 0). Este parámetro se define en las Propiedades de la base. El selector IP Address to listen es muy útil en el caso de los servidores web 4D compilados y fusionados con 4D Desktop (no hay acceso al modo Diseño). Pase en el parámetro valor la dirección IP en forma hexadecimal. Es decir, para designar una dirección como "abcd", el código será: `C_LONGINT($addr)$addr:=($a<<24)\|($b<<16)\|($c<<8)\|$d SET DATABASE PARAMETER(IP Address to listen;$addr)`
Web Keep session	Entero largo	70	Alcance: servidor web local Se conserva entre dos sesiones: no, pero permanece válido incluso si se reinicia el servidor HTTP. Descripción: permite activar o desactivar el modo de gestión de las sesiones (descrito en la sección ) Valores: 1 (activar modo) ó 0 (desactivar modo) Valor por defecto: 1 para bases creadas en la versión 13, 0 para bases convertidas. Note que este modo activa igualmente el mecanismo de reutilización de los contextos temporales en modo remoto. Para mayor información sobre este mecanismo, consulte la descripción de esta opción en la sección .
Web Log Recording	Entero largo	29	Alcance: 4D local 4D Server Se conserva entre dos sesiones: sí Descripción: inicia o detiene el registro de peticiones solicitudes Web recibida por el servidor web de 4D en modo local o 4D Server. Por defecto, el valor es 0 (no hay registro de peticiones). El historial de las peticiones web se guarda en un archivo texto llamado "logweb.txt" que se ubica automáticamente en la carpeta Logs de la base, junto al archivo de estructura. El formato de este fichero es determinado por el valor que se pase. Para más información sobre los diferentes formatos de historial de las peticiones, consulte la sección [#title id= "2833"/]. La activación de este archivo también se puede definir en la página "Web/Avanzado" de las Preferencias de 4D. Valores posibles: 0 = No guardar (por defecto), 1 = Registrar en formato CLF, 2 = Registrar en formato DLF, 3 = Registrar en formato DLF, 4 = Guardar en formato WLF. Atención: los formatos 3 y 4 formatos son formatos personalizados, los contenidos deben ser definidos de antemano en las Preferencias de la aplicación, página "Web/Formato del historial". Si usted utiliza uno de estos formatos sin que sus campos hayan sido seleccionados, el archivo de las peticiones no se generará.
Web Max Concurrent Processes	Entero largo	18	Alcance: 4D local, 4D Server Se conserva entre dos sesiones: Sí Descripción: límite estrictamente superior del número de procesos web de todo tipo aceptados por el servidor web con 4D en modo local y 4D Server. Cuando se alcanza el número límite (menos uno), 4D no crea un nuevo proceso y devuelve el mensaje "Servidor no disponible" (estado HTTP 503 - Servicio no disponible) a toda nueva petición. Este parámetro previene la saturación del servidor web de 4D que puede ocurrir durante un envío masivo de peticiones o de una demanda excesiva de creación de contextos. También puede definirse en la caja de diálogo de la Propiedades de la base. En teoría, el número máximo de procesos web es el resultado de dividir la memoria disponible / tamaño de la pila de un proceso web. Otra solución es ver la información sobre los procesos web que se muestra en el Explorador de ejecución: se indican el número actual de procesos web y el número máximo alcanzado desde el inicio del servidor web. Valores: todo valor entre 10 y 32 000. El valor por defecto es 100.
Web Max sessions	Entero largo	71	Alcance: servidor web local Se conserva entre dos sesiones: no, pero permanece válido incluso si se reinicia el servidor HTTP. Descripción: permite limitar el número de sesiones simultáneas. Cuando se alcanza el número definido, la sesión más antigua se cierra (y se llama al ) si el servidor web necesita crear una nueva. Valores posibles: Entero largo. El número de sesiones simultáneas no puede superar el número total de procesos web (opción Web Max Concurrent Processes, 100 por defecto) Valores por defecto: 100 (pase 0 para restablecer el valor por defecto)
Web Maximum requests size	Entero largo	27	Alcance: 4D local, 4D Server Se conserva entre dos sesiones: Sí Descripción: tamaño máximo (en bytes) de las peticiones HTTP entrantes (POST) que el servidor web está autorizado a tratar. Por defecto, el valor predeterminado es 2 000 000, es decir, un poco menos de 2 MB. El valor máximo (2 147 483 648) significa en la práctica que ningún límite se establece. Esta configuración evita la saturación del servidor web, causadas por peticiones entrantes muy grandes. Cuando una petición llega al límite, el servidor web de 4D la rechaza. Valores posibles: 500 000 a 2 147 483 648.
Web Session cookie name	Entero largo	73	Alcance: servidor web local Se conserva entre sesiones: No, pero permanece válido si el servidor HTTP se reinicia Descripción: permite definir el nombre de la cookie utilizada para almacenar el ID de la sesión. Valores: Texto Valores por defecto: "4DSID" (pase una cadena vacía para restablecer el valor por defecto)

Note (v13.2): los códigos adicionales están disponibles para el parámetro selector. Se proponen como constantes en las próximas versiones de 4D pero se pueden utilizar a partir de la versión 13.2. Para mayor información, consulte la descripción del comando WEB SET OPTION.