NOTE TECHNIQUE INTERNET Accès à une base de données CDS-ISIS sur le Web Volume 2 : Programme GenIsisWeb Version 3.1.2 Décembre 2004 Développement et assistance technique : Pierre Chabert pichabert@wanadoo.fr
Fiche technique : Web. Accès à une base CDS-ISIS (module GenIsisWeb) Décembre 2004 SOMMAIRE Cette note technique a pour objectif d'aider à mettre en place la consultation d'une base de données gérée avec le logiciel CDS-ISIS de l'unesco sur un site web. Complémentaire des notes : "Internet : principes de fonctionnement" "Internet : création d'un site Web" et "CDS/ISIS : fiches techniques", elle décrit la procédure à suivre pour : Installer un logiciel serveur, Paramétrer simplement l'interface WWWISIS développé par BIREME à l'aide de l'utilitaire GenIsisWeb INSTALLATION DE GENISIS WEB... 4 1. Logiciels à installer sur l'ordinateur serveur... 4 1.1. Le logiciel serveur... 4 1.2. Installation de GenIsisWeb... 5 2. Premier lancement de GenIsisWeb... 5 2.1. Alias d'accès aux programmes CGI... 6 2.2. Répertoire des CGI-BIN... 6 2.3. Méthode d'accès aux pages statiques... 7 2.4. Vérification de l'installation... 8 CREATION D'UNE NOUVELLE APPLICATION... 9 1. Grille d'interrogation... 9 1.1. Choix des critères de recherche... 10 1.2. Paramétrage des critères de recherche... 10 1.3. Les "éléments" composant la grille d'interrogation... 18 1.4. Test de la grille d'interrogation... 21 1.5. "Retouches" sous éditeur d'une grille d'interrogation... 22 1.6. Paramétrage des images associées aux "boutons"... 22 2. Affichage des résultats : Format Liste... 23 2.1. Création d'un format "interne"... 24 2.2. Appel d'un format "externe" existant... 30 2.3. Onglet "Page"... 31 2.4. Onglet "Résultats"... 32 2.5. Onglet "Navigation"... 32 3. Affichage des résultats : Format détaillé... 33 4. Générer l'application... 34 5. Création de "profils"... 34 EXPORTER UNE APPLICATION... 36 1. Paramètres d'export... 36 1.1. Le système d exploitation du serveur d hébergement... 37 1.2. L URL d accès aux modules CGI... 37 1.3. Le répertoire de stockage de l application... 37 1.4. L URL d accès à l'application... 37 1.5. Validation de la procédure d'export... 38 2. Mise à jour de la base de données... 43 2.1. Hébergement sur un serveur de type Windows... 43 2.2. Hébergement sur un serveur de type UNIX... 43 Annexes...42 - Configuration de GenIsisWeb - Codage des caractères accentués - Récapitulatif des éléments indispensables pour créer / diffuser une base Cds-Isis avec GenIsisWeb GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 3
Fiche technique : Web. Accès à une base CDS-ISIS (module GenIsisWeb) Décembre 2004 INSTALLATION DE GENISIS WEB BIREME a développé l'interface WWWISIS (version 3) d'accès à une base CDS- ISIS avec un navigateur WEB. Ce logiciel shareware a été développé pour différentes plate-formes (HP UNIX, SunOS, IBM AIX, PC Linux, PC Windows, PC SCO) et peut être téléchargé à partir de l'url : http://www.bireme.br/wwwisis2.htm Le programme GenIsisWeb permet le paramétrage de l interface WWWISIS. Si l'ordinateur serveur tourne dans un autre système d'exploitation que Windows, il faut utiliser la fonction d'export de GENISIS et télécharger à partir du site de BIREME la version de WWWISIS correspondant à sa plate-forme. Pour être interrogeable à partir du web, la base de données CDS-ISIS ne nécessite pas de paramétrage spécifique : le module permet d'interroger toute base CDS-ISIS quelle qu'en soit la structure. 1. Logiciels à installer sur l'ordinateur serveur 1.1. Le logiciel serveur Un logiciel serveur WEB (Daemon HTTPD) fonctionnant en environnement Windows doit être installé sur l'ordinateur serveur. Exemples de logiciels utilisables (testés avec le module GenIsisWeb) : Apache logiciel gratuit disponible à l adresse : http://www.apache.org/dist/binaries/win32 (fonctionne sous WINDOWS 95, WINDOWS 98 ou WINDOWS NT) Internet Information Server Personal Web Server (PWS) sur une machine WINDOWS NT (logiciel livré en standard avec le système d exploitation WINDOWS NT) livré avec le logiciel FrontPage GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 4
1.2. Installation de GenIsisWeb Sous Windows 95/98, 2000, XP ou NT : Double-cliquer sur le programme SETUP.EXE Répertoire d'installation par défaut : c:\program Files\Genisis Système minimum : Le programme ne fonctionne que dans un environnement 32 bits (Windows 95 ou supérieur) Cas particulier : Dans certains cas, le programme vous informe de la nécessité de mettre à niveau des éléments de Windows et vous propose de redémarrer le système. Il faut redémarrer obligatoirement le système pour que GenIsisWeb soit installé. La phase de redémarrage peut être longue : il ne faut pas s'inquiéter et laisser l'opération aller à son terme. L'installation de GenIsisWeb génère dans le répertoire choisi à cet effet une structure arborescente décrite en fin de document. 2. Premier lancement de GenIsisWeb Pour utiliser GenIsisWeb, il faut démarrer sur le micro-ordinateur un logiciel serveur httpd (Apache, IIS, PWS, ). Si aucun logiciel de ce type n'est installé sur la machine, le logiciel APACHE est particulièrement conseillé (voir site http://www.apache.org) car il sera automatiquement configuré par GenIsisWeb (cf. supra : Installation du logiciel serveur Apache). Au premier lancement de GenIsisWeb, Il faut paramétrer le logiciel : Menu Configuration Options GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 5
2.1. Alias d'accès aux programmes CGI Désigne au niveau du serveur HTTPD le chemin qui permet d'accéder aux programmes CGI et plus particulièrement pour GenIsisWeb au programme WWWI32.EXE de BIREME. Cette valeur généralement affectée à "/cgi-bin/" doit être vérifiée auprès de l'administrateur web. 2.2. Répertoire des CGI-BIN Si le serveur HTTPD APACHE est installé sur le micro et qu'on veut l'utiliser pour les applications, il suffit de cliquer sur le bouton Parcourir pour adapter le paramétrage d'apache à l'utilisation de GenIsisWeb. Cliquer sur le bouton Cliquer sur le bouton Oui Le programme paramètre automatiquement APACHE en effectuant les opérations suivantes : 1) Copie du module CGI WWWI32.EXE développé par BIREME dans le répertoire : c:\program files\apache Group\Apache\Cgi-Bin 2) Déclaration d'un "ALIAS" dans le fichier : c:\program files\apache Group\Apache\Conf\httpd.conf # # GenIsisWeb - Ajout d'un alias 24/04/2001 17:13 Alias /wwwisis/ "C:/[Répertoire d'installation]/wwwisis/" Si vous désirez faire cette déclaration manuellement (ou si vous n'utilisez pas APACHE) la déclaration d'alias se trouve dans le fichier : c:\[répertoire d'installation de GenIsisWeb]\alias.txt GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 6
2.3. Méthode d'accès aux pages statiques Les pages statiques sont la partie "visible" de l'arborescence pour l'utilisateur Internet. L'accès au répertoire les contenant peut se faire en utilisant deux méthodes. L'utilisation d'un ALIAS est conseillé dans la plupart des cas sauf si votre logiciel serveur web n'offre pas cette possibilité (voir avec l'administrateur web). Attention, si vous décidez de changer de méthode par la suite, n'oubliez pas de déplacer les éléments vers l'emplacement adéquat. 2.3.1. En utilisant un "Alias" (conseillé) Cette technique est la plus appropriée car elle permet de laisser le sous répertoire WWWISIS dans le répertoire d'installation de GenIsisWeb et de garder ainsi une certaine cohésion à l'applicatif. Si le serveur HTTPD le permet, il faut déclarer un "Alias" qui "pointera" vers le répertoire WWWISIS. Exemple : Avec le logiciel APACHE : Dans le fichier de configuration : C:\Program Files\Apache Group\Apache\Conf\Httpd.conf il suffit d'ajouter la déclaration suivante : Alias /wwwisis/ "[Répertoire_installation]/wwwisis/" 2.3.2. Sans utiliser d'alias Copier le contenu du répertoire WWWISIS dans le sous répertoire WWWISIS du répertoire "racine" de votre serveur HTTPD (Document Root) Exemple : Avec le logiciel APACHE : Il faut recopier l'ensemble des éléments contenus dans le répertoire WWWISIS dans le répertoire : C:\Program Files\Apache Group\Apache\htdocs\wwwisis GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 7
2.4. Vérification de l'installation Une fois que le paramétrage est terminé : (Re)démarrer votre serveur HTTPD, Lancer un navigateur Tester l'url http://localhost/wwwisis/appli.htm pour vérifier la validité de l'installation. Si votre installation est correcte, vous devez obtenir la page suivante : De même, en cliquant sur le lien pour contrôler l'installation de WWWI32.EXE, vous devez obtenir la page HTML suivante : GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 8
Fiche technique : Web. Accès à une base CDS-ISIS (module GenIsisWeb) Décembre 2004 CREATION D'UNE NOUVELLE APPLICATION La déclaration d'une nouvelle application GENISIS s'effectue en paramétrant les éléments suivants correspondant chacun à des fenêtres différentes : Définition du formulaire d'interrogation : critères de recherche. Définition du format "liste" d'affichage des résultats Définition du format "détaillé" d'affichage des résultats Ouverture de 3 fenêtres de paramétrage : - Grille d'interrogation : paramétrage des critères de recherche - Format "Liste" : paramétrage du format d'affichage court pour visualiser rapidement la liste des réponses obtenues - Format "Détaillé" : paramétrage du format d'affichage long. Il sera activable par l'utilisateur grâce à un lien hypertexte à partir de l'affichage court. Menu Application Nouvelle Sélectionner la base de données ISIS à paramétrer : [base].mst Indiquer le nom associé à l'application 1. Grille d'interrogation GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 9
1.1. Choix des critères de recherche Bouton AJOUTER Affichage de la liste des champs interrogeables déclarés dans la TSC (Table de Sélection des Champs) de la base de données CDS-ISIS Affichage de la liste des champs interrogeables de la base de données ISIS à paramétrer sous la forme : Etiquette du champ = Libellé en clair Ne sont proposés que les champs déclarés dans la Table de Sélection des Champs de la base de données CDS-ISIS. Pour pouvoir rendre interrogeable d'autres champs, il faut aller sous CDS-ISIS et modifier la TSC de la base. L'étiquette ALL (Ensemble des champs) permet de proposer dans un critère de recherche l'interrogation simultanée de l'ensemble des champs. Sélectionner le champ de recherche 1.2. Paramétrage des critères de recherche 1.2.1. Choisir le Type d'élément associé ZONE DE TEXTE A sélectionner pour ouvrir une zone de saisie dans laquelle l'utilisateur va pouvoir saisir sa requête. A cette zone peut être associé l'accès à un "index" pour permettre la sélection des termes interrogés dans une liste déroulante La "zone de texte" est le seul élément auquel on peut associer l'accès à un index GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 10
BOUTON RADIO A sélectionner pour permettre des choix "alternatifs". Un minimum de deux boutons radio est donc nécessaire. Chaque choix est composé de deux éléments distincts, éventuellement identiques : la "valeur d'interrogation" et la "valeur affichée". Exemple : Base de données bibliographiques alimentée en réseau. Le champ 20 contient le code du centre producteur de la référence : CNRE (champ 20=CNRE), INADES (champ 20=INAD), UVICOCI (champ 20=UVIC). Pour que l'utilisateur ait la possibilité d'interroger exclusivement sur le fonds documentaire spécifique d'un centre, on peut proposer trois boutons radio : - Sélectionner le champ 20 - Choisir le type "Bouton radio" - 1 er bouton : Valeur d'interrogation : CNRE Valeur affichée : CNRE - 2 e bouton Valeur d'interrogation : INAD Valeur affichée : INADES - 3 e bouton : Valeur d'interrogation : UVIC Valeur affichée : UVICOCI L'utilisateur ne pourra sélectionner qu'un bouton radio. CASE A COCHER A sélectionner pour permettre des choix "cumulatifs". Chaque choix est composé de deux éléments distincts, éventuellement identiques : la "valeur d'interrogation" et la "valeur affichée". Exemple : Base de données bibliographiques contenant des articles (champ 10=A), des ouvrages (champ 10=O), des études (champ 10=E) Pour permettre à l'utilisateur d'interroger soit uniquement les articles de périodique, soit uniquement les ouvrages, soit uniquement les videos, soit plusieurs types de documents, on peut proposer trois cases à cocher : - Sélectionner le champ 10 - Choisir le type "Case à cocher" - 1 ère case : Valeur d'interrogation : A Valeur affichée : Articles de périodique - 2 e case Valeur d'interrogation : O Valeur affichée : Ouvrage - 3 e case Valeur d'interrogation : E Valeur affichée : Etude L'utilisateur pourra cocher une ou plusieurs cases au choix. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 11
LISTE DEROULANTE VARIABLE CACHEE A utiliser pour permettre à l'utilisateur de choisir un ou plusieurs items dans une liste prédéfinie. Chaque item de la liste est composé de deux éléments distincts, éventuellement identiques : la "valeur d'interrogation" et la "valeur affichée". La "valeur d'interrogation" peut être vide pour obtenir un terme générique dans la liste. La liste peut être saisie en ligne, importée à partir d'un fichier texte ou directement à partir de l'index de la zone interrogée. Cette option est intéressante pour les listes courtes d'items ne nécessitant pas l'affichage d'un index ou pour permettre l'interrogation d'informations codifiées en affichant le libellé en clair. Attention, pour l'importation à partir de fichiers externes, une limite de 200 termes transférés est autorisée. Exemple : Base de données bibliographiques contenant des articles (champ 10=A), des ouvrages (champ 10=O), des études (champ 10=E), des thèses (champ 10=T), des congrès (champ 10=C), des cartes (champ 10=K) - Sélectionner le champ 10 - Choisir le type "Liste déroulante" - 1 er item : Valeur d'interrogation : Ne rien saisir, Laisser cette valeur vide Valeur affichée : Saisir un libellé d'annonce. Ex. : "Sélectionner un type" - 2 e item : Valeur d'interrogation : A Valeur affichée : Article de périodique - 3 e item Valeur d'interrogation : O Valeur affichée : Ouvrage - 4 e item Valeur d'interrogation : E Valeur affichée : Etude - 5 e item Valeur d'interrogation : T Valeur affichée : Thèse - 6 e item Valeur d'interrogation : C Valeur affichée : Congrès - 7 e item Valeur d'interrogation : K Valeur affichée : Cartes - Atlas Possibilité de permettre ou non la sélection multiple dans la liste Cet élément permet de rajouter un critère d'interrogation non affiché qui sera combiné avec le reste de la requête de l'utilisateur (Ex: Interrogation d'un sousensemble pré-sélectionné d'une base de données). Si la grille d'interrogation n'est composée que d'éléments statiques de ce type, elle s'apparente à un "profil" d'interrogation pour afficher automatiquement de l'information stockée dans une base de données (Ex: DSI, Thème du jour, base de GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 12
données de "sites", Revue de presse avec sélection sur une date, Requête sur image clickable,...). cf. infra. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 13
Sélectionner le champ de recherche Choisir le type "Variable cachée" Valeur : indiquer la requête à générer en respectant la syntaxe ISIS Exemple : Base de données bibliographiques qui a fait l'objet d'une publication sur CDROM. On veut donner à l'utilisateur qui possède déjà le CDROM la possibilité de n'interroger que sur la mise à jour depuis la publication du CDROM (champ 30 = NON). Pour pré-sélectionner le sous-ensemble des références qui ne sont pas publiées sur CDROM : Sélectionner le champ 30 Choisir le type "Variable cachée" Saisir dans "Valeur" : NON ZONE DE TEXTE MULTICHAMPS Pour éviter d'avoir une grille d'interrogation trop longue quand on a beaucoup de critères de recherche, cet élément permet de composer une liste déroulante proposant le libellé de plusieurs champs interrogeables alternativement. A chaque champ peut être associé l'accès aux index pour sélectionner directement les termes de la requête. Sélectionner le 1 er champ Paramétrer le 1 er champ Cliquer sur la flèche Sélectionner le 2ème champ, Une fois que tous les champs à regrouper ont été sélectionnés, cliquer sur Valider 1.2.2. Choisir les paramètres d'interrogation PREFIXE Pour éviter les insuffisances de signification d'un terme dans le fichier inversé ou les ambiguïtés, il est possible sous CDS-ISIS d'utiliser la technique des préfixes : insertion devant les termes interrogeables d'une chaîne de caractères explicite facilitant la lisibilité de l'index et la recherche. Si le champ sélectionné contient des préfixes, indiquer la chaîne de caractères utilisée en préfixe. LIBELLE ASSOCIE Indication du libellé affiché devant la fenêtre de saisie des termes recherchés. Par défaut, affichage du libellé de la Table de Définition des Champs avec possibilité de le changer. LIEN SUR LE LIBELLE Permet de faire un lien vers une URL associée, par exemple une page "guide" du critère de recherche : indiquer le nom du fichier HTML GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 14
Les pages d'aide sont des pages HTML statiques qui doivent être stockées sous l'arborescence spécifique du serveur web utilisé. Pour indiquer le chemin d'accès de l'url, 2 possibilités : - Si on n'indique aucun chemin spécifique, l'url liée sera cherchée par défaut dans le répertoire /wwwisis/[nom_appli]/ - Si l'url liée est stockée dans un répertoire différent, il faut écrire le chemin d'accès du fichier lié à partir du répertoire racine du site web. Possibilité de demander l'affichage du guide dans une "sur-fenêtre" : cocher l'option "Afficher dans une nouvelle fenêtre" et indiquer les dimensions de la surfenêtre. Il existe 3 manières d'indiquer les chemins d'accès : Le chemin d'accès absolu indique le chemin complet du document lié, y compris le protocole à utiliser. On l'utilise pour paramétrer le lien vers un document situé sur un autre site : Ex. : http://www.rinoceros.org/actu/presse.htm Le chemin d'accès relatif au document indique le chemin du document lié à partir du répertoire en cours : Ex. : Pour un lien vers un autre document situé dans le même répertoire, on n'indique que le nom du fichier Pour un lien vers un fichier se trouvant dans un autre répertoire :../index.htm Le chemin d'accès relatif à la racine du site indique le chemin d'un document à partir du répertoire racine du site. On définit un répertoire local qui sera l'équivalent du répertoire racine du site web sur la machine serveur sous lequel on déclare toute l'arborescence du site. Ce chemin d'accès est à privilégier car il permet de modifier les emplacements des fichiers. TRONCATURE AUTOMATIQUE Si cette option est cochée, génération automatique de la troncature $ après chaque terme de recherche Exemple : Pour une recherche sur les descripteurs géographiques, la recherche AFRIQUE$ permet de trouver : AFRIQUE AUSTRALE, AFRIQUE DE L'OUEST, AFRIQUE DE L'EST, AFRIQUE DU NORD, TRAITEMENT UNITERME Si cette option est cochée, les "espaces" entre les termes de la question tapée par l'utilisateur sont remplacés automatiquement par l'opérateur booléen choisi entre les articles du critère TAILLE DE LA ZONE DE TEXTE Paramétrage de la longueur de la fenêtre de saisie des termes recherchés OPERATEUR PAR DEFAUT ENTRE ARTICLES Choix de l'opérateur booléen utilisé pour combiner entre eux les termes de la requête. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 15
Ce choix doit être cohérent avec le type de champ et la technique d'indexation utilisée (indexation par articles, par unitermes, ). GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 16
2 possibilités : - L'opérateur booléen est pré-déterminé sans possibilité pour l'utilisateur de le modifier ; - L'opérateur booléen est laissé au choix de l'utilisateur (affichage des opérateurs ET / OU pour sélection par l'utilisateur). Il est possible de pré-sélectionner l'opérateur par défaut le plus adéquat (dans la fenêtre de la grille d'interrogation, cliquer sur le bouton radio correspondant à l'opérateur par défaut). OPERATEUR PAR DEFAUT ENTRE CRITERES Choix de l'opérateur booléen utilisé pour combiner entre eux les critères de recherche. Ce choix doit être cohérent avec la logique de la recherche. L'opérateur booléen peut être laissé au choix de l'utilisateur (affichage des opérateurs ET / OU pour sélection par l'utilisateur) ou pré-déterminé. ELEMENT D'ACCES A L'INDEX Permet à l'utilisateur d'afficher l'index pour sélectionner directement les termes de sa requête. L'activation de l'index peut se faire par une Image, un Lien ou un Bouton. Si on choisit d'activer l'index par un Lien ou un Bouton, il faut indiquer le libellé associé. TYPE D'INDEX AFFICHE Possibilité d'afficher soit le dictionnaire de la base de données CDS-ISIS, soit une image de l'index (fichier externe). Cette option permet d'accélérer le temps d'affichage de l'index dans le cas de bases importantes (au moins 40 000 références) pour les champs dont l'index est composé d'un nombre de termes réduit associé à un grand nombre d'occurrences (ex. : champ "Type de document, champ "Chapitre", ) TITRE DE L'INDEX Permet d'indiquer le titre affiché dans le fenêtre de l'index. CHAMP CDS-ISIS A AFFICHER Le champ à afficher peut être différent du champ interrogé si l'on veut pouvoir interroger un même champ de deux manières différentes (ex. : interrogation d'un champ par articles et par unitermes en n'affichant que la liste des articles : Exemple : Pour pouvoir interroger un champ "Titre de périodique" (500) par articles et par unitermes mais n'afficher que l'index des articles : par exemple pour pouvoir rechercher tous les articles de la revue "LE MONDE DIPLOMATIQUE" en tapant le titre entier ou seulement DIPLOMATIQUE GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 17
Il faut : Sous CDS-ISIS dans la Table de Sélection des Champs, créer les lignes suivantes : 500 0 v500 900 0 v500 900 4 v500 900 est une étiquette fictive qu'on utilisera pour interroger le champ 500 par articles et par unitermes. Sous GenIsisWeb, sélectionner le champ 900 pour interroger et le champ 500 pour afficher l'index. STYLE D'AFFICHAGE Selon le type d'index, on peut choisir une grille de sélection des termes dans l'index plus riche (accès direct par alphabet, zone de recherche). 1.3. Les "éléments" composant la grille d'interrogation 1.3.1. Onglet Formulaire Affichage d'une règle pour dimensionner chaque colonne du tableau. Possibilité de modifier les caractéristiques de chaque zone de la grille d'interrogation : police, taille, couleur, Possibilité de modifier l'ordre des critères d'interrogation en utilisant les flèches de déplacement. Possibilité de tester la grille d'interrogation au fur et à mesure de son élaboration. L'onglet "Formulaire" permet de paramétrer : LE TABLEAU DE PRESENTATION DES CRITERES DE RECHERCHE : - Couleur de fond, Pour indiquer la couleur, soit cliquer sur le bouton donnant accès à la table de sélection des couleurs, soit indiquer le code couleur sous la forme RRVVBB (RR=rouge, VV=vert, BB=bleu) : les valeurs des couleurs primaires sont indiquées au format hexadécimal (de 00 à FF). GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 18
Sur 256 couleurs, seules 216 couleurs sont dites "web safe" : couleurs respectées quelle que soit la combinaison système d'exploitation / navigateur. Ces couleurs correspondent aux combinaisons des codes hexadécimaux : 00 33 66 99 CC FF correspondant aux niveaux de couleurs Rouge Vert Bleu : 51 102 153 204 255 - Taille de la bordure du tableau, - Largeur du tableau (exprimée en %). LE FICHIER DE STYLE ACTIF : Par défaut activation du fichier de style : [répertoire d'installation]\wwwisis\style\form.css Ce fichier de style peut être modifié sous éditeur. LES ELEMENTS DE SOUMISSION DU FORMULAIRE : Les éléments peuvent se présenter au choix sous la forme de boutons, de liens ou d'images. 4 éléments de soumission par défaut sont proposés : - Initialiser : pour effacer le contenu de la grille d'interrogation et poser une nouvelle question - Rechercher : pour lancer la requête - Guide : pour accéder à une page de guide : lien implicite vers le fichier : [répertoire d'installation]\wwwisis\[nom_application]\help.htm - Sommaire : pour quitter l'application : indiquer le nom de l'url associée Pour indiquer le chemin d'accès de l'url, 2 possibilités : - Si on n'indique aucun chemin spécifique, l'url liée sera cherchée par défaut dans le répertoire /wwwisis/[nom_appli]/ - Si l'url liée est stockée dans un répertoire différent, il faut écrire le chemin d'accès du fichier lié à partir du répertoire racine du site web : Les numéros (1, 2, 3, 4) en regard de chacun des éléments permettent de déterminer l'ordre d'affichage des éléments. Si on ne veut pas faire apparaître un élément dans la grille d'interrogation, il suffit d'effacer la légende. Seul l'élément "Rechercher" est obligatoire. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 19
1.3.2. Onglet Index L'onglet "Index" permet de paramétrer : LE TABLEAU DE PRESENTATION DES INDEX : - Titre de l'index : Saisir le titre et choisir les paramètres d'affichage (couleur de fond, couleur de caractères, taille, police, position) - Taille de la bordure du tableau, - Largeur du tableau (exprimée en %). - Dimensions de la fenêtre d'affichage des index : les index sont affichés dans une sur-fenêtre de 400 x 650 pixels par défaut. - Hauteur de la liste - Nombre de termes de la liste à afficher par page LE FICHIER DE STYLE ACTIVE : Par défaut activation du fichier de style : [répertoire d'installation]\wwwisis\style\index.css Ce fichier de style permet de dimensionner les listes déroulantes. Attention, cette option n'est pas reconnue par l'ensemble des navigateurs. Ce fichier de style peut être modifié sous éditeur. LES ELEMENTS DE SOUMISSION DU FORMULAIRE Les éléments peuvent se présenter au choix sous la forme de boutons, de liens ou d'images. 4 éléments de soumission par défaut sont proposés : - Rechercher : pour rechercher un terme dans l'index commençant par la chaîne de caractères indiquée - Page suivante : pour se déplacer dans l'index - Interroger : pour valider les termes sélectionnés et revenir à la grille d'interrogation - Abandonner : pour revenir à la grille d'interrogation sans sélectionner de termes dans l'index GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 20
1.3.3. Onglet Page L'onglet "Page" permet de paramétrer : LA PRESENTATION DE LA PAGE HTML : - Couleur de fond de page - Tableau de présentation du titre : Taille de la bordure, et largeur du bandeau Titre 'exprimée en %) - Titre de la page : Saisir le titre et paramétrer l'affichage (couleur de fond, couleur de caractères, taille, police, position) - Déclarer l'affichage d'un logo dans le titre : - Copier le fichier image dans le répertoire : [Répertoire d'installation]\wwwisis\graphic\ (ou [DocumentRoot]\wwwisis\graphic\ si vous utilisez un "alias" pour l'installation de GenIsisWeb) - Saisir le nom du fichier image encadré par des { } Exemple : {logo.gif} - Nombre de références par page : avec possibilité de donner à l'utilisateur le droit de choisir le nombre de références à visualiser à la fois. 1.4. Test de la grille d'interrogation A chaque étape de la création de votre grille d'interrogation, il est recommandé d'évaluer "l'apparence" de la grille en cliquant sur le bouton Aperçu HTML. La grille s'affiche dans le navigateur par défaut de l'application sous la forme d'une page statique non interactive (pas d'accès aux données) En plus de l'apparence de la grille, il est possible de tester à ce niveau la "logique" d'interrogation définie en tapant une requête,. Une fois que la grille est terminée, il faut générer l'application pour pouvoir la tester en grandeur réelle en mode client/serveur : Menu Application Sauvegarder Générer l'application GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 21
La grille d'interrogation de l'application se trouve dans le répertoire : - Si vous utilisez un ALIAS : [Répertoire d'installation]\wwwisis\[nom_appli].[numéro]\form.htm - Si vous n'utilisez pas d'alias : [DocumentRoot]\wwwisis\[nom_appli].[numéro]\form.htm Pour tester l'application : Menu Application Tester l'application 1.5. "Retouches" sous éditeur d'une grille d'interrogation La grille d'interrogation générée est une page statique. Elle peut être retouchée directement avec un éditeur HTML pour ajuster des paramètres liés à la présentation (Titre de la page, Metabalises, pied de page,.). Si l'application est régénérée ultérieurement, le programme GenIsisWeb propose de ne recharger que la partie "formulaire" de la page pour préserver ainsi les "retouches" effectuées manuellement. Attention, les retouches sous éditeur ne doivent être faites qu'à la fin, quand tout le paramétrage des critères de recherche a été réalisé sous GenIsisWeb et testé. Cette méthode permet de créer plusieurs grilles d'interrogation pour une même application, avec des liens entre ces différentes grilles. La fonction "Application" + "Dupliquer" permet de générer rapidement une copie d'une application existante). Exemples d'utilisation de grilles multiples : Une grille d'interrogation en mode "simple" et une grille en mode "expert' Plusieurs grilles dans des langues différentes Pour lier ces pages entre elles, il vous suffit d'intégrer avec un éditeur HTML des éléments de liaison (lien <A HREF>, liste déroulante, ). Exemple : Pour une grille en plusieurs langues, possibilité de rajouter une "liste déroulante" suivante : <form name="langue"> <select name="menu" onchange= "javascript:location= document.langue.menu.options[document.langue.menu.selectedindex].value"> <option value="/wwwisis/appli.01/form.htm">français</option> <option value="/wwwisis/appli.02/form.htm">anglais</option> <option value="/wwwisis/appli.03/form.htm">espagnol</option> </select> </form> 1.6. Paramétrage des images associées aux "boutons" Les éléments de validation des formulaires, navigation entre les pages peuvent être de trois types : Des "liens" classiques <A HREF.> </A> Des "boutons" Des "images" GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 22
Le choix d'images permet d'adapter le jeu d'image existant pour définir des images personnalisées conformes à la "charte graphique" du site. Les images (.GIF pour pouvoir définir une couleur de transparence) se trouvent dans le répertoire : - Si vous utilisez un ALIAS : [Répertoire d'installation]\wwwisis\graphic - Si vous n'utilisez pas d'alias : [DocumentRoot]\wwwisis\graphic 2. Affichage des résultats : Format Liste Pour l'affichage des résultats, possibilité d'utiliser deux formats d'affichage : Format "liste" pour l'affichage de plusieurs réponses par page. Format "détaillé" pour l'affichage complet, à partir du format "Liste", d'une référence via un "lien html" et/ou d'un lot de références sélectionnées par des "cases à cocher". Pour chacun de ces formats, possibilité d'utiliser les deux techniques suivantes : Création d'un format "interne" Appel d'un format "externe" déjà créé Choix du type de format d'affichage : interne ou externe Choix du n d'ordre ou d'une case à cocher pour accéder au format "détaillé" : 1 : No seul 2 : No avec lien 3 : No / Total 4 : No / Total avec lien 5 : Icone d'activation du lien 6 : Case à cocher X : Rien Paramétrage des formats de présentation (positionnement, police, taille, couleur, ) Accès à la grille de sélection des champs à afficher Si un format n'est pas renseigné, le format par défaut est un affichage complet des référence sous la forme suivante : [Libellé de la Table de Définition des Champs] [Contenu du champ] GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 23
2.1. Création d'un format "interne" Format d'affichage Format interne Bouton Ajouter La création d'un format "interne" ne nécessite pas de connaissance spécifique du langage de formatage de CDS-ISIS ou du langage HTML. Par défaut, le format liste se présente sous la forme d'un tableau : A gauche : libellé du champ A droite : contenu du champ Possibilité d'annuler la présentation en tableau en cochant l'option "Fusionner les cellules" dans l'onglet "Résultats" Sélectionner le champ à afficher Sélectionner le champ à afficher Validation du paramétrage du champ Indiquer le libellé à afficher devant le champ Paramétrage des propriétés d affichage pour le libellé et le contenu En cas de concaténation de champ, possibilité d'indiquer : Un séparateur : ne s'affiche que si le champ précédent et le champ suivant sont remplis Un libellé avant et / ou après : ne s'affiche que si le champ associé est rempli. Possibilité de tester l'affichage en visualisant les fiches Bouton d'actualisation de l'affichage en cas de modification du paramétrage 2.1.1. Libellé Séparateur : en cas de concaténation de champs, possibilité d'indiquer un séparateur entre les champs ne s'affichant que si le champ précédent et le champ suivant sont remplis. Libellé avant et/ou après : en cas de concaténation de champs, possibilité de saisir une chaîne de caractères s'affichant avant et/ou après le contenu du champ si le champ associé est rempli. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 24
Exemple : Pour afficher l'adresse bibliographique composée des champs concaténés : Source : Lieu de publication (500) : Editeur (510), Date (520). Pagination (530) - Saisir le libellé "Source" sans sélectionner de champ associé - Valider Genisis demande de confirmer ce choix : le libellé sera considéré comme une valeur constante qui doit obligatoirement s'afficher - Sélectionner le champ Lieu de publication (500) Pas de libellé avant ni après - Sélectionner le champ Editeur (510) Séparateur : " : " Pas de libellé avant ni après - Sélectionner le champ Date de publication (520) Séparateur : ", " Pas de libellé avant ni après - Sélectionner le champ Pagination (530) Séparateur : ". - " Pas de libellé avant ni après Exemple : Pour afficher l'adresse postale composée des champs concaténés : Adresse (200). Ville (210). Pays (220) Tél. : Téléphone (230) Fax : Fax (240) - Sélectionner le champ Adresse (200) Pas de libellé avant ni après - Sélectionner le champ Ville (210) Séparateur : ". " Pas de libellé avant ni après - Sélectionner le champ Pays (220) Séparateur : ". " Pas de libellé avant ni après - Sélectionner le champ Téléphone (230) Séparateur : ". - " Libellé avant : Tél. : - Sélectionner le champ Fax (240) Séparateur : " - " Libellé avant : Fax : Attributs du libellé : couleur de fond, couleur de texte, police, positionnement, texte du libellé (accessible par le bouton ) Lien vers l'affichage détaillé : Possibilité de faire un lien vers l'affichage au format détaillé à partir du libellé. Le lien défini portera sur l'intégralité du libellé Il est possible d'insérer des "valeurs constantes" dans un format d'affichage : libellé non associé à un champ, par exemple pour insérer des commentaires, un code HTML (ex. : code de passage à la ligne <BR>, insertion d'une ligne de séparation <HR>, ) - Saisir le libellé : texte ou code HTML - Ne pas sélectionner de champ - Cliquer le bouton Valider GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 25
2.1.2. Sélection du champ Champ répétitif : lorsque le champ est répétitif (multi-articles), possibilité de saisir un séparateur d'articles devant s'afficher devant ou après chaque article. Cocher la "case à cocher" pour que le séparateur d'articles ne soit généré qu'entre les différents articles. Indiquer le séparateur d'articles à générer dans le champ répétitif (multi-articles). Case à cocher pour que le séparateur d'articles soit généré uniquement entre les différents articles du champs répétitif. Exemple : Champ Auteur (100) : champ répétitif Si séparateur " ; " devant chaque article : Auteurs : ; Chabert, Pierre ; Raïs, Nadia Si séparateur " ; " après chaque article : Auteurs : Chabert, Pierre ; Raïs, Nadia ; Pour éviter que le séparateur d'articles n'apparaisse en début ou en fin de champ, cocher la case correspondante : Auteurs : Chabert, Pierre ; Raïs, Nadia Sous-champ : lorsque le champ sélectionné est composé de sous-champs, affichage de la liste des délimiteurs déclaré dans la Table de Définition des Champs pour sélection du sous-champ à afficher. 2.1.2. Contenu du champ Attributs du contenu du champ : couleur de fond, couleur du texte, police, positionnement (accessibles par le bouton ) TRAITEMENT COMPLEMENTAIRE Cette option permet d'établir un lien hypertexte ou d'afficher une image. Lien vers affichage "détaillé" : La portée du lien se limitera au contenu du champ et ne portera pas sur la partie "Libellé après". Lien vers messagerie (mailto) : établissement d'un lien hypertexte à partir d'un champ de la base de données CDS-ISIS contenant une adresse email : génération automatique du code mailto: Lien vers site externe (http://) : établissement d'un lien hypertexte à partir d'un champ de la base de données CDS-ISIS contenant une URL : génération automatique du code http:// Requête dans la base : établissement de liens hypertextes en cascade à partir d'un champ. Le champ sélectionné doit obligatoirement être indexé. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 26
Exemple : - Sélectionner champ 500=Descripteurs - Lien : requête sur la base - A l'affichage, chaque descripteur est "clickable" pour sélectionner automatiquement d'autres références sur le même sujet Requête dans une autre base : permet de lancer une question sur une autre base à partir d'une donnée affichée. Pour pouvoir lier un champ, il faut avoir au préalable créer à partir de GenIsisWeb une application sur la base liée. Exemples de liens entre base : Une base bibliographique et un fichier de périodiques Une base d'ouvrages et un fichier de lecteurs Autres cas particuliers : Déclaration d'un lien vers l'application en cours; dans ce cas le mécanisme s'apparente à une requête dans la même base mais avec un affichage dans une nouvelle fenêtre (conserve le "contexte" de la question d'origine) Déclaration d'un lien vers une autre application sur la même base de données pour obtenir des formats d'affichage différents mettant en valeur d'autres informations (exemple : lien sur la cote d'un document et affichage dans une nouvelle fenêtre du producteur, disponibilité). POINT IMPORTANT : La version actuelle du programme GenIsisWeb ne gère pas de façon totalement automatique l'export d'une application si vous avez déclarés des requêtes sur une autre base. Les modifications des formats.pft (affiche2.pft et footer.pft) doivent se faire "à la main" sous éditeur de texte après export de l'application. '<form name="link0">',/ '<input type="hidden" name="t2005" value="[chemin d'accès de la base liée]">',/ '<input type="hidden" name="t2006" value="[répertoire contenant les formats de la base liée]">',/ '</form>',/ GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 27
Le résultat de la requête sur l'autre base s'affichera dans une nouvelle fenêtre du navigateur (POPUP). Le positionnement et les dimensions de cette fenêtre sont paramétrables : - Top = position en pixels du haut de la fenêtre par rapport au haut de l'écran - Left = position en pixels du bord gauche de la fenêtre par rapport au bord gauche de l'écran - Width = Largeur en pixels de la fenêtre - Height = Hauteur en pixels de la fenêtre Lien vers ressource (pdf, doc,..) : établissement d'un lien hypertexte à partir d'un champ de la base de données CDS-ISIS contenant le nom de fichier d'une ressource complémentaire (fichier PDF, word, ). Affichage d'une image : un champ de données ISIS contient le nom d'un fichier image à afficher. Ne pas oublier de préciser le chemin d'accès (au sens URL) de l'image à afficher. Vignette cliquable + image agrandie : permet l'affichage d'une vignette dans une autre fenêtre de l'image agrandie Un champ de données ISIS contient le nom d'un fichier image existant sous deux formes dans des répertoires différents (vignettes + image agrandie). GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 28
Visualisation des éléments cliquables.: Par défaut l'élément affiché est le contenu du champ, mais il est possible d'afficher un élément composé. Cet élément peut être une constante, une icône, l'affichage du champ ou une combinaison de ces éléments. Syntaxes reconnues : Possibilité d'associer une icône à l'affichage du contenu du champ en cochant l'option "Autre". - {imgxx.gif} désigne l'affichage d'une image cliquable - {imgxx.gif,attribut} désigne l'affichage d'une image cliquable avec un attribut ALT - '&' désigne le contenu du champ - Tout le reste est considéré comme du texte Exemple : - Sélectionner champ 100=Auteurs - Lien : requête sur la base - A l'affichage, chaque nom d'auteur est "clickable" pour sélectionner automatiquement d'autres références du même auteur GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 29
Vous pouvez rajouter des icônes dans la liste déroulante qui apparaît sur la gauche de l'écran en placant des images IMGxxx.GIF dans le répertoire : [Répertoire d'installation]\wwwisis\graphic (ou [DocumentRoot]\wwwisis\graphic\ si vous utilisez un "alias" pour l'installation de GenIsisWeb) Vous pouvez stocker dans un champ CDS-ISIS le nom d une ressource externe associée à votre fiche CDS-ISIS : Exemples : Le nom du fichier d'une image obtenue en scannant la couverture d un ouvrage pour une base de données de publications 100=couv01.jpg Le nom d un fichier complémentaire au format PDF 200=rapport2003.pdf Pour une diffusion de votre base de données sur un serveur fonctionnant sous un système UNIX, il faut penser à uniformiser l écriture du nom de ces fichiers (choisir majuscules ou minuscules, éviter les caractères accentués, les espaces, les noms de fichiers trop longs, ) OU COPIER LES FICHIERS EXTERNES? Pour que ces ressources soient accessibles dans l applicatif web, il faut les placer dans un espace "visible" au niveau du serveur httpd et déclarer l url d accès dans la zone Chemin d accès (URL) (toujours en absolu). Les choix possibles sont : Un répertoire placé sous la racine [Document Root] du serveur httpd utilisé Exemple : c:\program files\apache group\apache\htdocs\vignettes\ dans l exemple affiché de la copie d'écran précédent). Un répertoire accessible via un "alias" déclaré au niveau du serveur httpd Exemple : Copier les fichiers dans le répertoire / c:\program files\genisisweb\wwwisis\[base].[n ]\annexes\ et ajouter dans la rubrique "Chemin d accès" la valeur : /wwwisis/[base].[n ]/annexes/). 2.2. Appel d'un format "externe" existant Cette méthode est réservée aux utilisateurs ayant une bonne maîtrise du langage de formatage CDS-ISIS ainsi qu'une connaissance suffisante des balises de présentation du langage HTML et désirant un format d'affichage vraiment spécifique difficile à réaliser avec le module de création de format "interne". Les syntaxes du langage de formatage WINISIS ne sont à ce jour pas toutes reconnues par le module WWWISIS de BIREME. La validité d'un format "externe" est donc fortement dépendante de cette différence de mise à jour entre WINISIS et WWWISIS. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 30
2.3. Onglet "Page" L'onglet "Page" permet de paramétrer : La couleur de fond de la page : Les éléments de soumission du formulaire Les éléments peuvent se présenter au choix sous la forme de boutons, de liens ou d'images. 5 éléments de soumission par défaut sont proposés : - Nouvelle question - Afficher tout - Afficher les fiches sélectionnées : Cet élément n'est accessible que si on a défini une case à cocher dans le format d'affichage. - Annuler sélection - Imprimer : Si on ne veut pas autoriser l'impression en ligne, effacer la légende de cet élément. Les numéros (1, 2, 3, 4, 5) en regard de chacun des éléments permettent de déterminer l'ordre d'affichage. Si on ne veut pas faire apparaître un élément dans la grille d'interrogation, il suffit d'effacer la légende. Seul l'élément "Rechercher" est obligatoire. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 31
2.4. Onglet "Résultats" L'onglet "Résultats" permet de paramétrer : L'affichage de la requête sur la première page : La requête est affichée dans un bandeau (tableau) sous la forme : [x] réponses pour ([requête]) - Tableau de présentation du titre : Taille de la bordure, et largeur du bandeau Titre 'exprimée en %) - Affichage de la requête : Possibilité de modifier le texte de la requête par défaut et paramétrer l'affichage (couleur de fond, couleur de caractères, taille, police, position) Le tableau d'affichage des résultats - Couleur du tableau - Marge interne : espace entre le bord de la cellule et le contenu de la cellule - Marge entre cellules : espace entre les cellules - Largeur du tableau - Taille de la bordure du tableau 2.5. Onglet "Navigation" Paramétrage des modalités de navigation : De fiche en fiche De page en page : affichage d'une barre de navigation en haut et en bas de page GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 32
3. Affichage des résultats : Format détaillé Les paramètres d'élaboration sont les mêmes que pour le Format "Liste" GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 33
4. Générer l'application Menu Application Générer l'application Lorsque l'application est générée, elle peut être testée à l'adresse : http://localhost/wwwisis/[nom_appli]/form.htm Penser à sauvegarder régulièrement le paramétrage de l'application : Menu Application Sauvegarder 5. Création de "profils" Un "profil" permet l'accès à un lot d'informations pré-sélectionnées sans passer par une grille d'interrogation classique. Cette méthode peut servir à afficher de manière simple des informations stockées dans une base de données ISIS. Exemples d'applications : DSI Revue de presse Affichage des données selon un critère de date Sélection d'un thème spécial (dossier, ) Sélection de "sites web". Pour créer un "profil", suivre la procédure suivante : Créer un grille d'interrogation composée uniquement de "variables cachées" Dans le menu "Application", lancer le choix "Générer l'application" La fenêtre d'information suivante apparaît : GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 34
Associer un "titre" à la sélection La page d'accès à la sélection est générée dans : [Répertoire d'installation]\appli\[nom_appli]\form.htm Si vous modifier votre sélection ultérieurement (en changeant les valeurs associées à vos variables cachées), la liste des différents profils sera proposée pour pouvoir la modifier. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 35
Fiche technique : Web. Accès à une base CDS-ISIS (module GenIsisWeb) Décembre 2004 EXPORTER UNE APPLICATION La procédure d exportation permet de "préparer" les données à transférer sur la machine qui va héberger l'application. La procédure d'exportation ne doit pas être utilisée lorsque le poste de développement est la machine d'hébergement. Cette procédure doit être lancée lorsque l'application est paramétrée et testée. GENISIS permet de générer une ossature la "plus proche possible" de la version définitive de l'application. Les derniers ajustements (prise en compte de la charte graphique, intégration de logos, ) ne peuvent se faire qu en dernier lieu, hors GENISIS, avec un outil adapté (éditeur HTML). Une fois que cette ultime étape est abordée, il n est plus possible de retourner sous GENISIS pour modifier l application sans perdre tous les éléments de finition ajoutés. Un "logiciel serveur "httpd" (APACHE, IIS, ) doit s exécuter sur la machine destinée à héberger l'application. Le logiciel CDS-ISIS n est en revanche pas nécessaire sur la machine serveur. 1. Paramètres d'export Menu Application Exporter l'application GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 36
1.1. Le système d exploitation du serveur d hébergement Choisir le système d'exploitation du serveur d'hébergement : Windows (Windows 95, 98, NT, XP, 2000 ) UNIX (Linux, HP-UX, SUN OS, IBM AIX, SCO UNIX Voir sur le site http://www.bireme.br/wwwisis2.htm la liste des versions UNIX reconnues Si on utilise un système d exploitation UNIX, il faut passer par une étape de reformatage de la base CDS/ISIS pour la rendre compatible avec ce système. 1.2. L URL d accès aux modules CGI Cet élément désigne "l alias" déclaré au niveau du logiciel serveur web pour accéder aux programmes externes CGI. Pour connaître sa valeur, contacter l administrateur réseau du serveur d hébergement. Cas les plus fréquents : Pour Apache : Pour Internet Information Server : Pour Personal Web Server : /cgi-bin/ /scripts/cgi-bin/ /scripts/ 1.3. Le répertoire de stockage de l application Ce répertoire doit être choisi dans la partie "visible" du logiciel serveur HTTPD. Il faut donc créer un répertoire d accueil de l application dans la partie de l arborescence définie à partir du répertoire "racine" du logiciel serveur ("DocumentRoot"). Cette information doit être demandée à l administrateur du serveur d hébergement. Exemples : Par défaut dans Apache Windows : c:\program files\apache groupe\apache\htdocs\ Par défaut dans Internet Information Server : c:\inetpub\wwwroot\ Le chemin d accès à ce répertoire peut être défini : En absolu par rapport à la racine du volume disque En relatif par rapport au module CGI permettant l interrogation de la base (wwwi32.exe pour la version Windows, wwwisis pour les versions UNIX) 1.4. L URL d accès à l'application Désigne le chemin qui permet d accéder au répertoire de stockage de l'application à partir du répertoire "racine" du serveur web (DocumentRoot). Il peut être spécifique si un "Alias" a été déclaré au niveau du serveur web. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 37
1.5. Validation de la procédure d'export 1.5.1. Cas d'export sous Windows Une fois que la procédure d exportation est terminée, GenIsisWeb propose les instructions à suivre pour implanter l'application sur le serveur d hébergement : 1.5.2. Cas d'export sous Unix Pour un passage vers un système UNIX, la procédure d'export passe par une phase "automatique" de reformatage des bases de données CDS/ISIS pour les rendre compatibles avec le nouveau système d exploitation. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 38
1.5.3. Eléments à recopier sur le serveur d'hébergement Les éléments à recopier dans le répertoire de stockage de l'application sur le serveur d hébergement se trouvent dans le répertoire temporaire : c:\program Files\Genisis\Export\ form.htm help.htm JAVASCRIPT STYLE GRAPHIC BIREME DATA GIZMO INDEX CGI-BIN Page d accès à l'application : grille d'interrogation Page de guide associée à l'application (facultative) Répertoire contenant les "javascripts" du programme (fichiers *.js) Répertoire contenant les fichiers de "style" de votre application Répertoire contenant les images de l application Répertoire contenant les modules annexes de BIREME (mx, msrt, ifload, ) Répertoire contenant la base de données ISIS Répertoire contenant la base de codage des accents Répertoire contenant l image de l index si vous en avez déclaré un. Répertoire contenant les programmes à recopier dans le répertoire des "cgi-bin" du serveur web. Exemple d installation : serveur Apache sous Windows C:\ (Racine du disque) _Program Files _Apache Group _Apache _Cgi-bin WWWI32.EXE _Htdocs (Répertoire "racine" du serveur web) _BasesIsis _[Appli] FORM.HTM HELP.HTM _javascript _style _graphic _data _gizmo _index _bireme _cgi-bin _pft Elément souligné = Répertoire Elément en gras = Elément à conserver impérativement dans "Htdocs" ou éventuellement accessible via un "alias" Elément en gris = Elément pouvant être placé hors de l arborescence du "serveur web" Elément en italiques = Contient les fichiers à déplacer vers le répertoire des "cgi" du serveur (ici c:\program Files\Apache Group\Apache\Cgi-bin) Eléments en MAJUSCULES = Fichiers GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 39
Dans cette arborescence, les paramètres d exportation sont les suivants : 1) URL d accès au module CGI WWWI32.EXE : /cgi-bin/ Paramètre par défaut défini pour Apache 2) Répertoire d installation de l application : c:\program files\apache group\apache\htdocs\basesisis\[appli]\ en absolu par rapport à la racine du disque ou..\htdocs\basesisis\[appli]\ en relatif par rapport à WWWI32.EXE 3) URL d accès à l application : /BasesIsis/[Appli]/ En effet, l accès à l'application pour un utilisateur externe sera http://[serveur]/basesisis/[appli]/form.htm 1.5.4. Personnalisation de la configuration du serveur d'hébergement Dans certains cas, il est possible de décider de répartir différemment les données afin : D éviter la duplication d information si le serveur héberge plusieurs applications GenIsisWeb D organiser différemment l'arborescence en plaçant par exemple les bases de données hors de l espace "visible" du logiciel serveur web. Le paramétrage de l application se fait alors "manuellement" dans le "corps" du fichier FORM.HTM en jouant sur l affectation de plusieurs variables cachées (HIDDEN). Les modifications peuvent se faire avec un simple éditeur "texte" (le bloc-note par exemple) pour réaffecter les variables suivantes : (*) les éléments modifiables sont indiqués en bleu gras <input type="hidden" name="t2003" value="20"> Le nombre de références par page de résultat <input type="hidden" name="t2005" value="c:/program FILES/APACHE GROUP/APACHE/HTDOCS/BASESISIS/[Appli]/DATA/[Base]"> <input type="hidden" name="t2006" value="c:/program FILES/APACHE GROUP/APACHE/HTDOCS/BASESISIS/[Appli]/PFT/"> <input type="hidden" name="t2007" value="/basesisis/[appli]/form.htm"> <input type="hidden" name="t2008" value="40"> <input type="hidden" name="t2009" value="/cgibin/wwwi32.exe"> Le chemin d accès à la base de données CDS/ISIS Le chemin d accès au répertoire contenant les formats d affichage (*.pft) L url d accès au formulaire d interrogation (la page html en cours de modification). A modifier si cette page est déplacée ou si son nom est changé. Utilisé pour l affichage des index = Nombre de termes affichés par page. L url d accès au module CGI. A ne modifier que pour un paramétrage spécifique choisi par l administrateur du serveur. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 40
<input type="hidden" name="t2010" value="/basesisis/[appli]/javascript/"> Répertoire contenant les programmes javascript. Si ce répertoire est déplacé, il faut penser à : Le garder sous le répertoire "racine" du logiciel serveur web ou le rendre accessible via un "alias" Indiquer le nouveau chemin dans l entête du fichier FORM.HTM (bloc <HEAD> </HEAD>) <input type="hidden" name="t2011" value="/wwwisis/graphic/"> Bibliothèque des images (fichiers *.gif) <input type="hidden" name="t2012" value="/wwwisis/style/"> Répertoire contenant les fichiers de "style" externes (*.css). Contraintes identiques aux "javascrript" si ce répertoire est déplacé. <input type="hidden" name="t2013" value=""> <input type="hidden" name="t2014" value="c:/program FILES/APACHE GROUP/APACHE/HTDOCS/BASESISIS/[Appli]/gizmo/codage"> <input type="hidden" name="t2015" value="c:/program FILES/APACHE GROUP/APACHE/HTDOCS/BASESISIS/[Appli]/index/index "> Pendant la phase de mise au point de l'application, le fait d affecter à cette variable la valeur "d" (comme "debug"), permet d activer le mode "trace" et ainsi de visualiser le contenu des variables transmises au moteur CGI. Chemin d accès à la base de données CDS/ISIS de codage des accents. La même base peut être utilisée par les différentes applications GenIsisWeb. Chemin d accès à la base CDS/ISIS contenant l image du dictionnaire de la base. Cette base permet d accélérer l affichage des index au niveau de l interface navigateur. Cette variable n est utilisée que si cette méthode a été choisie au niveau de GenIsisWeb. La modification de ces variables permet de répartir les applications GenIsisWeb selon ses propres critères d organisation. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 41
Exemple de solution d installation Plusieurs applications GenIsisWeb sans redondance d information C:\ (Racine du disque) _Program Files _Apache Group _Apache _Cgi-bin WWWI32.EXE _Htdocs (Répertoire "racine" du serveur web) _BasesIsis _javascript _style _graphic _gizmo _bireme _[Appli 1] FORM.HTM HELP.HTM _data _index _pft _[Appli 2] FORM.HTM HELP.HTM _data _index _pft Elément souligné = Répertoire Eléments en MAJUSCULES = Fichiers Ici les éléments communs à toutes les applications GenIsisWeb ont été remontés à un niveau supérieur de l arborescence. Ces éléments sont : Les programmes "javascript" Les fichiers de "style" La bibliothèque des "images" La base de données de codage des accents Les modules spécifiques BIREME Les éléments spécifiques à chaque application sont : Les formats (fichiers *.pft) Les bases de données CDS/ISIS Les bases "image" du dictionnaire Dans certains cas, les éléments spécifiques peuvent aussi être communs à plusieurs applications : Accès à une même base avec un mode de recherche "simple" et un mode de recherche "avancé", Formulaire d interrogation en plusieurs langues, formats d affichage communs à plusieurs bases (voir chapitre : Améliorations de l interface) GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 42
Exemple de solution d installation Bases de données CDS/ISIS hors de l arborescence web C:\ (Racine du disque) _Program Files _Apache Group _Apache _Cgi-bin WWWI32.EXE BasesISIS _Htdocs (Répertoire "racine" du serveur web) _gizmo _bireme _AppliIsis _[Base 1] _data _javascript _index _style _pft _graphic [base 2] [Appli 1] _data FORM.HTM _index HELP.HTM _pft [Appli 2] FORM.HTM HELP.HTM Elément souligné = Répertoire En bleu = Fichiers 2. Mise à jour de la base de données Plusieurs cas sont possibles pour mettre à jour l'application web en fonction de l alimentation de la base de données (La base "en ligne" est une copie de la base courante). 2.1. Hébergement sur un serveur de type Windows Il suffit de recopier périodiquement la base à jour dans le répertoire adapté. L utilisation de GenIsisWeb est donc totalement inutile. Si on utilise en plus une "image de l index", il est possible de le mettre à jour directement en exécutant la commande LOAD_IND.BAT (située dans [Répertoire de l application]/index). Mise en garde : Il est nécessaire de faire une "petite" correction dans ce fichier si au moment de l export (voir au dessus), vous avez déclaré le chemin d installation de votre applicatif en "relatif" par rapport au module CGI de Birème. 2.2. Hébergement sur un serveur de type UNIX Pour le passage vers un système UNIX, relancer GenIsisWeb sur la machine de production et lancer l exportation en cochant l option "Recharger uniquement les fichiers de données". Suivre ensuite les instructions fournies par le programme. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 43
GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 44
ANNEXES GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 45
Annexe n 1 : Configuration de GenIsisWeb Program Files\GenIsisWeb -BIREME -EXPORT -GIZMO -TEMPLATES -WWWISIS ----------- -APPLI1.01 -APPLI1.02 -APPLI2.01 -GRAPHIC -JAVASCRIPT -STYLE BIREME Contient les exécutables BIREME (modules MX.EXE, MYS.EXE, IFLOAD.EXE et WWWI32.EXE). Lors de l'installation de GenIsisWeb, une copie du module WWWI32.EXE est faite dans le répertoire attribué aux modules CGI pour le serveur HTTPD. Exemple: Sous APACHE : répertoire C:\Program Files\Apache Group\Apache\Cgi-bin Sous IIS : répertoire C:\Inetpub\Scripts\Cgi-bin EXPORT Répertoire temporaire contenant les fichiers générés dans le cas d'un "export" d'une application vers un autre ordinateur. GIZMO Contient une base de données ISIS nommée CODAGE utilisée pour le codage des accents MS/DOS vers ANSI. La base CODAGE fonctionne comme une table avec deux champ ISIS : 1 (code MS/DOS) et 2 (code ANSI). On peut aussi remplacer le codage ANSI par les codes HTML des caractères accentués (Ex: "é" au lieu de "é") TEMPLATES Contient les différents "modèles" de génération du programme. Ces fichiers peuvent être éventuellement modifiés (avec précaution) pour adapter les modèles par défaut à utiliser pour chaque application. Exemple : Retouche du fichier FORM.HTM qui est utilisé pour la génération de la grille d'interrogation pour intégrer des éléments de présentation spécifiques à votre centre (Entête, Logo, Pied de page, ). GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 46
WWWISIS Ce répertoire est la partie "visible" de l'arborescence pour un utilisateur internet (on suppose qu'un serveur HTTPD s'exécute sur la machine de développement). La méthode d'accès à ce répertoire est définie au moment du paramétrage de la configuration de GenIsisWeb en utilisant l'une des deux techniques : - Utilisation d'un Alias (conseillé) - Copie du contenu du répertoire HTML dans le sousrépertoire WWWISIS du répertoire racine du serveur HTTPD. WWWISIS\APPLI[x] Le répertoire WWWISIS contient un sous-répertoire par application générée. Le nom du répertoire associé à une application est : [Nom de la base ISIS].[Numéro] Cette structure permet de déclarer plusieurs applications pour une même base de données. Exemple : Accès à une base de donnée au travers d'une grille d'interrogation simple et d'une grille d'interrogation avancée) Dans chaque répertoire se trouvent : les pages statiques HTML de l'application et notamment les pages : form.htm : page de lancement de l'application. help.htm : page de guide des répertoires de stockage des différents éléments : ini : fichiers.ini (paramètres de configuration) index : fichiers "images" des index pft : formats d'affichage. Format "Liste" : affiche0.pft : En-tête affiche1.pft : corps de l'affichage affiche2.pft : pied de page Format "Détaillé" : header.pft : En-tête détail.pft : corps de l'affichage select.pft : corps de l'affichage avec cases à cocher footer.pft : pied de page Affichage des Index : index0.pft : En-tête index1.pft : corps de l'affichage index2.pft : pied de page L'URL d'accès à chaque application est : Http://[Serveur]/wwwisis/[Nom_Appli]/form.htm ou Http://Localhost/wwwisis/[Nom_Appli ]/form.htm GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 47
Une URL générale permet d'accéder à la liste complète des applications GenIsisWeb : Http://[Serveur]/wwwisis/Appli.htm ou Http://Localhost/wwwisis/Appli.htm WWWISIS\GRAPHIC Contient dans différentes langues les images des différents boutons de l'application. Ces éléments peuvent être modifiés selon la convenance pour changer l'apparence de l'application. Nom des images : [libellé]_[code langue].gif WWWISIS\JAVASCRIPT Contient les modules JAVASCRIPT nécessaires au bon fonctionnement de GenIsisWeb. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 48
Annexe n 2 : Codage des caractères affichés Les caractères contenus dans la base de données sont affichés dans la fenêtre du navigateur après être passés au travers d'une table de décodage. Cette table est structurée dans la base de données CDS/ISIS CODAGE placée dans le répertoire : [Répertoire d'installation]\gizmo\. Cette base contient les deux champs suivants : - 1=Caractère d'origine - 2=Correspondance à afficher Vous pouvez compléter cette base de données : Attention, les seuls caractères indispensables dans cette base sont les correspondances HTML suivantes : - 1=' - 2=' et - 1=" - 2=" CAS PARTICULIER DES DELIMITEURS DE TERMES DE RECHERCHE < > Le codage des caractères < et > permet d'afficher les termes en conservant les séparateurs de recherche de Cds-Isis, et en évitant ainsi l'ambiguïté avec les balises HTML. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 49
Exemple : <Le> Monde diplomatique Utilisation du mode MHL : Cas des champs avec sous-champs : le mode MHL est automatiquement sélectionné. Autre cas : structure de champ (inadaptée) sous la forme : <MOT CLE1><MOT CLE2>... <MOT CLEn> au lieu d'une structuration appropriée en champ répétitif. Il est possible de sélectionner l'utilisation du mode MHL pour supprimer automatiquement à l'affichage les délimiteurs de termes de recherche < > Dans tous les cas, le mode MHL inhibe la possibilité de paramétrer un traitement complémentaire sur le champ (insertion de lien hypertexte, ). GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 50
Annexe n 3 : Récapitulatif des éléments indispensables pour créer/diffuser une base Cds-Isis avec GenIsisWeb Conception de l application (opération à effectuer une fois) Elément Commentaire Micro PC sous windows 95 minimum Le fait d utiliser Windows pour la conception ne préjuge en aucun cas du système d exploitation de la machine qui va héberger l applicatif Logiciel APACHE en local Permet de tester en grandeur «réelle» l application Logiciel GenIsisWeb Générateur d application Moteur de recherche WWWISIS Module développé par BIREME automatiquement installé par GenIsisWeb Vos bases de données CDS/ISIS Le logiciel WINISIS Non nécessaire dans l absolu Mais fortement conseillé pour modifier si nécessaire la FST de votre base. Hébergement de l application Elément Commentaire SYSTEME D EXPLOITATION WINDOWS Machine serveur sous windows En général version orientée «serveur» de windows : Windows NT server, Windows 2000 server Logiciel serveur HTTPD En général Internet Information Server. Apache Autre Moteur de recherche WWWISIS Les éléments générés par GenIsisWeb Vos bases de données CDS/ISIS Module développé par BIREME à copier dans le répertoire cgi-bin spécifique au logiciel serveur utilisé (module joint au moment du transfert de l application) Formats PFT, pages HTML, modules javascript, feuilles de style A copier simplement sur un espace disque dur de l hébergeur (compte FTP) SYSTEME D EXPLOITATION LINUX Machine serveur sous linux Logiciel serveur HTTPD En général APACHE Autre Moteur de recherche WWWISIS Les éléments générés par GenIsisWeb Modules complémentaires de BIREME pour régénérer une base compatible avec l environnement LINUX Un export au format ISO2709 de vos bases de données Version LINUX du module développé par BIREME à copier dans le répertoire cgi-bin spécifique au logiciel serveur utilisé. Formats PFT, pages HTML, modules javascript, feuilles de style Modules installés au moment du transfert de l application Le format ISO2709 est directement généré au moment du transfert de l application. Les bases CDS/ISIS n étant pas directement compatibles avec l environnement LINUX. Il faut donc passer par une étape d import des données pour obtenir une base opérationnelle dans ce système d exploitation. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 51
L hébergeur doit vous «ouvrir» : un compte FTP pour transférer vos données compte TELNET (ou SSH = TELNET sécurisé) pour pouvoir lancer la commande d import des données au format ISO2709 dans l environnement LINUX. Si l ouverture d un compte SSH pose problème au niveau de l hébergeur (cas fréquent), il sera nécessaire de générer une base compatible sur une machine LINUX de votre centre avant de l envoyer sur l espace d hébergement via FTP. Le cas, plus rare, d un hébergement sur une machine utilisant un système d exploitation UNIX propriétaire (HP-UX, AIX, SOLARIS, ) s apparente à celui sous LINUX. GenIsisWeb : Déc. 2004 (pichabert@wanadoo.fr)- p. 52