Les propriétés suivantes peuvent être utilisées pour manipuler une requête HTTP/HTTPS :
| | |
| Nom de la propriété | Type manipulé | Effet |
|---|
| AgentUtilisateur | Chaîne de caractères | 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. |
 Versions 22 et supérieuresAuthToken  Nouveauté 22AuthToken | 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. |
| 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érieuresCertificatClient Nouveauté 24CertificatClient 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 26 et supérieures Nouveauté 26 | Booléen | Indique si la propriété Contenu doit correspondre au contenu brute :- Vrai : la propriété Contenu correspond à un buffer. Aucune modification n'est effectuée.
- Faux (Valeur par défaut) : le contenu est modifié par le navigateur. En particulier, le texte UTF-8 est automatiquement décodé. la propriété Contenu retourne le résultat sous forme d'une chaîne.
|
Versions 25 et supérieuresDébitEnvoiMax Nouveauté 25Dé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. |
Versions 25 et supérieuresDébitTéléchargementMax Nouveauté 25Dé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. |
Versions 24 et supérieuresDestination Nouveauté 24Destination Destination | Chaîne de caractères | Chemin complet du fichier de sauvegarde du résultat de la requête HTTP. |
| 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érieuresl'indication directe de la durée (par exemple '1s' ou '10ms'). Nouveauté 23l'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é. |
| 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érieureshttpIgnoreRedirection : La redirection vers une page est ignorée. Nouveauté 21httpIgnoreRedirection : 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 Nouveauté 22 |
| 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érieureshttpLock : Méthode Lock (protocole WebDAV). Nouveauté 25httpLock : Méthode Lock (protocole WebDAV). httpLock : Méthode Lock (protocole WebDAV). Versions 25 et supérieureshttpMkCol : Méthode mkCol (protocole WebDAV). Nouveauté 25httpMkCol : Méthode mkCol (protocole WebDAV). httpMkCol : Méthode mkCol (protocole WebDAV).Versions 25 et supérieureshttpMove : Méthode Move (protocole WebDAV). Nouveauté 25httpMove : Méthode Move (protocole WebDAV). httpMove : Méthode Move (protocole WebDAV).- httpPatch : Méthode PATCH.
- httpPost : Méthode POST.
Versions 25 et supérieureshttpPropFind : Méthode PROPFIND (protocole WebDAV).. Nouveauté 25httpPropFind : Méthode PROPFIND (protocole WebDAV).. httpPropFind : Méthode PROPFIND (protocole WebDAV)..Versions 25 et supérieureshttpPropPatch : Méthode PROPPATCH (protocole WebDAV). Nouveauté 25httpPropPatch : Méthode PROPPATCH (protocole WebDAV). httpPropPatch : Méthode PROPPATCH (protocole WebDAV).- httpPut : Méthode PUT.
Versions 25 et supérieureshttpUnlock : Méthode Unlock (protocole WebDAV). Nouveauté 25httpUnlock : 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érieuresMotDePasseCertificatClient Nouveauté 24MotDePasseCertificatClient MotDePasseCertificatClient | Chaîne de caractères | Mot de passe associé au certificat client (chaîne vide par défaut). |
Versions 24 et supérieuresProcédureTrace Nouveauté 24ProcédureTrace ProcédureTrace | Procédure | Nom de la procédure WLangage permettant de connaître les entêtes et les données envoyées et reçues. 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 :
- httpTraceDonnéeEnvoyée : Données envoyées.
Versions 26 et supérieureshttpTraceDonnéeRecue : Données reçues. Nouveauté 26httpTraceDonnéeRecue : Données reçues. httpTraceDonnéeRecue : Données reçues. - httpTraceEntêteEnvoyé : Entête envoyé.
Versions 26 et supérieureshttpTraceEntêteRecu : Entête reçu. Nouveauté 26httpTraceEntêteRecu : Entête reçu. httpTraceEntêteRecu : Entête reçu.
- <Data> est un buffer contenant les informations.
Exemple de procédure :
PROCÉDURE ProcTrace(nTypeInfo est entier, ...
bufByData est un Buffer)
SELON nTypeInfo
CAS httpTraceEntêteEnvoyé:
Trace("Entête envoyé : ", ...
UTF8VersChaîne(bufByData))
CAS httpTraceDonnéeEnvoyée:
Trace("Données envoyées : ", ...
bufByData)
CAS httpTraceEntêteRecu:
Trace("Entête reçu : ", ...
UTF8VersChaîne(bufByData))
CAS httpTraceDonnéeRecue:
Trace("Données reçues : ", ...
bufByData)
FIN
|
Versions 21 et supérieuresTimeoutConnexion Nouveauté 21TimeoutConnexion 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érieuresl'indication directe de la durée (par exemple 20 s ou 20000 ms). Nouveauté 23l'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). |
| 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 27 et supérieuresVersionHTTP Nouveauté 27VersionHTTP VersionHTTP | Constante de type Entier | Version du protocole HTTP utilisée par le serveur : - httpVersion2 : Protocole HTTP version 2.0. Si le serveur ne gère pas cette version, une version plus ancienne est utilisée.
- httpVersion2Uniquement : Protocole HTTP version 2.0 forcée : si le serveur ne gère pas cette version, une erreur fatale est affichée.
- httpVersion1_1 : Protocole HTTP version 1.1.
- httpVersion1_0 : Protocole HTTP Version 1.0.
- httpVersionDéfaut : Protocole HTTP Version 1.0.
|
Versions 22 et supérieuresVersionSSL Nouveauté 22VersionSSL 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.
|