Chapitre 7
Stockage, test et suivi d'un site
Ce chapitre propose des instructions pour stocker et tester un site en publication Web personnalisée avant son déploiement dans un environnement de production. Vous y trouverez également des instructions relatives à l'utilisation des fichiers journaux permettant d'assurer le suivi du site en phase de test ou après le déploiement.
Stockage d'un site de publication Web personnalisée
Avant de pouvoir tester correctement votre site, vous devez copier ou déplacer les fichiers nécessaires à leur emplacement correct sur le(s) serveur(s) de stockage.
Pour stocker votre site et le préparer pour les tests :
1. Suivez toutes les étapes exposées dans chapitre 3, « Préparation des bases de données pour la publication
Web personnalisée ».
2. Assurez-vous que XSLT et XML ont été activés et correctement paramétrés dans FileMaker Server
Admin Console.
Remarque
Vous trouverez des instructions complémentaires dans l’Aide de FileMaker Server.
3. Vérifiez le bon fonctionnement du serveur Web et du moteur de publication Web.
4. Copiez ou déplacez les feuilles de style XSLT sur la machine où se trouve le moteur de publication Web.
Copiez ou déplacez les feuilles de style XSLT dans le répertoire suivant de la machine où se trouve le moteur de publication Web :
1
Apache (Mac OS) : /Library/FileMaker Server 9/Web Publishing/xslt-template-files
1
IIS (Windows) : <lecteur>:\Program Files\FileMaker\FileMaker Server 9\Web Publishing\xslt-template-files où
<lecteur>
correspond au lecteur principal servant au démarrage de votre système.
Remarque
Vous pouvez également placer les feuilles de style dans un dossier provisoire ou dans le sous-dossier xslt-template-files.
5. Copiez ou déplacez les éventuels objets multimédias référencés sur la machine contenant le serveur Web.
Si une rubrique de base de données Multimédia stocke une référence à un fichier et non le fichier lui-même, l'objet multimédia référencé doit alors être stocké dans le dossier FileMaker Pro Web lorsque l'enregistrement est créé ou modifié. Pour stocker votre site, vous devez copier ou déplacer les objets multimédias référencés dans un dossier possédant le même emplacement relatif dans le dossier racine du logiciel de serveur Web.
Remarque
Si le fichier de base de données est correctement hébergé accessible sur FileMaker Server et si les rubriques Multimédia stockent les fichiers proprement dits dans la base de données FileMaker, toute action sur le contenu de la rubrique Multimédia est alors inutile.
90 Publication Web personnalisée de FileMaker Server avec XML et XSLT
6. Utilisez la syntaxe URL suivante pour effectuer une requête ou traiter une feuille de style XSLT et générer la page HTML associée :
<scheme>://<host>[:<port>]/fmi/xsl/<path>/<stylesheet>.xsl[?<query string>]
où :
1
<scheme> correspond au protocole HTTP ou HTTPS.
1
<host> correspond à l'adresse IP ou au nom de domaine de l'ordinateur hôte sur lequel le serveur Web est installé.
1
<port> est facultatif et spécifie le port d'écoute du serveur Web. Si aucun port n'est spécifié, le port par défaut du protocole est utilisé (port 80 pour HTTP ou port 443 pour HTTPS).
1
<path> est facultatif et spécifie le ou les dossiers présents dans le répertoire xslt-template-files dans lequel se situe la feuille de style XSLT.
1
<stylesheet> correspond au nom de la feuille de style avec l'extension .xsl.
1
<query string> peut correspondre à la combinaison d'une commande de requête et d'un ou de plusieurs paramètres de requête pour la publication Web personnalisée avec XSLT.
Si la feuille de style spécifiée intègre une instruction de traitement <?xslt-cwp-query ?>, la commande de requête statique et les paramètres prennent le pas sur les commandes de requête ou les paramètres correspondants dans la chaîne de requête URL. Si vous référencez une feuille de style home.xsl par le biais de XSLT Site Assistant, vous n'avez pas besoin d'intégrer une chaîne de requête. Consultez la
section annexe A, « Noms corrects utilisés dans les chaînes de requête » pour plus d’informations sur les
chaînes de requête.
La syntaxe URL est sensible à la casse, notamment les noms des commandes de requête et les paramètres,
à l'exception des parties de la chaîne de requête. Les adresses URL sont, en majorité, en minuscules. Par exemple, si vous avez copié vos feuilles de style (y compris une feuille de style home.xsl) dans le sous-dossier my_templates du dossier xslt-template-files, vous pouvez utiliser l'adresse URL suivante pour effectuer une requête de traitement des feuilles de style : http://192.168.123.101/fmi/xsl/my_templates/home.xsl
Remarque
Le moteur de publication Web ne permet pas aux utilisateurs Web d'afficher la source des feuilles de style XSLT installées dans le dossier xslt-template-files. Lorsqu'un utilisateur Web envoie une requête pour traiter une feuille de style, le moteur de publication Web envoie uniquement au navigateur
Web les pages HTML résultant des feuilles de style de XSLT Site Assistant.
Test d'un site de publication Web personnalisée
Avant d'informer les utilisateurs de la disponibilité de votre site de publication Web personnalisée, vérifiez s'il se présente et fonctionne comme prévu.
1
Testez les fonctions telles que la recherche, l'ajout, la suppression et le tri d'enregistrements avec différents jeux de comptes et d'autorisations d'accès.
1
Vérifiez si les ensembles d'autorisation fonctionnent comme prévu en vous connectant à différents comptes.
Assurez-vous que des utilisateurs non autorisés ne peuvent pas accéder à vos données ou les modifier.
1
Contrôlez tous les scripts pour vérifier que leur effet est conforme aux attentes. Consultez la rubrique
« Scripts FileMaker et publication Web personnalisée », page 25 pour obtenir des informations sur
la conception de scripts adaptés au Web.
Chapitre 7
|
Stockage, test et suivi d'un site 91
1
Testez votre site avec différents systèmes d'exploitation et navigateurs Web.
Remarque
Si vous ne possédez pas de connexion réseau et si vous avez installé FileMaker Server 9 en choisissant un déploiement sur une seule machine — le serveur Web, le moteur de publication Web et le Serveur de base de données se trouvant sur un même ordinateur — vous pouvez tester votre site de publication Web personnalisée en utilisant http://localhost/ ou http://127.0.0.1/ dans l'URL. Pour plus d'informations
sur la syntaxe d'URL, consultez les rubriques « A propos de la syntaxe d'URL pour les données XML et les objets
de type Multimédia », page 33, et « A propos de la syntaxe d'URL des feuilles de style FileMaker XSLT », page 59.
Exemples de feuilles de style permettant de tester les sorties XML
Voici deux exemples de feuilles de style XSLT utiles pour tester le résultat XML.
1
L'exemple de feuille de style suivant renvoie les données XML requises sans aucune transformation.
Cette feuille de style est utile pour afficher les données XML réelles utilisées par le moteur de publication
Web.
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fmrs="http://www.filemaker.com/xml/fmresultset">
<xsl:output method="xml"/>
<xsl:template match="/">
<xsl:copy-of select="."/>
</xsl:template>
</xsl:stylesheet>
1
Pour le débogage d'une feuille de style, vous pouvez utiliser l'exemple suivant d'une balise HTML
<textarea> pour afficher le document source XML accessible via la feuille de style, dans une zone de texte défilante. Sur la même page, vous pouvez comparer les résultats XSLT transformés aux documents XML source, avant la transformation.
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fmrs="http://www.filemaker.com/xml/fmresultset">
<xsl:output method="html"/>
<html>
<body>
<xsl:template match="/fmrs:fmresultset">
<textarea rows="20" cols="100">
<xsl:copy-of select="."/>
</textarea><br/>
</xsl:template>
</body>
</html>
</xsl:stylesheet>
92 Publication Web personnalisée de FileMaker Server avec XML et XSLT
Suivi de votre site
Vous pouvez utiliser les types de fichiers de consignation suivants pour surveiller votre site de publication Web personnalisée et réunir des informations au sujet des utilisateurs Web qui visitent votre site :
1
Journaux d'erreurs et d'accès au serveur Web
1
Journal d'application du moteur de publication Web
1
Journal d'erreurs du module de serveur Web
1
Journaux d'accès internes du noyau de publication Web
Utilisation des journaux d'erreurs et d'accès au serveur Web
Apache (Mac OS) : le serveur Web Apache génère un fichier journal des accès et un fichier journal des erreurs.
Le fichier journal des accès Apache, qui répond par défaut au format standard de fichier journal du W3C, consigne toutes les requêtes HTTP reçues par le serveur Web. Le journal des erreurs Apache consigne les problèmes survenus dans le cadre du traitement des requêtes HTTP. Pour plus d'informations sur ces fichiers journaux, consultez la documentation du serveur Web Apache.
IIS (Windows) : le serveur Web Microsoft IIS génère un fichier journal des accès, mais affiche les erreurs dans l'Observateur d'événements de Windows au lieu de les consigner dans un fichier journal. Le fichier journal des accès, qui répond par défaut au format étendu de fichier journal du W3C, consigne toutes les requêtes HTTP reçues par le serveur Web. Vous pouvez aussi utiliser le format standard de fichier journal du W3C pour le journal des accès. Pour plus d'informations, consultez la documentation du serveur Web Microsoft IIS.
Pour obtenir des informations sur les formats standard et étendu de fichier journal du W3C, consultez le site Web du World Wide Web Consortium, à l'adresse www.w3.org.
Utilisation du journal d'application du moteur de publication Web
Par défaut, le moteur de publication Web génère un fichier journal d'application, consignant des informations sur les erreurs, les scripts et les connexions d'utilisateurs du moteur de publication Web.
1
Les informations du journal des erreurs décrivent toute erreur inhabituelle survenue dans le moteur de publication
Web. Les erreurs habituelles signalées à l'utilisateur Web, telles que « Base de données fermée », ne sont pas consignées.
1
Les informations du journal des scripts décrivent toute erreur générée quand des utilisateurs Web exécutent des scripts. Les étapes de scripts ignorées en raison de leur incompatibilité avec le Web y sont par exemple recensées.
1
Le journal de connexion des utilisateurs contient des messages générés par l'élément XSLT <xsl:message> dans les feuilles de style XSLT. Dès qu'un utilisateur Web accède à votre feuille de style XSLT, les informations que vous avez incluses dans un élément <xsl:message> sont consignées dans le fichier journal d'application.
Consultez la rubrique chapitre 6, « Conception de feuilles de style FileMaker XSLT ».
Le journal d'application se nomme pe_application_log.txt et se situe dans le sous-dossier Logs du dossier FileMaker
Server sur l'hôte du moteur de publication Web.
Chapitre 7
|
Stockage, test et suivi d'un site 93
Le fichier pe_application_log.txt est généré si l'une des options de consignation suivantes est activée dans le moteur de publication Web :
Option de consignation activée
Journalisation des erreurs
Informations enregistrées dans pe_application_log.txt
Toute erreur inhabituelle survenue dans le moteur de publication Web.
Les erreurs habituelles signalées à l'utilisateur Web, telles que « Base de données fermée », ne sont pas consignées.
Journalisation des scripts
Toute erreur générée quand des utilisateurs Web exécutent des scripts.
Les étapes de scripts ignorées en raison de leur incompatibilité avec le Web y sont par exemple recensées.
Journalisation des utilisateurs
Messages générés lorsque les utilisateurs Web accèdent à votre solution de publication
Web personnalisée.
Ces options de journalisation, sont toutes trois activées par défaut. Pour plus d’informations sur le paramétrage de ces options via FileMaker Server Admin Console, consultez l’Aide de FileMaker Server.
Remarque
Les entrées du journal d'application ne sont pas supprimées automatiquement et le fichier peut devenir très volumineux avec le temps. Pour économiser de l'espace sur le disque dur de l'ordinateur hôte, archivez régulièrement le fichier journal d'application.
Utilisation du journal des erreurs du module de serveur Web
Si le serveur Web n'est pas en mesure de se connecter au moteur de publication Web, le module de serveur
Web génère un fichier journal consignant toutes les erreurs liées à son utilisation. Ce fichier se nomme web_server_module_log.txt et se situe dans le sous-dossier Logs du dossier FileMaker Server, sur l'hôte du serveur Web.
Utilisation des journaux d'accès internes du noyau de publication Web
Le composant logiciel noyau de publication Web du moteur de publication Web génère deux fichiers journaux d'accès internes consignant tous les accès du noyau de publication Web.
1
Le journal d'accès wpc_access_log.txt recense toutes les requêtes d'utilisateurs finaux visant à générer des données XML et à utiliser la fonction de publication Web instantanée de FileMaker Server. Ces requêtes sont directement orientées vers le noyau de publication Web par le serveur Web.
1
Le journal d'accès pe_internal_access_log.txt recense toutes les requêtes XML internes que le composant logiciel XSLT-CWP du moteur de publication Web effectue durant le traitement des requêtes XSLT.
Ces requêtes sont redirigées en interne au sein du moteur de publication Web, depuis le composant logiciel XSLT-CWP vers le noyau de publication Web.
Ces fichiers journaux se trouvent dans le dossier Logs du dossier FileMaker Server de l’hôte moteur de publication Web.
Les journaux d'accès interne sont générés si l'option de Journalisation des accès est activée dans le moteur de publication Web. Le paramètre par défaut est activé. Pour plus d’informations sur le paramétrage de l’option Journalisation des accès de FileMaker Server Admin Console, consultez l’Aide de
FileMaker Server.
94 Publication Web personnalisée de FileMaker Server avec XML et XSLT
