Propriétés spécifiques à la description des variables de type httpRequête

Nom de la propriété	Type manipulé	Effet
AgentUtilisateur	Chaîne de caractères	Identifie le client. Par défaut, la valeur est "PC SOFT Framework".Identifie le client. Par défaut, la valeur correspond au nom de l'application. Le contenu de la réponse peut dépendre de l'agent utilisateur (par exemple, une requête effectuée à partir d'un Palm Pilot nécessite des pages différentes d'une requête effectuée avec un navigateur PC). Dans ce cas, consultez la documentation de l'agent utilisateur pour plus de détails. Non disponible.
Versions 22 et supérieures AuthToken Nouveauté 22 AuthToken AuthToken	Variable de type AuthToken	Token d'accès à un Webservice à utiliser en cas d'authentification via le protocole OAuth 2.0. Ce token d'accès a été récupéré via la fonction AuthIdentifie. Le token d'accès est automatiquement passé au paramètre access_token directement sur l'URL. Si le paramètre doit être différent, construisez vous-même l'URL http à exécuter. Non disponible.
AvancementEnvoi	Variable de type httpAvancement	Notification de l’état d’avancement de l’envoi des données POST.
AvancementTéléchargement	Variable de type httpAvancement	Notification de l’état d’avancement de la réception.
Versions 24 et supérieures CertificatClient Nouveauté 24 CertificatClient CertificatClient	Chaîne de caractères ou buffer	Correspond : à une chaîne de caractères contenant un chemin d'accès au fichier .p12 contenant le certificat à joindre à la requête. Le chargement du certificat se fera automatiquement en prenant : le certificat présent dans la bibliothèque de l'exécutable (si il a été intégré à l'application), le certificat présent à l'emplacement spécifié sur disque (si le certificat n'a pas été intégré dans la bibliothèque de l'exécutable). à un buffer contenant le certificat (utilisation de la fonction fChargeBuffer). Si cette propriété correspond à une chaîne vide (""), le certificat par défaut est réinitialisée à "<Aucun>".
ContentType	Chaîne de caractères	Type du contenu du message HTTP à envoyer au serveur. Cette propriété est prise en compte uniquement si la méthode d'envoi (propriété ..Méthode) le permet. Par défaut, le type du message correspond à : "application/x-www-form-urlencoded". Il est cependant possible de mettre n'importe quelle valeur, par exemple : "text/xml", "application/javascript", "application/json", "application/xml", "image/jpeg", ... Pour envoyer des données brutes, qui seront lues en une seule fois par le serveur d'application WEBDEV, utilisez les types : "application/octet-stream". "text/xml".
Contenu	Buffer	Message HTTP à envoyer au serveur. Cette propriété est prise en compte uniquement si la méthode d'envoi (propriété ..Méthode) le permet. Le message à envoyer doit respecter le protocole HTTP utilisé. Par défaut, si cette propriété est précisée et non vide, la méthode utilisée est une requête POST sinon c'est une requête GET.
Versions 25 et supérieures DébitEnvoiMax Nouveauté 25 DébitEnvoiMax DébitEnvoiMax	Entier	Vitesse maximale à utiliser pour l'envoi des données, exprimée en kilo-octets par seconde. Cette vitesse est donnée à titre indicatif. 0 (valeur par défaut) signifie que cette vitesse n'est pas limitée. Non disponible.
Versions 25 et supérieures DébitTéléchargementMax Nouveauté 25 DébitTéléchargementMax DébitTéléchargementMax	Entier	Vitesse maximale à utiliser pour la réception des données, exprimée en kilo-octets par seconde. Cette vitesse est donnée à titre indicatif. 0 (valeur par défaut) signifie que cette vitesse n'est pas limitée. Non disponible.
Versions 24 et supérieures Destination Nouveauté 24 Destination Destination	Chaîne de caractères	Chemin complet du fichier de sauvegarde du résultat de la requête HTTP. Non disponible.
DuréeNonRéponse	Entier ou Durée	Temps maximum d'attente de la réponse (exprimé en millisecondes). Cette propriété peut correspondre à : un entier correspondant au nombre de millisecondes, une variable de type Durée, Versions 23 et supérieures l'indication directe de la durée (par exemple '1s' ou '10ms'). Nouveauté 23 l'indication directe de la durée (par exemple '1s' ou '10ms'). l'indication directe de la durée (par exemple '1s' ou '10ms'). Par défaut, cette propriété vaut 20 secondes. Remarque : Le timeout défini avec la fonction HTTPTimeOut n'a pas d'influence sur cette propriété. Non disponible.
Entête	Tableau associatif de chaînes de caractères	Ensemble clé/valeur des entêtes à envoyer. Exemple d'utilisation de cette propriété : cMaRequête..Entête["Authorization"] = ... " WSSE profile=""UsernameToken""" cMaRequête..Entête["X-WSSE"] = ... "UsernameToken Username=blahblah " cMaRequête..Entête["Cache-Control"] = " no-cache"
IgnoreErreur	Constante de type Entier	Spécifie les erreurs ignorées. Correspond à une constante ou une combinaison de constantes : httpIgnoreCertificatInvalide : Le certificat est ignoré. httpIgnoreNomCertificatInvalide : Le nom du site figurant dans le certificat est ignoré. httpIgnoreCertificatExpiré : La date du certificat est ignorée. Versions 21 et supérieures httpIgnoreRedirection : La redirection vers une page est ignorée. Nouveauté 21 httpIgnoreRedirection : La redirection vers une page est ignorée. httpIgnoreRedirection : La redirection vers une page est ignorée. httpIgnoreRenvoiHTTP : Le renvoi vers un serveur non sécurisé est autorisé. httpIgnoreRenvoiHTTPS : Le renvoi vers un serveur sécurisé est autorisé. httpIgnoreRévocation : Le contrôle dans la liste des certificats révoqués est ignoré. Versions 22 et supérieures Seules les erreurs suivantes sont gérées : httpIgnoreCertificatExpiré, httpIgnoreCertificatInvalide, httpIgnoreNomCertificatInvalide, httpIgnoreRévocation, httpIgnoreRedirection. Nouveauté 22 Seules les erreurs suivantes sont gérées : httpIgnoreCertificatExpiré, httpIgnoreCertificatInvalide, httpIgnoreNomCertificatInvalide, httpIgnoreRévocation, httpIgnoreRedirection. Seules les erreurs suivantes sont gérées : httpIgnoreCertificatExpiré, httpIgnoreCertificatInvalide, httpIgnoreNomCertificatInvalide, httpIgnoreRévocation, httpIgnoreRedirection. Non disponible.
Méthode	Constante de type Entier	Méthode HTTP utilisée : httpCopy : Méthode COPY. httpDelete : Méthode DELETE. httpGet : Méthode GET. httpHead : Méthode HEAD. Versions 25 et supérieures httpLock : Méthode Lock (protocole WebDAV). Nouveauté 25 httpLock : Méthode Lock (protocole WebDAV). httpLock : Méthode Lock (protocole WebDAV). Versions 25 et supérieures httpMkCol : Méthode mkCol (protocole WebDAV). Nouveauté 25 httpMkCol : Méthode mkCol (protocole WebDAV). httpMkCol : Méthode mkCol (protocole WebDAV). Versions 25 et supérieures httpMove : Méthode Move (protocole WebDAV). Nouveauté 25 httpMove : Méthode Move (protocole WebDAV). httpMove : Méthode Move (protocole WebDAV). httpPatch : Méthode PATCH. httpPost : Méthode POST. Versions 25 et supérieures httpPropFind : Méthode PROPFIND (protocole WebDAV).. Nouveauté 25 httpPropFind : Méthode PROPFIND (protocole WebDAV).. httpPropFind : Méthode PROPFIND (protocole WebDAV).. Versions 25 et supérieures httpPropPatch : Méthode PROPPATCH (protocole WebDAV). Nouveauté 25 httpPropPatch : Méthode PROPPATCH (protocole WebDAV). httpPropPatch : Méthode PROPPATCH (protocole WebDAV). httpPut : Méthode PUT. Versions 25 et supérieures httpUnlock : Méthode Unlock (protocole WebDAV). Nouveauté 25 httpUnlock : Méthode Unlock (protocole WebDAV). httpUnlock : Méthode Unlock (protocole WebDAV). Par défaut, si la propriété ..Contenu est non vide, la méthode httpPost est utilisée. Dans le cas contraire, la méthode httpGet est utilisée.
MotDePasse	Chaîne de caractères	Mot de passe associé au nom d'utilisateur (chaîne vide par défaut). Permet d'accéder à une page avec une URL protégée. Attention : Le mot de passe est transmis en clair sur Internet. Remarque : En renseignant les propriétés ..NomUtilisateur et ..MotDePasse, le "Authorization:Basic" correspondant est automatiquement généré dans l'entête de la requête.
Versions 24 et supérieures MotDePasseCertificatClient Nouveauté 24 MotDePasseCertificatClient MotDePasseCertificatClient	Chaîne de caractères	Mot de passe associé au certificat client (chaîne vide par défaut).
Versions 24 et supérieures ProcédureTrace Nouveauté 24 ProcédureTrace ProcédureTrace	Procédure	Nom de la procédure WLangage permettant de connaître les entêtes et les données envoyées. Cette procédure est de la forme : PROCÉDURE <Nom procédure>(<TypeInfo> est entier, <Data> est un Buffer) où : <TypeInfo> est une constante de type Entier correspondant au type de données tracées : httpTraceEntêteEnvoyé : Entête. httpTraceDonnéeEnvoyée : Données. <Data> est un buffer contenant les informations. Exemple de procédure : PROCÉDURE ProcTrace(nTypeInfo est entier, ... bufByData est un Buffer) SELON nTypeInfo CAS httpTraceEnteteEnvoye: Trace("Entete : ", ... UTF8VersChaîne(bufByData)) CAS httpTraceDonneeEnvoyee: Trace("Donnees : ", ... bufByData) FIN Non disponible.
Versions 21 et supérieures TimeoutConnexion Nouveauté 21 TimeoutConnexion TimeoutConnexion	Entier ou Durée	Temps maximal d'attente pour la connexion exprimé en millisecondes (par défaut 20 secondes, soit 20000 millisecondes). Cette propriété peut correspondre à : un entier correspondant au nombre de millisecondes, une variable de type Durée, Versions 23 et supérieures l'indication directe de la durée (par exemple 20 s ou 20000 ms). Nouveauté 23 l'indication directe de la durée (par exemple 20 s ou 20000 ms). l'indication directe de la durée (par exemple 20 s ou 20000 ms). Si à la fin de ce délai, la connexion n'a pas pu s'effectuer, il y a échec de la connexion (la fonction HTTPEnvoie par exemple renverra une erreur, contenue dans la variable résultat de type httpRéponse). Non disponible.
URL	Chaîne de caractères	Adresse du serveur à contacter sous forme d'adresse URL. Cette URL peut contenir : le numéro de port pour la connexion sur le serveur. La valeur par défaut est 80 en HTTP (correspond à un serveur de pages Web) et 443 en HTTPS. Pour spécifier un numéro de port, utilisez le format : "<URL du serveur>:<N° du port>". Par exemple : "http://www.pcsoft.fr:80". des paramètres supplémentaires. Ces paramètres peuvent permettre d'effectuer une recherche ou de remplir un formulaire. Par exemple, pour rechercher "pcsoft" sur "http://www.google.fr", l'URL à contacter sera : "http://www.google.fr/search?q=pcsoft". Remarques : Pour spécifier à la fois le numéro de port et des paramètres supplémentaires, utilisez le format : "<URL du serveur>:<N° du port>/<Paramètres supplémentaires>". Pour réaliser une transaction sécurisée, l'URL doit commencer par la chaîne "https://". Dans ce cas, le mode de gestion des requêtes est toujours effectué par Internet Explorer (pour plus de détails, consultez la fonction HTTPParamètre).
Utilisateur	Chaîne de caractères	Nom permettant d'accéder à une page avec une URL protégée (chaîne vide par défaut). Ce nom permet d'identifier l'utilisateur. Remarque : En renseignant les propriétés ..Utilisateur et ..MotDePasse, le "Authorization:Basic" correspondant est automatiquement généré dans l'entête de la requête.
Versions 22 et supérieures VersionSSL Nouveauté 22 VersionSSL VersionSSL	Constante de type Entier	Version SSL utilisée : ProtocoleDéfaut : Protocole par défaut (TLS 1.2). ProtocoleTLS1 : Protocole TLS1. ProtocoleTLS1_1 : Protocole TLS1.1. ProtocoleTLS1_2 : Protocole TLS1.2. Non disponible.

• <Nom de la variable>..<Nom de la propriété>
• <Nom de la variable>.<Nom de la propriété>

Remarques

• Versions 21 et supérieures
  Par défaut, les redirections sont gérées. Pour ne pas gérer les redirections, utilisez la constante httpIgnoreRedirection dans la propriété ..IgnoreErreur.
  Nouveauté 21
  Par défaut, les redirections sont gérées. Pour ne pas gérer les redirections, utilisez la constante httpIgnoreRedirection dans la propriété ..IgnoreErreur.
  Par défaut, les redirections sont gérées. Pour ne pas gérer les redirections, utilisez la constante httpIgnoreRedirection dans la propriété ..IgnoreErreur.