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 Alpha Nouvelle 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 Alpha Code 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".