La commande HTTP FIXER 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 |
Commentaire |
HTTP afficher dial auth |
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 AUTHENTIFIER. 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 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 effacer infos auth |
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 redirections max |
Entier long |
3 |
valeur = nombre maximum de redirections acceptées Valeur par défaut = 2 |
HTTP suivre redirection |
Entier long |
2 |
valeur = 0 (ne pas accepter les redirections) ou 1 (accepter les redirections). Valeur par défaut = 1 |
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.