HTTP SET OPTION

4D v20 R7

HTTP

HTTP SET OPTION


HTTP SET OPTION ( opcion ; valor )

Parámetro	Tipo	Descripción
opcion	Entero largo	Código de la opción a definir
valor	Entero largo	Valor de la opción

Descripción

El comando HTTP SET OPTION permite definir diferentes opciones utilizadas durante la próxima petición disparada por los comandos HTTP Get o HTTP Request. Puede llamar este comando tantas veces como opciones a definir.

Nota: las opciones definidas son locales al proceso actual. Para componentes, son locales al componente en ejecución.

Pase en el parámetro opcion el número de la opción a definir y en el parámetro valor el nuevo valor de esta opción. Puede utilizar para el parámetro opcion una de las siguientes constantes, que se encuentran en el tema HTTP Client:

Constante	Tipo	Valor	Comentario
HTTP client log	Entero largo	7	valor = una de las siguientes constantes: HTTP disable log: el registro de depuración del cliente HTTP está deshabilitado (por defecto) HTTP enable log with all body parts: el registro de depuración del cliente HTTP está habilitado con las partes del cuerpo de la respuesta y de la petición HTTP enable log with request body: el registro de depuración del cliente HTTP está habilitado con la parte del cuerpo de la petición solamente HTTP enable log with response body: el registro de depuración del cliente HTTP está habilitado con la parte del cuerpo en la respuesta solamente HTTP enable log without body: el registro de depuración del cliente HTTP está habilitado sin partes del cuerpo (en este caso se suministra el tamaño del cuerpo) Permite obtener o definir el estado del archivo de registro de peticiones del cliente HTTP. Cuando está habilitado, este archivo, llamado "4DHTTPClientLog_nn.txt", se almacena en la carpeta "Logs" de la aplicación (nn es el número de archivo). Es útil para depurar problemas relacionados con las peticiones del cliente HTTP. Registra cada petición y cada respuesta en modo raw. Se registran las peticiones completas, incluyendo los encabezados; opcionalmente, también se pueden registrar las partes del cuerpo. Para más información, consulte la sección Descripción de los archivos de registro.
HTTP compression	Entero largo	6	valor = 0 (no comprimir) ó 1 (comprimir). Por defecto: 0 Esta opción activa o desactiva el mecanismo de compresión de las peticiones entre el cliente y el servidor, para acelerar los intercambios. Cuando este mecanismo está activo, el cliente HTTP utiliza la compresión deflate o GZIP en función de la respuesta del servidor.
HTTP display auth dial	Entero largo	4	valor = 0 (no mostrar el diálogo) o 1 (mostrar el diálogo). Por defecto: 0 Esta opción controla la visualización de la caja de diálogo de autenticación al ejecutar el comando HTTP Get o HTTP Request. Por defecto, este comando no provoca la visualización de la caja de diálogo, normalmente debe utilizar el comando HTTP AUTHENTICATE. Sin embargo, si desea que aparezca una caja de diálogo de autenticación del usuario para que introduzca su nombre de usuario y contraseña, pase 1 en valor. La caja de diálogo aparece sólo si la solicitud requiere autenticación.
HTTP follow redirect	Entero largo	2	valor = 0 (no acepta redirecciones) o 1 (acepta redirecciones). Valor por defecto = 2
HTTP max redirect	Entero largo	3	valor = número máximo de redirecciones aceptadas Valor por defecto = 2
HTTP reset auth settings	Entero largo	5	valor = 0 (no borrar la información) ó 1 (borrar). Por defecto: 0 Esta opción permite indicar a 4D memorizar la información de autenticación del usuario (nombre de usuario, contraseña, método, etc.) Con el fin de volver a usarlos más adelante. Por defecto, esta información se borra después de cada ejecución del comando HTTP Get o HTTP Request. Pase 0 en valor para memorizarlos y para borrarlos. Tenga en cuenta que cuando se pasa 0, la información se conserva durante la sesión, pero no se guarda.
HTTP timeout	Entero largo	1	valor = timeout de la petición del cliente, expresada en segundos. El time out es el tiempo de espera del cliente HTTP en caso de no respuesta por parte del servidor. Al final de este período, el cliente cierra la sesión, la petición se pierde. Por defecto, este tiempo es de 120 segundos. Puede cambiarse en función de características específicas (estado de la red, características de la aplicación, etc).

El orden de llamada de las opciones no tiene importancia. Si la misma opción se define más de una vez, sólo se tiene en cuenta el valor de la última llamada.

Ver también

HTTP AUTHENTICATE
HTTP GET OPTION