Le Sphinx Développement Le Sphinx Utilisation du script d'enregistrement Parc Altaïs Tel. : 04 50 69 82 98 74650 Chavanod contact@lesphinx-developpement.fr Il est possible de mettre un formulaire sur son propre serveur Web, c'est à dire sans acquérir le serveur d'enquêtes ni s'abonner à SphinxOnline. On placera pour cela sur le serveur, avec les fichiers de l'enquête, un programme minimal, le script d'enregistrement. Ce script d'enregistrement peut être utilisé sur les plates-formes Windows, Linux ou Unix. Il permet uniquement l'enregistrement des formulaires. La visualisation des résultats en temps réel, le contrôle d'accès, la restitution de variables calculées, la modification des réponses, certaines fonctions d'interactivité du serveur d'enquêtes ne sont pas possibles (renvois, affichage conditionnel, disposition aléatoire des modalités, scoring,...). On effectue l'opération en choisissant l'article Enregistrer au format HTML... du menu Fichier. Tous les fichiers nécessaires seront copiés dans un répertoire sur le disque dur. Le chargé détudes communiquera ce répertoire à l'administrateur du serveur web. L'administrateur placera les fichiers du répertoire sur le serveur en donnant les droits nécessaires décrits cidessous. L'administrateur indiquera au chargé d'études l'url complète du fichier Questionnaire.htm. C'est cette URL (adresse Internet) qui sera communiquée aux répondants. Assistant de publication Un assistant permet de choisir certaines options comme la présentation dans une page web, l'enregistrement de variables de contrôle, l'action après enregistrement et la localisation des fichiers. les différentes options des trois premières étapes sont décrites dans les paragraphes concernant l'assistant de publication du serveur d'enquêtes.
Dans la quatrième étape, on indique la localisation respective des fichiers et le système d'exploitation du serveur. Localisation des fichiers Localisation du Script d'enregistrement Lorsque le répondant clique sur Enregistrer, le script d'enregistrement se déclenche. Il est donc nécessaire de connaître l'url du script. L'URL est indiquée dans l'assistant sous la forme du chemin absolu à partir de la racine du serveur ou bien sous la forme du chemin relatif à partir du fichier questionnaire.htm. On laissera formscript.exe si tous les fichiers seront placés dans le même répertoire On précisera /cgi-bin/formscript.exe si les scripts doivent être dans le répertoire cgi-bin (serveur Apache par exemple) Localisation des fichiers de l'enquête Le script va recevoir une chaine de caractères avec les réponses qu'il va placer dans les fichiers de réponses. Là aussi il est nécessaire que FormScript.exe soit informé de la localisation des fichiers de l'enquête. On indique soit le chemin absolu à partir de la racine du serveur, soit le chemin relatif à partir de FormScript.exe. On laissera enquete si les fichiers de l'enquête vont être placés à côté du script On précisera /data/enquete si les fichiers de données (accessibles en écriture) sont dans le répertoire data. Solution pour IIS Les chemins relatifs sont alors respectivement Formscript.exe et enquete. Tous les fichiers, c'est à dire questionnaire.htm, questionnaire.gif, eurekapplet.jar, formscript.exe, enquete.rep, enquete.ouv, enquete.que seront placés dans le même répertoire. On donnnera un contrôle total sur ce répertoire. Solution pour Apache Les chemins relatifs sont alors respectivement /cgi-bin/formscript.exe et enquete. Le script et les fichiers de l'enquête (formscript.exe, enquete.rep, enquete.ouv, enquete.que seront placés dans le répertoire chi-bin. La page questionnaire.htm (et les fichiers questionnaire.gif et eurekapplet.jar) seront placés dans un même répertoire sous la racine du serveur. Aucune configuration n'est nécessaire pour ce répertoire. Solution personnalisée Si l'administrateur du serveur souhaite, pour des raisons de sécurité par exemple, placer les pages dans un répertoire, les scripts dans un répertoire particulier et les fichiers de l'enquête dans un troisième, il faudra tisser les liens adéquats. Cette opération peut se faire a posteriori en modifiant le fichier questionnaire.htm (voir le paragraphe suivant à l'attention du Webmaster). Modes opératoires Comment configurer rapidement les fichiers transmis par le chargé d'études Serveur IIS Serveur Apache Note à l'intention du Webmaster Exemples Des archives auto-extractibles contenant une enquête exemple pour différents serveurs peuvent être téléchargées sur notre site Internet : http://www.sphinxonline.com/documentation/fswin-apache.exe http://www.sphinxonline.com/documentation/fslinux-apache.exe http://www.sphinxonline.com/documentation/fswin-iis.exe 2
Principe de fonctionnement Le questionnaire se présente sous la forme d une seule page au format html, par défaut Questionnaire.htm. Si le format choisi dans l'assistant est HTML, la page contient un formulaire HTML, si le format est JAVA, la page fait référence à une applet java. Cette applet (EurekaApplet.jar) utilise des images au format GIF (Questionnaire1.gif, questionnaire2.gif, ) pour présenter les différents écrans du formulaire tels qu ils ont été mis en page. En fin de saisie, les éléments de réponses sont transmis sur le serveur à un script (FormScript.exe) qui effectue l enregistrement des réponses dans les fichiers de l enquête (enquete.que, enquete.rep, enquete.ouv). Sur les serveurs Linux ou Unix, les réponses sont enregistrées sous un format simplifié en ASCII dans le fichier enquete.txt. C'est à l'importation des réponses que la conversion sera faite. Serveurs Linux et Unix Pour Linux, le fichier exécutable FormScript est présent dans le répertoire Eurêka \ Modules. Ce fichier a été produit pour Linux Redhat 7.0 kitée, avec un noyeau 2.2.16-22 et un compilateur gcc version 2.96. Il peut s'avérer nécessaire de recompiler le script (voir ci-dessous). Pour Unix, compte tenu du nombre de plate-formes, le script n'est pas fourni et devra être recompilé en utilisant le programme source FormScript.c et le fichier de compilation Makefile. Tous ces fichiers se trouvent dans le répertoire Eurêka \ Modules du répertoire d'installation. Le fichier exécutable ainsi produit devra être nommé FormScript et être placé dans le répertoire Eurêka \ Modules du répertoire d'installation sur l'ordinateur du chargé d'études. Description du fichier HTML Le fonctionnement décrit ci-dessus implique que toutes les informations nécessaires (emplacement du script, des applets, des fichiers d enquêtes, de l URL de retour) doivent être contenues dans la page questionnaire.htm. Ces informations sont données lors de la création du fichier Questionnaire.htm dans l assistant de publication. Elles peuvent être modifiées en éditant directement le fichier Questionnaire.htm. Présentation JAVA Les chemins indiqués dans Questionnaire.htm sont : APPLET CODE : chemin de l applet java relativement au fichier Questionnaire.htm SCRIPT VALUE : chemin du script relativement au fichier Questionnaire.htm suivi du chemin des fichiers de l enquête relativement au script. PAGE1 VALUE : images pour l applet relativement au fichier Questionnaire.htm Ces chemins peuvent également être inscrits en absolu depuis la racine du serveur ou depuis l url du site. Exemple 1 Les scripts et les fichiers de l'enquête (xxx.*) sont dans le répertoire cgi-bin, les pages et l'applet sont dans un sous-répertoire quelconque du répertoire htdocs. (serveur Apache) <PARAM NAME=SCRIPT VALUE="/cgi-bin/FormScript.exe?survey=xxx"> Exemple 2 Les scripts sont dans le répertoire scripts, les fichiers de l'enquête dans un répertoire data et les pages sont dans un sous-répertoire queslconque du répertoire wwwroot. <PARAM NAME=SCRIPT VALUE="/scripts/FormScript.exe?survey=/data/xxx"> Présentation HTML La syntaxe est légèremlent différente mais les principes restent les mêmes Exemple 1 <FORM METHOD=POST ACTION="/cgi-bin/FormScript.exe"> <INPUT TYPE="HIDDEN" NAME="survey" VALUE="enquete"> Exemple 2 <FORM METHOD=POST ACTION="/scripts/FormScript.exe"> <INPUT TYPE="HIDDEN" NAME="survey" VALUE="data"> 3
Configuration des droits Attribution des droits dans le serveur http Il faut donner au serveur http le droit d exécuter FormScript.exe. Par exemple pour le serveur IIS, dans le gestionnaire de service Internet, on regarde les propriétés du répertoire du script. Les autorisations d exécutions doivent s appliquer aux scripts et aux exécutables. Si ces droits ne sont pas correctement attribués, l'internaute se verra proposer le téléchargement de formscript.exe!!! Attribution des droits dans le système de fichiers Si le serveur utilise un système de fichiers tel que NTFS, qui permet de définir des autorisations pour chacun des utilisateurs déclarés, il faut également déclarer correctement les droits sur les fichiers de l enquête. En effet, lorsque l internaute clique sur le bouton Enregistrer pour valider le formulaire, FormScript écrit dans les fichiers de réponses de l enquête. A l aide de l explorateur Windows, visualisez les propriétés des fichiers. Il faut vérifier qu ils aient bien les autorisations en lecture et en écriture pour l'utilisateur Windows qui représente le serveur Web. Si ces droits ne sont pas correctement attribués, l'internaute recevra un message d'erreur. Les dialogues ci-dessus sont les deux environnements de paramétrage des droits pour le serveur Web IIS 5 sur le système d'exploitation Windows 2000. Ces dialogues ou fichiers de configuration seront différents pour d'autres serveurs (IIS 4, Apache,...) ou pour Windows NT. Récupération des réponses Recopier les fichiers de l'enquête (serveur Windows) Pour les serveurs Windows, le script FormScript.exe écrit les réponses directement dans les fichiers de l'enquête au format Sphinx. Ces fichiers seront ensuite copiés sur l'ordinateur du chargé d'études pour en faire l'analyse. Importer les fichiers de réponses (serveur Linux ou Unix) Pour les serveurs Linux et Unix, le format des fichiers est un format simplifié (fichiers ASCII). Ces fichiers sont ensuite importés dans le logiciel (Bouton Importer du panneau de commande). 4
Le format de ces fichiers est le même que le format des fichiers de saisie sur WindowsCE ou avec le programme minimal de saisie. Voici un extrait d'un tel fichier : id=1c373c4e42f12c52&v1=1&v2=1&v3=2&v5=1&v10=5&v11=4&v12=4&v13=2&v14=3&v15=3&date =27%2F06%2F2001+14%3A20%3A25 L'identificateur unique d'enquête (id=1c373c4e42f12c52)servira de "preuve par neuf" que ce fichier correspond bien à l'enquête dans laquelle on veut l'importer. Résolution des problèmes Si la mise en ligne d'une enquête sur SphinxOnline est quasi-automatique, la mise en ligne sur un serveur web demande une coopération entre le chargé d'études et l'administrateur du serveur web. Voici les incidents les plus fréquents : Quand on accède à la page Questionnaire.htm, il y a un écran gris. Le navigateur que vous utilisez ne permet pas d'exécuter les Applets Java. Il s'agit d'une version très ancienne du navigateur ou bien celui-ci a été bridé par votre service informatique. Faites une mise à jour ou bien republiez l'enquête en choisissant HTML comme format d'affichage du questionnaire. Quand on clique sur le bouton enregistrer, à la fin du questionnaire, il ne se passe rien. Attention, le script ne peut fonctionner que si le questionnaire est invoqué à travers un serveur, pas si vous ouvrez questionnaire.htm depuis votre disque dur. Quand on clique sur le bouton enregistrer, le serveur renvoie l'erreur "Page introuvable". Le script FormScript.exe n'est pas à l'endroit attendu. Vérifier que FormScript.exe est bien dans le répertoire de l'enquête sur le serveur. Vérifier dans l'assistant de publication que vous avez bien indiqué FormScript.exe dans l'url du script. Quand on clique sur le bouton enregistrer, un dialogue propose de télécharger le fichier FormScript.exe. L'administrateur n'a pas configuré correctement les droits d'exécution pour le programme FormScript.exe. Quand on clique sur le bouton enregistrer, le serveur renvoie l'erreur "Erreur d'enregistrement ID=1". Les fichiers de réponses (enquete.rep et enquete.ouv) se sont pas à l'endroit attendu. Vérifier que enquete.rep est bien dans le répertoire de l'enquête sur le serveur. Vérifier dans l'assistant de publication que vous avez bien indiqué enquete comme chemin relatif de l'enquête par rapport au script. Quand on clique sur le bouton enregistrer, le serveur renvoie l'erreur "Erreur d'enregistrement ID=2". L'administrateur n'a pas configuré correctement les droits d'écriture pour les fichier de réponses enquete.rep et enquete.ouv. Résumé Voici une "check-list" pour installer le programme minimal dans un environnement Intranet Les programmes s'installent dans l'environnement d'un serveur web acceptant les scripts CGI. Le chargé d'études communique à l'administrateur du serveur un répertoire à placer sur le serveur web. Les droits (serveur web + système de fichiers) d'exécution et d'écriture seront donnés à ce répertoire. Pour les serveurs sous Windows, nous fournissons le script compilé FormScript.exe. Pour les serveurs sous Linux et unix, le script FormScript devra être recompilé à partir du fichier source FormScript.c et placé dans le répertoire de l'enquête. L'adresse à indiquer au répondants est l'url du fichier questionnaire.htm de ce répertoire L'administrateur renverra le contenu du répertoire au chargé d'études 5
6