Chapitre 5 Introduction à la publication Web personnalisée avec XSLT. Filemaker FileMaker Server 9
Chapitre 5
Introduction à la publication Web personnalisée avec XSLT
Vous pouvez utiliser des feuilles de style FileMaker XSLT pour convertir, filtrer ou formater des données XML destinées à être manipulées dans un navigateur Web ou dans d'autres programmes et applications. Ce chapitre présente les feuilles de style FileMaker XSLT, ainsi qu'un outil qui vous aidera à débuter dans la création de feuilles de style XSLT — FileMaker XSLT Site Assistant. Pour plus d'informations concernant la structure des
A propos de feuilles de style XSLT FileMaker
Les feuilles de style FileMaker XSLT vous permettent d'effectuer :
1
le filtrage des données FileMaker contrôlant les rubriques de base de données publiées par la feuille de style ;
1
le masquage des métadonnées, telles que les noms de base de données et de rubrique ;
1
le formatage des données présentées dans une page Web et le contrôle de l'interaction entre l'utilisateur
Web et les données ;
1
la sortie des données au format HTML ou texte, tel que vCards ou valeurs séparées par des virgules (CSV) ;
1
la conversion des données utilisant la grammaire FileMaker XML en une autre grammaire XML destinée
à une autre base de données ou application, telle que le format polices vectorielles modulaires (SVG) ;
1
l'intégration d'un sous-ensemble quelconque de données FileMaker à d'autres sites Web et à d'autres applications middleware et personnalisées potentiellement très différentes de la base de données FileMaker ;
1
la modification des noms de rubrique publiés pour empêcher l'utilisation non autorisée des informations concernant la structure des bases de données.
Remarque
La publication Web personnalisée avec XSLT pour FileMaker Server repose sur la recommandation
W3C pour XSLT 1.0. Pour plus d'informations concernant XSLT 1.0, consultez le site www.w3.org.
Les fonctions d'extension FileMaker XSLT offrent des fonctionnalités supplémentaires telles que la gestion de sessions, l'envoi de courriers électroniques et l'accès aux cookies et aux en-têtes. Pour plus d'informations,
Le moteur de publication Web ne prend pas en charge les XSL Formatting Objects (XSL-FO).
50 Publication Web personnalisée de FileMaker Server avec XML et XSLT
Exemples d'utilisation des feuilles de style XSLT
Voici quelques-unes des nombreuses possibilités d'utilisation de feuilles de style FileMaker XSLT :
1
Dans une page Web, vous pouvez insérer une table contenant un sous-ensemble des données d'une base de données FileMaker à l'intention des utilisateurs Web. Cette table peut, par exemple, contenir le nom et l'adresse de personnes, mais non leur numéro de téléphone. Pour éviter les accès non autorisés, la page
Web peut présenter des étiquettes génériques pour les données (telles que Name) au lieu des véritables noms de rubrique dans la base de données FileMaker, tels que first_name.
1
Vous pouvez créer une application ou une page Web intégrant les données d'un portail FileMaker
à des informations issues d'autres sources de données.
1
Vous pouvez ajouter sur une page Web un bouton créant une vCard à partir des coordonnées d'une personne dans une base de données FileMaker.
1
Vous pouvez convertir les données XML d'une base de données FileMaker en une grammaire XML reconnue par un tableur ou par une application de base de données.
Utilisation de la publication Web personnalisée avec XSLT
Si vous connaissez les langages XML et XSLT standard, vous pouvez commencer à utiliser le moteur de publication Web immédiatement après avoir pris connaissance des détails spécifiques à la publication XML et XSLT avec FileMaker, concernant notamment l'utilisation des fonctions d'extension et des commandes et paramètres de requête XSLT de FileMaker. XSLT Site Assistant est un outil qui vous aide à créer des feuilles de style et vous enseigne la manière dont elles sont construites. Vous pouvez ensuite utiliser vos outils de composition XML et XSLT favoris pour améliorer l'aspect de vos feuilles de style.
Mode de génération des pages par le moteur de publication Web en fonction des données XML et des feuilles de style XSLT
Après l'envoi d'une requête de publication Web personnalisée XSLT (XSLT-CWP) au serveur Web, le moteur de publication Web interroge la base de données FileMaker en fonction des commandes et des paramètres de requête définis dans la feuille de style et dans l'URL, puis sort les données conformément aux instructions de la feuille de style XSLT.
Chapitre 5
|
Introduction à la publication Web personnalisée avec XSLT 51
Navigateur
Web
1. Une requête
XSLT-CWP est envoyée au serveur
Web par un programme ou un navigateur
Web.
Serveur Web
Module de serveur Web
3. Le CWPE soumet une requête de données XML au noyau de publication Web en fonction des paramètres et des commandes de requête.
Moteur de publication
Web FileMaker Server
Noyau de publication Web
2. Le serveur Web achemine la requête XSLT-CWP vers le CWPE.
La requête XSLT-CWP est acheminée depuis le programme ou le navigateur Web vers le serveur de base de données FileMaker.
Moteur de publication Web personnalisée (CWPE)
Base de données
FileMaker
Serveur
4. Le noyau de publication Web soumet la requête à la base de données hébergée par le
Serveur de base de données FileMaker.
Produits.fp7
Clients.fp7
Commandes.fp7
Catalogue.fp7
Navigateur
Web
8. Le serveur
Web envoie la sortie au programme ou au navigateur
Web.
Les données sont réacheminées depuis le Serveur de base de données et le moteur de publication
Web utilise une feuille de style XSLT pour convertir et formater les données
5. Le serveur de base de données FileMaker envoie les données demandées au noyau de publication Web.
Serveur Web
Module de serveur Web
6. Le noyau de publication Web convertit les données au format XML et les envoie au CWPE.
Moteur de publication
Web FileMaker Server
Noyau de publication Web
Moteur de publication
Web personnalisée
(CWPE)
7. Le CWPE utilise la feuille de style XSLT pour formater ou convertir les données XML, puis envoie les résultats au serveur Web sous forme de pages HTML, de documents XML ou de fichiers texte.
52 Publication Web personnalisée de FileMaker Server avec XML et XSLT
Etapes générales pour l'utilisation de la publication Web personnalisée avec XSLT
La présente section récapitule la procédure d'utilisation de la publication Web personnalisée avec XSLT :
1. Vérifiez si la publication XSLT est activée dans FileMaker Server Admin Console. Consultez l'Aide de
FileMaker Server.
2. A l'Aide de FileMaker Pro, ouvrez chaque base de données FileMaker que vous publiez et assurez-vous que l'autorisation d'accès étendue fmxslt des bases de données est activée pour la publication Web
Remarque
Lors de la création de feuilles de style destinées à un utilisateur final, prenez soin d'utiliser des ensembles d'autorisations d'accès équivalents dans la base de données FileMaker. Dans le cas contraire, vous pouvez avoir accès à des modèles et des fonctions de la base de données FileMaker qui ne seront pas accessibles à l'utilisateur final, ce qui risque d'entraîner des problèmes de fonctionnement.
3. Créez des feuilles de style XSLT comportant des fonctions d'extension, des commandes de requête et des paramètres de requête XSLT propres à FileMaker pour formater ou convertir les données XML d'une base de données FileMaker.
Vous pouvez utiliser l'outil FileMaker XSLT Site Assistant pour créer une ou plusieurs feuilles de style
XSLT de base comme point de départ pour votre site. Consultez la rubrique “Utilisation de l'outil
FileMaker XSLT Site Assistant pour générer des feuilles de style FileMaker XSLT.”
Vous avez également la possibilité d'utiliser vos propres outils de composition XSLT ou éditeurs de texte pour modifier les feuilles de style XSLT à votre convenance ou pour en créer de nouvelles. Consultez la rubrique
chapitre 6, « Conception de feuilles de style FileMaker XSLT ».
4. Copiez ou placez les feuilles de style XSLT dans le sous-dossier xslt-template-files, situé dans le dossier
Publication Web de FileMaker Server, sur l'ordinateur hôte sur lequel le moteur de publication Web est installé.
Vous pouvez également placer les feuilles de style dans un dossier provisoire ou dans le sous-dossier xslttemplate-files.
6. Créez ou modifiez un programme ou un site Web utilisant les feuilles de style XSLT.
Par exemple, vous pouvez utiliser pour votre site Web une page statique telle qu'index.html, qui réoriente automatiquement les utilisateurs Web vers une feuille de style XSLT ou qui comporte un lien vers cette dernière.
7. Assurez-vous que les mécanismes de sécurité pour votre site ou votre programme sont mis en œuvre.
8. Testez le site ou le programme avec les feuilles de style XSLT en utilisant les comptes et les autorisations d'accès définis pour les utilisateurs Web.
9. Mettez le site ou le programme à la disposition des utilisateurs.
Chapitre 5
|
Introduction à la publication Web personnalisée avec XSLT 53
Utilisation de l'outil FileMaker XSLT Site Assistant pour générer des feuilles de style FileMaker XSLT
FileMaker XSLT Site Assistant est une application utilisée pour créer des feuilles de style XSLT de base.
Ces dernières servent de point de départ pour la publication Web personnalisée avec XSLT. L'outil XSLT
Site Assistant vous aide à mieux appréhender la structure des feuilles de style FileMaker XSLT. Le cas
échéant, n'hésitez pas à utiliser vos propres outils de composition de feuilles de style XSLT ou éditeurs de texte pour modifier les feuilles de style. Vous ne pouvez pas utiliser XSLT Site Assistant pour modifier ni mettre à jour les feuilles de style existantes ; en revanche, vous pouvez l'employer pour générer les premières feuilles de style d'un site complet ou une feuille de style destinée à ajouter des fonctionnalités de base
(comme la suppression des enregistrements) à un site existant.
Vous pouvez utiliser l'outil XSLT Site Assistant pour générer des feuilles de style XSLT pour tous les types de pages utilisables avec les bases de données FileMaker via la publication Web personnalisée. Selon les options que vous choisissez dans XSLT Site Assistant, vous pouvez créer un site permettant aux utilisateurs :
1
de consulter un seul enregistrement à la fois ;
1
d'afficher une liste de tous les enregistrements de la base de données ;
1
d'effectuer des recherches dans la base de données et de visualiser les résultats dans une liste ;
1
de trier les enregistrements ;
1
d'ajouter des enregistrements ;
1
de modifier et de dupliquer les enregistrements ;
1
de supprimer des enregistrements ;
1
d'afficher un rapport récapitulatif.
Vous pouvez également générer une page d'accueil facultative liée aux autres feuilles de style XSLT générées.
Le moteur de publication Web utilise chacune de vos feuilles de style pour obtenir des données d'une base de données FileMaker de façon dynamique, chaque fois qu'un utilisateur Web envoie une requête HTTP et une adresse URL faisant référence à l'une de vos feuilles de style XSLT. Le moteur de publication Web utilise une feuille de style pour convertir et formater les données XML, puis génère la page HTML correspondante manipulable par l'utilisateur Web.
Remarque
Les feuilles de style de XSLT Site Assistant convertissent les données FileMaker XML en pages HTML en fonction de la grammaire XML fmresultset, qui rend les feuilles de style incompatibles avec d'autres utilisations des données XML, telles qu'une exportation XML dans FileMaker Pro.
Avant d'utiliser XSLT Site Assistant
Avant d'utiliser XSLT Site Assistant pour générer des feuilles de style XSLT pour une base de données :
1
Définissez l'autorisation d'accès étendue sur fmxslt dans la base de données. Lors de l'exécution de XSLT Site Assistant, utilisez les ensembles d'autorisations d'accès similaires à ceux que vous attribuez
1
Ouvrez et hébergez la base de données sur le composant Serveur de base de données de FileMaker
Server. Consultez l'Aide de FileMaker Server.
1
Assurez-vous que le composant serveur Web du déploiement FileMaker Server est en cours d’exécution.
54 Publication Web personnalisée de FileMaker Server avec XML et XSLT
1
Assurez-vous que le composant moteur de publication Web du déploiement FileMaker Server est en cours d’exécution.
1
Activez la publication XSLT dans le moteur de publication Web pour l'utilisation et le test des feuilles de style XSLT. Consultez l'Aide de FileMaker Server.
Démarrage de XSLT Site Assistant
Remarque
Pour utiliser XSLT Site Assistant, vous devez avoir préalablement installé la version 5 ou 6 de
Java Runtime Environment.
Pour démarrer XSLT Site Assistant
1. Ouvrez un navigateur à la page Outils de publication Web FileMaker Server.
Allez à l'URL suivant : http:// <serveur> :16000/tools
Où
<serveur>
est la machine sur laquelle se trouve FileMaker Server.
2. Cliquez sur Outils PHP Site Assistant et XSLT Site Assistant pour accéder à la page Outils de publication
Web FileMaker Server.
3. Cliquez sur Lancer XSLT Site Assistant.
FileMaker Server installe les fichiers JAR nécessaires sur votre machine locale. Une barre de progression s'affiche tant que la procédure n'est pas terminée.
4. (Facultatif) Après l’installation des fichiers, vous pouvez choisir d’installer ou non une icône pour
XSLT Site Assistant sur votre bureau. Cliquez sur OK pour installer l’icône.
Vous pouvez maintenant commencer à utiliser XSLT Site Assistant.
Utilisation de XSLT Site Assistant
Pour obtenir des informations et des procédures détaillées concernant l'utilisation de XSLT Site Assistant, consultez l'Aide de XSLT Site Assistant. Pour plus d'informations sur l'utilisation des feuilles de style
Important
Lors de l'utilisation de XSLT Site Assistant, si vous choisissez une base de données comportant plusieurs tables, prenez soin de sélectionner des modèles associés à la même table ; dans le cas contraire, le site généré produira des résultats inattendus. Par exemple, supposons qu'une base de données contienne une table Products et une table Customers. Lorsque vous sélectionnez les modèles pour une page de recherche, une page de modification d'enregistrements et une page d'ajout d'enregistrements, assurez-vous que les modèles sont tous associés à la même table.
A propos des feuilles de style générées par XSLT Site Assistant
Les feuilles de style XSLT générées par XSLT Site Assistant intègrent plusieurs paramètres, éléments et instructions de traitement propres à FileMaker. Voici quelques exemples des éléments inclus :
1
L'instruction de traitement <?xslt-cwp-query params="query string-fragment"?> spécifie la grammaire XML
à utiliser et définit de façon statique le nom de la base de données que vous avez choisie dans
Chapitre 5
|
Introduction à la publication Web personnalisée avec XSLT 55
1
L'élément <xsl:param name="request-query"/> permet d'accéder aux informations de requête dans une requête ou des données de formulaire HTML. Par exemple, cet élément peut être utilisé dans les feuilles de style XSLT Site Assistant afin d'accéder aux informations de la requête en cours pour déterminer l'emplacement dans un jeu d'enregistrements trouvé et créer des liens vers les enregistrements précédent
et suivant. Consultez la rubrique « Accès aux demandes d'informations dans une requête », page 67.
1
L'élément <xsl:param name="authenticated-xml-base-uri"/> , parfois non inclus, permet d'accéder à l'identificateur URI (Uniform Resource Identifier) de base authentifié dans une requête lorsque des
XSLT Site Assistant génère également la feuille de style utilities.xsl pour définir les erreurs et les modèles
XSLT courants appelés par plusieurs feuilles de style Site Assistant.
Pour plus d'informations sur d'autres parties des feuilles de style XSLT Site Assistant, consultez le
chapitre 6, « Conception de feuilles de style FileMaker XSLT ».
Utilisation des feuilles de style FileMaker XSLT dans un programme ou un site Web
Que vous ayez utilisé XSLT Site Assistant pour générer des feuilles de style XSLT ou que vous ayez créé intégralement vos propres feuilles de style, la procédure d'utilisation de ces dernières dans un programme ou un site Web avec le moteur de publication Web est la même.
Pour utiliser les feuilles de style FileMaker XSLT dans un programme ou un site Web :
1. Copiez ou placez les feuilles de style XSLT dans le sous-dossier xslt-template-files, situé dans le dossier
Publication Web de FileMaker Server, sur l'ordinateur hôte sur lequel le moteur de publication Web est installé.
Vous pouvez également placer les feuilles de style dans un dossier provisoire ou dans le sous-dossier xslttemplate-files.
2. Si vos feuilles de style XSLT font référence à des fichiers statiques, tels que des fichiers HTML ou des images statiques, placez ces fichiers dans leur arborescence de dossiers d'origine sous le dossier racine du serveur
Web. Assurez-vous que le chemin d'accès relatif est préservé.
Par exemple, supposons qu'une feuille de style XSLT fasse référence à un fichier image appelé logo.jpg
à l'aide de la balise HTML <img src="logo.jpg">. Le fichier logo.jpg doit être installé dans l'emplacement suivant du serveur Web :
<dossier racine>/fmi/xsl/logo.jpg
3. 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é, puis doit être copié ou déplacé dans un dossier possédant le même emplacement relatif dans le dossier racine du logiciel de serveur Web. Consultez la rubrique
« A propos de la publication du contenu des rubriques Multimédia sur le Web », page 23.
Remarque
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 si le fichier de base de données est correctement hébergé et aisément accessible sur FileMaker Server.
56 Publication Web personnalisée de FileMaker Server avec XML et XSLT
4. Pour effectuer une requête de traitement de feuille de style XSLT, utilisez la syntaxe d'URL suivante :
<scheme>://<host>[:<port>]/fmi/xsl/<folder>/<stylesheet>.xsl[?<query string>]
Remarque
Dans le cas des sites Web, il est recommandé d'inclure une feuille de style XSLT comme page d'accueil accessible aux utilisateurs sans requérir la saisie d'une chaîne de requête. L'outil XSLT Site Assistant peut créer un fichier home.xsl ne nécessitant aucune chaîne de requête grâce à l'utilisation de l'instruction de traitement
<?xslt-cwp-query?>. 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, les utilisateurs Web peuvent 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
Important
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. Lorsque les utilisateurs Web envoient une requête pour tratier une feuille de style, le moteur de publication Web n'envoie au programme ou au navigateur Web que le résultat de la conversion de la feuille de style.
Résolution des problèmes sur les feuilles de style XSLT
Si vous rencontrez des problèmes lors de l'utilisation de feuilles de style XSLT, vérifiez que :
1
Les autorisations d'accès étendues dans la base de données sont configurées pour la publication Web
1
La base de données est hébergée et ouverte sur le composant Serveur de base de données de 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 composant serveur Web du déploiement FileMaker Server est en cours d’exécution.
1
Le composant moteur de publication Web du déploiement FileMaker Server est en cours d’exécution.
1
La publication XSLT 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 XSLT pour ouvrir une page XSLT 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.
