HTTP SET OPTION

4D v16.3

HTTP SET OPTION


HTTP SET OPTION ( option ; valeur )

Paramètre	Type	Description
option	Entier long	Code de l’option à fixer
valeur	Entier long	Valeur de l’option

Description

La commande HTTP SET OPTION permet de définir différentes options qui seront utilisées lors de la prochaine requête HTTP déclenchée par les commandes HTTP Get ou HTTP Request. Vous pouvez appeler cette commande autant de fois qu’il y a d’options à fixer.

Note : Les options définies sont locales au process courant. Dans le cadre d’un composant, elles sont locales au composant en cours d’exécution.

Passez dans le paramètre option le numéro de l’option à définir et dans le paramètre valeur la nouvelle valeur de l’option. Vous pouvez utiliser pour le paramètre option une des constantes prédéfinies suivantes, placées dans le thème Client HTTP :

Constante	Type	Valeur	Comment
HTTP compression	Entier long	6	valeur = 0 (ne pas compresser) ou 1 (compresser). Par défaut : 0 Cette option permet d’activer ou d’activer le mécanisme de compression des requêtes entre le client et le serveur, destiné à accélérer les échanges. Lorsque ce mécanisme est activé, le client HTTP utilise la compression deflate ou GZIP en fonction de la réponse du serveur.
HTTP display auth dial	Entier long	4	valeur = 0 (ne pas afficher le dialogue) ou 1 (afficher le dialogue). Par défaut : 0 Cette option gère l’affichage de boîte de dialogue d’authentification lors de l’exécution de la commande HTTP Get ou HTTP Request. Par défaut, cette commande ne provoque jamais l'affichage de la boîte de dialogue, vous devez en principe utiliser la commande HTTP AUTHENTICATE. Toutefois, si vous souhaitez qu’une boîte de dialogue d’authentification apparaisse pour que l’utilisateur saisisse ses identifiants, passez 1 dans valeur. La boîte de dialogue n’apparaît que si la requête requiert une authentification.
HTTP follow redirect	Entier long	2	valeur = 0 (ne pas accepter les redirections) ou 1 (accepter les redirections). Valeur par défaut = 1
HTTP max redirect	Entier long	3	valeur = nombre maximum de redirections acceptées Valeur par défaut = 2
HTTP reset auth settings	Entier long	5	valeur = 0 (ne pas effacer les informations) ou 1 (les effacer). Par défaut : 0 Cette option permet d’indiquer à 4D de réinitialiser les informations d'authentification de l’utilisateur (nom d'utilisateur, mot de passe, méthode) après chaque exécution d’une commande HTTP Get ou HTTP Request dans un même process. Par défaut, ces informations sont conservées et réutilisées à chaque requête. Passez 1 dans valeur pour les effacer après chaque appel. A noter que quel que soit le paramétrage, les informations sont effacées lorsque le process est détruit.
HTTP timeout	Entier long	1	valeur = timeout de la requête cliente, exprimé en secondes. Le timeout est le délai d’attente du client HTTP en cas de non-réponse du serveur. A l’issue de ce délai, le client referme la session, la requête est perdue. Par défaut, ce délai est de 120 secondes. Il peut être modifié en raison de caractéristiques particulières (état du réseau, spécificités de la requête, etc.).

L’ordre d’appel des options n’a pas d’importance. Si une même option est définie plusieurs fois, seule la valeur du dernier appel est prise en compte.

Voir aussi

HTTP AUTHENTICATE
HTTP GET OPTION