XL97: Création de fichiers Requêtes sur le Web (.iqy).

INFORMATION TECHNIQUE :

Cette article explique comment créer des fichiers de requête sur le Web (.iqy)
utilisables avec Microsoft Excel 97.

Dans Microsoft Excel 97, les requêtes sur le Web vous permettent de faire des
requêtes sur des données issues d'un site WWW, Internet ou Intranet et de
récupérer les informations directement sur une feuille de calcul Microsoft
Excel. Microsoft Excel 97 est pourvu de quelques requêtes Web. D'autres sont
disponibles sur le site Web de Microsoft à l'adresse suivante :

http://office.microsoft.com/fr-fr/excel/default.aspx (http://office.microsoft.com/fr-fr/excel/default.aspx)


* Définition des fichiers de requête sur le Web :

Un fichier de requête sur le Web est un fichier texte qui contient entre une et
quatre lignes de texte où chaque ligne de texte est séparée par un retour
chariot. Les fichiers de requête Web peuvent être créés avec n'importe quel
éditeur de texte, comme par exemple le NotePad. Ils sont enregistrés sous
l'extension .iqy.


* Création d'un fichier de requête Web :

Pour créer un fichier de requête Web, procédez de la manière suivante :

1. Démarrez un éditeur de texte; le NotePad par exemple.

2. Tapez les quatre lignes de texte dans l'Editeur de texte en utilisant
les informations suivantes :

- Première ligne : Type de la Requête

La première ligne du fichier de requête Web informe Microsoft Excel sur le type
de requête que le fichier contient. A ce jour, les deux seuls types de requêtes
valides sont :
WEB
<ligne omise>
Si vous ne remplissez pas cette ligne, WEB est la valeur par défaut.

- Deuxième ligne : Version de la Requête

La seconde ligne du fichier de requête sur le Web informe Microsoft Excel sur la
version de Microsoft Excel en cours d'exécution. A ce jour, les deux seules
versions valides sont les suivantes :
1
<ligne omise>
Notez que si vous spécifiez le type de votre requête à la première ligne, vous
devez spécifier une version à la seconde ligne. En revanche, si vous omettez le
type, vous ne devez pas préciser la version.

- Troisième ligne : Uniform Resource Locator (URL)

La troisième ligne d'un fichier de requête sur le Web détermine sur quel
document Web la requête agit. A moins que le document Web soit de type POST
(voir la partie "Quatrième ligne : Paramètres POST"), cette information est la
seule donnée nécessaire au fichier de requête Web.

Tapez l'URL dans l'un des formats suivants :

Localisation du fichier Format URL
Document Web http://<serveur>/<file>
Fichier stocké localement <lecteur>:\<répertoire>\<fichier>
Fichier stocké en réseau \\<serveur>\<ressource>\<répertoire>\<fichier>

Où <serveur> est le nom du serveur qui contient le document Web ou le fichier
sur le lecteur du réseau; <fichier> est le nom du document, <lecteur> est le
lecteur qui contient le fichier local, <répertoire> est le nom du répertoire qui
contient le fichier local, et <Ressource> est le nom de ressource du serveur.

- Quatrième ligne : Paramètres POST

La quatrième ligne du fichier de requête Web contient les paramètres POST. Notez
bien que cette ligne est optionnelle et qu'il est nécessaire de la saisir
seulement si la troisième ligne (l'URL) dépasse les 200 caractères.
Lorsque vous recherchez un document Web, les paramètres envoyés au document Web
peuvent être envoyés de deux manières: en paramètre GET ou en paramètre POST.

Lorsque vous utilisez la méthode GET, les valeurs des données sont incluses sur
la même ligne que l'URL. L'exemple suivant montre comment saisir la ligne :
http://<serveur>/>fichier>paramètres
où <serveur> est le nom du serveur qui contient le document Web, et <fichier>
est le nom du document.

Lorsque vous utilisez la méthode POST, les données sont envoyées sur une ligne
distincte. L'exemple suivant montre comment saisir la ligne :
http://<serveur>/<fichier>
paramètres

où <serveur> est le nom du serveur qui contient le document Web, et <fichier>
est le nom du document.

3. Après que vous ayez saisi toutes les lignes requises, enregistrez le
nouveau fichier en tant que fichier texte avec l'extension .iqy (par
exemple, enregistrez le fichier sous le nom marequête.iqy).

4. Quittez l'éditeur de texte.


* Utilisation des paramètres Statiques et Dynamiques dans une requête
sur le Web.

Dans les requêtes sur le Web, vous pouvez utiliser les paramètres Statiques ou
Dynamiques. Les paramètres Statiques envoient des données de requête sans vous
demander de valeurs. Les paramètres Dynamiques vous demandent de saisir une ou
plusieurs valeurs lorsque la requête Web s'exécute.

La syntaxe des paramètres est la suivante :
<paramètres>=<valeur chaîne>
où <paramètre> est le nom d'un paramètre (par exemple, action) et <valeur
chaîne> est une valeur.

La valeur chaîne peut être une des valeurs suivantes :

Type de paramètres Valeur chaîne
Statique Valeur1
Dynamique ["valeur1","Veuillez entrer la première valeur:]

Dans la chaîne de valeur dynamique, le premier argument (valeur1) est le nom de
la valeur à entrer. Le second argument est le message qui apparaît lorsque la
requête Web est exécutée.

Si plusieurs paramètres sont requis, séparez les avec le caractère &. L'exemple
suivant vous montre la syntaxe à utiliser:
Cours1=action1&cours2=action2

Lorsque plusieurs valeurs sont envoyées pour un unique paramètre, séparez les
avec un signe plus (+). L'exemple suivant vous montre la syntaxe :
Cours1=action1+action&cours2=action3+action4

Vous pouvez combiner des paramètres Statiques et Dynamiques dans une chaîne de
paramètre simple. L'exemple suivant vous montre la syntaxe :
Cours1=action1&cours2=["action2","Veuillez entrer une seconde valeur :"]


EXEMPLES :

Les exemples qui suivent montre qu'elle est la syntaxe utilisée par les fichiers
de requête sur le Web dans Microsoft Excel 97 :
Notez que ces exemples ne sont pas des requêtes Web qui fonctionnent.

* Exemple 1 :
Cet exemple envoie la valeur "wyut" à Client.exe et récupère une valeur. Il ne
vous est pas demandé de saisir une valeur. Le paramètre est envoyé en utilisant
la méthode GET.
WEB
1
http://www.weylandyutani.com/cgi-bin/client.exe?quote=wyut
Si vous voulez, vous pouvez omettre les deux premières lignes et utiliser la
ligne suivante :
http://www.weylandyutani.com/cgi-bin/client.exe?quote=wyut
Il est possible d'omettre les deux premières lignes lorsque que vous créez le
fichier .iqy. cela est vrai pour tous les exemples utilisés dans cette article.

* Exemple 2 :
Cet exemple envoie les valeurs "wyut" et "hypd" à client2.exe, et ensuite
récupère les valeurs. Il ne vous est pas demandé de saisir des valeurs. Les
paramètres sont envoyés par la méthode POST.
Web
1
http://www.weylandyutani.com/cgi-bin/client2.exe
cours1=wyut&action2=hypd

* Exemple 3 :
Cet exemple vous demande de saisir un symbole d'action boursière, envoie ce
symbole sur client.exe, et récupère une valeur. Les paramètres sont envoyés en
utilisant la méthode GET.
Notez que les troisième et quatrième lignes doivent être saisies sur une ligne
unique dans votre fichier texte.
WEB
1
http://www.weylandyutani.com /cgi-bin/client.exe?quote1=
[action1","Veuillez entrer un symbole d'action:"]

* Exemple 4 :
Cet exemple envoie la valeur "wyut" et une valeur que l'on vous demande entrer
sur client2.exe, et ensuite récupère les valeurs. Les paramètres envoyés
utilisent la méthode POST.
WEB
1
http://www.weylandyutani.com/cgi-bin/client2.exe
cours1=wyut&cours2=["actionk2","Veuillez entrer un symbole d'action :"]

* Exemple 5 :
Cet exemple renvoi le cours des devices tiré du serveur Yahoo.fr
WEB
1
http://fr.finance.yahoo.com/ (http://fr.finance.yahoo.com/)

Pour plus de renseignements, veuillez-vous référer à :

- Le site Web de Microsoft à l'adresse suivante :
http://office.microsoft.com/fr-fr/excel/default.aspx (http://office.microsoft.com/fr-fr/excel/default.aspx)
- l'ouvrage " Microsoft Excel Web Ressource Kit for Microsoft Excel 97 ",
page(s) : 4-6


MOTS-CLES :

La liste de(s) mot(s) suivant(s) permet une recherche plus efficace de cette
fiche technique : 8.00 Query stock quote parameters parametre method directory