Lecture des paramètres d'une URL

 

 

 

Préambule

 

Une URL fixe est supposée fournir toujours le même résultat. Exemple : "http://www.editeurjavascript.com/" fournira toujours la page d'accueil du site. Ce qui fait qu'une URL ayant une racine commune va pouvoir donner des résultats différents c'est le fait que des paramètres peuvent être envoyés conjointement.

 

Exemple : "http://www.a-ressources.net/Record.htm?record=183112490139" et "http://www.a-ressources.net/Record.htm?record=176112499439" ont une racine commune mais des paramètres différents. Une URL avec paramètres peut être soit incluse telle quelle dans une balise de lien, exemple : <a href="http://www.a-ressources.net/Record.htm?"record=176112499439>, soit produite par un formulaire (méthode GET ou méthode POST).

 

Quelle que soit la manière dont le paramètre a été joint à l'URL (en direct dans l'URL ou via un formulaire en méthode GET ou POST), la fonction permettant de le lire est identique.

 

Fonction : http_GetParam

 

Cette fonction permet de lire la (ou les) valeur d'un paramètre dans une URL ou dans une méthode POST.

 

Syntaxe

 

TCom:= http_GetParam ("Paramètre" ; "séparateur" ; "valeur par défaut")

 

Paramètres

 

Paramètres     Type  Description  

Paramètre       Alpha Paramètre à lire dans l'URL

Séparateur      Alpha (optionnel)   Si un paramètre a plusieurs valeurs, elles seront séparées par   

             cette chaîne de caractères, par un retour si non précisé

Valeur par défaut       Alpha (optionnel)   Permet de renvoyer cette valeur si le paramètre est non trouvé

 

En règle générale, les paramètres optionnels sont ignorés.

 

Exemple

Dans l'URL : "http://www.a-ressources.net/ListRecord.htm?selectobjet=3&what=Manuel"

TCom:= http_GetParam ("what")

TCom prendra la valeur "Manuel"

 

 

Méthode : http_SetParam

 

Cette méthode permet d'affecter une valeur à un paramètre. Elle est généralement utilisée pour détourner un fonctionnement standard des autres méthodes de l'application.

 

Syntaxe

 

http_SetParam ("Paramètre" ; "valeur à affecter")

 

Paramètres

 

Paramètres     Type  Description  

Paramètre       Alpha Paramètre à écrire (ou à remplacer) dans l'URL

valeur à affecter        AlphaNouvelle valeur que doit prendre le paramètre

 

 

Fonction : http_GetSetParam

 

Cette fonction permet de lire un paramètre dans une URL, s'il est présent d'en conserver la valeur dans une fiche paramètre de l'application, s'il est absent de relire la dernière valeur qui avait été affectée à ce paramètre. Exemple typique d'utilisation de cette fonction : le paramètre langue est choisi par l'utilisateur et devient ensuite une variable de contexte (ie : restituée dès que l'utilisateur sollicite à nouveau le serveur) jusqu'à ce qu'il appelle une URL avec à nouveau ce paramètre.

 

Syntaxe

 

TCom:=http_GetSetParam ("Code Paramètre" ; "Paramètre URL"; "valeur àpar défaut")

 

Paramètres     Type  Description  

Code Paramètre        AlphaCode du paramètre dans l'application

Paramètre       Alpha Nom du paramètre dans l'URL

Valeur par défaut       Alpha (optionnel)   Permet d'établir une valeur si ni le paramètre dans l'application

             ni le paramètre dans l'URL ne sont renseignés

-> résultat        Alpha Valeur trouvée dans l'URL ou dans le paramètre de l'application

 

Si l'utilisateur web pour lequel s'exécute cette fonction n'est pas identifié, le paramètre ne sera pas écrit dans la base de données mais dans son dossier de contexte temporaire (Altemp\...\WEBUSERS\GUESTS\...).

 

Exemple

ALang:=http_GetSetParam ("I_LG";"Lang";"")

Charge la langue dans la variable "ALang" à partir du paramètre Web "Lang" ou, s'il est absent, de la fiche paramètre dont le code est "I_LG".