Chapitre 6
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, copiez ou déplacez les fichiers nécessaires vers 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 du chapitre 3, « Préparation des bases de données pour la Publication
Web personnalisée ».
2. Assurez-vous que la publication Web personnalisée avec PHP a été activée et correctement paramétrée dans l’Admin Console de FileMaker Server.
Remarque
Vous trouverez des instructions 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 fichiers de votre site vers le composant serveur Web de votre déploiement FileMaker Server.
Copiez ou déplacez les fichiers de votre site vers le répertoire suivant sur la machine du serveur
Web :
1
IIS (Windows) : <disque>:\Inetpub\wwwroot où <disque> est le disque sur lequel réside le composant Moteur de publication Web de votre déploiement de serveur FileMaker.
1
Apache (Mac OS) : /Bibliothèque/WebServer/Documents
Chapitre 6 | Stockage, test et suivi d’un site 50
5. Si ce n’est pas déjà fait, copiez ou déplacez tout objet Conteneur référencé vers l’emplacement correct sur la machine du serveur Web.
1
Si le fichier de base de données est correctement hébergé et accessible sur le composant
Database Server du déploiement de FileMaker Server et si les rubriques Conteneur stockent les fichiers proprement dits dans la base de données FileMaker, toute action sur le contenu de la rubrique Conteneur est alors inutile.
1
Si une rubrique de base de données de conteneur stocke une référence à un fichier et non le fichier lui-même, l’objet Conteneur 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 Conteneur référencés dans un dossier possédant le même emplacement relatif dans le dossier racine du logiciel de serveur Web.
1
Si une rubrique Conteneur de base de données stocke l’objet Conteneur en externe, utilisez l’assistant Téléchargement de base de données pour transférer le fichier de base de données et les objets de la rubrique Conteneur depuis le système de fichiers de votre ordinateur vers FileMaker Server. Si vous téléchargez manuellement une base de données utilisant un conteneur avec des objets stockés en externe, vous devez copier ou déplacer les objets référencés dans un sous-dossier du dossier RC_Data_FMS, comme décrit dans
la section « Rubriques Conteneur avec données stockées en externe », page 19.
Consultez la section « Publication du contenu des rubriques Conteneur sur le Web », page 18.
6. Commencez à tester votre site.
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 qu’il s’affiche 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 de privilèges.
1
Vérifiez si les jeux de privilèges 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
section « Scripts FileMaker et Publication Web personnalisée », page 21 pour obtenir des
informations sur la conception de scripts adaptés au Web.
Chapitre 6 | Stockage, test et suivi d’un site 51
1
Testez votre site avec différents systèmes d’exploitation et navigateurs Web.
1
Lors de la création de solutions utilisant l’API FileMaker pour PHP, nous recommandons la conception de solutions prenant en charge les cookies. L’API FileMaker pour PHP offre des délais de réponse plus courts lorsque les cookies sont activés. Les cookies ne sont pas nécessaires à l’utilisation des fonctions Publication Web personnalisée, mais permettent la mise en cache des informations de session par le moteur de publication Web.
Remarque
Si vous avez installé le serveur Web, le moteur de publication Web et le serveur de bases de données dans un déploiement sur une seule machine, vous pouvez afficher et tester votre site sans utiliser la connexion réseau. Déplacez les fichiers de votre site vers le répertoire approprié sur cette machine, puis saisissez l’URL suivante dans votre navigateur : http://127.0.0.1/<chemin_site>
Où <chemin_site> est le chemin relatif vers la page d’accueil de votre site.
Suivi de votre site
Utilisez 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 du moteur de publication Web
1
Journal d’erreurs du module de serveur Web
1
Journaux Tomcat
Utilisation des journaux d’erreurs et d’accès au serveur Web
1
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.
1
Apache (Mac OS uniquement) : 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.
Remarque
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 http://www.w3.org.
Chapitre 6 | Stockage, test et suivi d’un site 52
Utilisation du journal du moteur de publication Web
Par défaut, le moteur de publication Web génère un fichier journal nommé wpe.log qui contient un enregistrement des erreurs de moteur de publication Web qui se sont produites, notamment les erreurs d’application, d’utilisation et système. Vous pouvez également inclure dans le moteur de publication Web des informations relatives à la publication Web personnalisée, par exemple, les requêtes XML de l’utilisateur final afin de générer des résultats de publication ou des modifications des paramètres de Publication Web personnalisée.
Etant donné que l’API FileMaker pour PHP utilise HTTP POST pour accéder au moteur de publication Web, le fichier wpe.log n’enregistre pas les détails sur les requêtes PHP. Vous pouvez utiliser le fichier wpe.log pour consulter le moment où les requêtes PHP sont émises par les utilisateurs en recherchant les requêtes XML enregistrées.
Le fichier wpe.log se trouve sur le composant Moteur de publication Web du déploiement
FileMaker Server :
1
IIS (Windows) :
<disque>:\Program Files\FileMaker\FileMaker Server\Logs\wpe.log où <disque> correspond au disque principal servant au démarrage de votre système.
1
Apache (Mac OS) : /Bibliothèque/FileMaker Server/Logs/wpe.log
Paramètres du journal du moteur de publication Web
Le fichier wpe.log est généré si l’option
Activer la journalisation pour la publication Web personnalisée
est activée dans l’Admin Console.
Option de journalisation activée
Messages de niveau d’erreur
Messages et informations sur le niveau d’erreur
Information enregistrée dans wpe.log
Toutes les erreurs de moteur de publication Web qui se sont produites, notamment les erreurs d’application, les erreurs d’utilisation et les erreurs système.
Toutes les erreurs décrites ci-dessus et les informations sur l’accès au moteur de publication Web. Il contient un enregistrement de toutes les requêtes XML de l’utilisateur final pour générer la sortie de publication Web personnalisée.
La configuration des
messages de niveau d’erreur
est activée par défaut. Pour plus d’informations sur le paramétrage de ces options via l’Admin Console, consultez l’aide de
FileMaker Server.
Remarque
Pour la publication Web personnalisée avec FileMaker Server 12, le fichier wpe.log remplace les fichiers wpc_access_log.txt et pe_application_log.txt utilisés dans les versions précédentes.
Important
Au fil du temps, le fichier wpe.log peut devenir très important. Utilisez l’Admin Console pour définir la taille maximale du fichier wpe.log. Lorsque le fichier wpe.log atteint la taille maximale, le moteur de publication Web copie le fichier wpe.log dans un seul fichier de sauvegarde, wpe.log.1 et crée un nouveau fichier wpe.log. Si vous souhaitez conserver plusieurs copies de sauvegarde, vous pouvez enregistrer régulièrement une archive du fichier wpe.log.1.
Format du journal du moteur de publication Web
Le fichier wpe.log utilise le format suivant pour chaque entrée :
[TIMESTAMP_GMT] [WPC_HOSTNAME] [CLIENT_IP:PORT] [ACCOUNT_NAME] [MODULE_TYPE]
[SEVERITY] [FM_ERRORCODE] [RETURN_BYTES] [MESSAGE]
Chapitre 6 | Stockage, test et suivi d’un site 53 où :
1
[TIMESTAMP_GMT] correspond aux date et heure de la saisie, à l’heure de Greenwich (GMT).
1
[WPC_HOSTNAME] est le nom de la machine sur laquelle le moteur de publication Web est installé.
1
[CLIENT_IP:PORT] est l’adresse IP et le port client d’origine de la requête XML.
1
[ACCOUNT_NAME] est le nom de compte utilisé pour se connecter à la base de données
FileMaker hébergée.
1
[MODULE_TYPE] est soit : XML, pour la publication Web personnalisée, ou PHP, pour la publication Web personnalisée avec requête PHP.
1
[SEVERITY] est soit INFO, désignant un message d’information ou ERREUR, désignant un message d’erreur.
1
[FM_ERROR_CODE] est le numéro d’erreur renvoyé pour un message d’erreur. Le numéro
d’erreur peut être un code erreur des bases de données FileMaker (voir « Numéros des codes d’erreur des bases de données FileMaker », page 55).
En outre, le numéro d’erreur peut être un numéro HTTP, précédé de la chaîne « HTTP: ».
1
[RETURN_BYTES] est le nombre d’octets renvoyés par la requête.
1
[MESSAGE] fournit des informations complémentaires sur l’entrée du journal.
Exemples de message de journal de moteur de publication Web
Les exemples suivants affichent les types de messages pouvant être inclus dans le fichier wpe.log :
1
Lorsque le moteur de publication Web démarre et s’arrête
2012-06-02 15:15:31 -0700 - - - - INFO - - Le moteur de publication Web de FileMaker Server a commencé.
2012-06-02 15:46:52 -0700 - - - - INFO - - Le moteur de publication Web de FileMaker Server s’est arrêté.
1
Requêtes XML réussies ou ayant échoué
2012-06-02 15:21:08 -0700 WPC_SERVER 192.168.100.101:0 jdoe XML
INFO 0 3964 "/fmi/xml/fmresultset.xml?-db=Contacts&lay=Contact_Details&-findall"
2012-06-02 15:26:31 -0700 WPC_SERVER 192.168.100.101:0 jdoe XML
ERROR 5 596 "/fmi/xml/fmresultset.xml?-db=Contacts&layout=Contact_Details&-findall"
1
Erreurs de création de script
2012-06-02 17:33:12 -0700 WPC_SERVER 192.168.100.101:0 jdoe - ERROR
4 - Erreur de création de script : 4, File: "10b_MeetingsUpload", Script:
"OnOpen", Script Step: "Show Custom Dialog"
1
Modification des paramètres de publication Web personnalisée
2012-06-09 10:59:49 -0700 WPC_SERVER 192.168.100.101:0 jdoe - INFO
- - Le moteur de publication Web XML est activé.
1
Erreurs système
2012-06-02 15:30:42 -0700 WPC_SERVER 192.168.100.101:0 jdoe XML
ERROR - - La communication a échoué
Chapitre 6 | Stockage, test et suivi d’un site 54
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 journal est nommé web_server_module_log.txt et se trouve sur le composant Moteur de publication Web du déploiement FileMaker Server :
1
IIS (Windows) : <disque>:\Program Files\FileMaker\FileMaker
Server\Logs\web_server_module_log.txt où <disque> correspond au disque principal servant au démarrage de votre système.
1
Apache (Mac OS) : /Bibliothèque/FileMaker
Server/Logs/web_server_module_log.txt
Utilisation des journaux Tomcat
Lorsque FileMaker Server a un problème causé par une erreur de serveur Web interne, il peut être utile d’afficher les journaux Tomcat. Les journaux Tomcat sont affectés sur le composant de serveur Web du déploiement de FileMaker Server :
1
IIS (Windows) : <disque>:\Program Files\FileMaker\FileMaker
Server\Admin\admin-master-tomcat\logs/ où <disque> correspond au disque principal servant au démarrage de votre système.
1
Apache (Mac OS) : /Bibliothèque/FileMaker Server/Admin/admin-mastertomcat/logs/
Résolution des problèmes sur votre site
Si vous rencontrez des problèmes pour l’affichage ou l’utilisation de votre site, vérifiez les points suivants :
1
Les privilèges d’accès étendus dans la base de données sont configurés pour la publication
Web personnalisée avec PHP et attribuées à un compte utilisateur. Consultez la section
« Activation de la publication Web personnalisée avec PHP pour les bases de données », page 15.
1
La base de données est hébergée et ouverte par FileMaker Server. Consultez l’Aide de
FileMaker Server.
1
Le nom de compte et le mot de passe que vous utilisez éventuellement pour la base de données sont corrects.
1
Le serveur Web et le moteur de publication Web sont opérationnels.
1
La publication PHP est activée dans le moteur de publication Web.
1
Ouvrez la page Tests technologiques FileMaker Server dans un navigateur : http://<serveur>:16000/test où <serveur> est la machine sur laquelle se trouve FileMaker Server.
1
Cliquez sur le lien
Tester la publication Web personnalisée PHP
pour ouvrir une page
PHP accédant à la base de données de test FMServer_Sample.
Pour plus d’informations, consultez le Guide de démarrage de FileMaker Server et l’Aide de
FileMaker Server.
