Filemaker Server 13 Manuel utilisateur
Vous trouverez ci-dessous de brèves informations sur Server 13. Ce guide explique comment publier des bases de données FileMaker sur le Web à l'aide de XML. Il couvre la configuration requise, la préparation des bases de données, l'accès aux données XML, le stockage, les tests et le suivi d'un site.
FileMaker
®
Server 13
Publication Web personnalisée avec XML
© 2004-2013 FileMaker, Inc. Tous droits réservés.
FileMaker, Inc.
5201 Patrick Henry Drive
Santa Clara, Californie 95054
FileMaker et Bento sont des marques commerciales de FileMaker, Inc. déposées aux Etats-Unis et dans d'autres pays.
Le logo en forme de dossier, FileMaker WebDirect et le logo Bento sont des marques commerciales de FileMaker, Inc.
Toutes les autres marques sont la propriété de leurs détenteurs respectifs.
La documentation de FileMaker est protégée par la législation sur les droits d'auteur. Vous n'êtes pas autorisé à créer des copies supplémentaires ni à distribuer cette documentation sans l'accord écrit de FileMaker. Vous devez posséder une copie sous licence valide de FileMaker pour utiliser cette documentation.
Toutes les personnes, sociétés, adresses email et URL citées dans les exemples sont fictives et toute ressemblance avec des personnes, des sociétés, des adresses email ou des URL existantes ne serait que pure coïncidence. La liste des auteurs est disponible dans les documents Remerciements fournis avec ce logiciel. Les produits tiers et les adresses URL sont mentionnés à titre indicatif uniquement, et non pas à titre de recommandation. FileMaker, Inc. se dégage de toute responsabilité concernant les performances de ces produits.
Pour plus de détails, consultez notre site Web, à l'adresse http://www.filemaker.fr.
Edition : 01
Table des matières
Chapitre 1
Introduction à la Publication Web personnalisée
A propos du moteur de publication Web
Traitement d'une requête du moteur de publication Web
Publication Web personnalisée avec PHP
Publication Web personnalisée avec XML
Chapitre 2
A propos de la fonction de Publication Web personnalisée utilisant le langage XML
Création de sites Web dynamiques avec le moteur de publication Web
Fonctions clés de la Publication Web personnalisée avec XML
Configuration pour la publication Web
Configuration requise pour la publication d'une base de données à l'aide de la
Eléments à utiliser par les utilisateurs Web pour accéder à une solution de publication
Connexion à Internet ou à un intranet
Chapitre 3
Préparation des bases de données pour la Publication Web personnalisée
Activation de la Publication Web personnalisée dans une base de données
Accès à une base de données protégée
Protection de vos bases de données publiées
Prise en charge du serveur Web pour les types de média Internet (MIME)
A propos de la publication du contenu des rubriques Conteneur sur le Web
Objets de rubriques Conteneur imbriqués dans une base de données
Rubriques Conteneur avec fichiers référencés
Rubriques Conteneur avec données stockées en externe
Affichage des données d'une rubrique Conteneur par les utilisateurs Web
Scripts FileMaker et Publication Web personnalisée
Astuces et considérations à propos des scripts
Comportement des scripts dans les solutions de Publication Web personnalisée
Déclencheurs de scripts et solutions de Publication Web personnalisée
7
9
9
10
9
9
8
8
14
18
20
20
17
17
17
20
22
22
14
15
15
16
12
13
13
13
11
11
12
12
6
6
Chapitre 4
Accès aux données XML avec le moteur de Publication Web
Utilisation de la Publication Web personnalisée avec XML
Différences entre le moteur de publication Web et les options d'importation/exportation
Génération de données XML par le moteur de publication Web à partir d'une requête
Processus général d'accès aux données XML à partir du moteur de publication Web
A propos de la syntaxe d'URL pour les données XML et les objets de type Conteneur
A propos de la syntaxe d'URL pour les données XML
A propos de la syntaxe d'URL pour les objets FileMaker de type Conteneur dans les solutions XML
A propos du codage de texte URL
Accès aux données XML via le moteur de publication Web
A propos des espaces de nom pour le langage XML de FileMaker
A propos des codes d'erreurs des bases de données FileMaker
Récupération des définitions de type de document pour les grammaires FileMaker
Utilisation de la grammaire fmresultset
Description des éléments de la grammaire fmresultset
Exemple de données XML dans la grammaire fmresultset
Utilisation d'autres grammaires XML FileMaker
Description des éléments de la grammaire FMPXMLRESULT
Exemple de données XML dans la grammaire FMPXMLRESULT
Description des éléments dans la grammaire FMPXMLLAYOUT
Exemple de données XML dans la grammaire FMPXMLLAYOUT
Utilisation de chaînes de requête FileMaker pour rechercher des données XML
Passage d'un modèle à un autre pour obtenir une réponse XML
Comprendre le traitement d'une requête XML
Dépannage de l'accès aux documents XML
Chapitre 5
Stockage, test et suivi d'un site
Stockage d'un site de Publication Web personnalisée
Test d'un site de Publication Web personnalisée
Exemples de feuilles de style permettant de tester les sorties XML
Utilisation des journaux d'erreurs et d'accès au serveur Web
Utilisation du journal du moteur de publication Web
Utilisation du journal des erreurs du module de serveur Web
Utilisation des journaux Tomcat
Annexe A
Noms corrects utilisés dans les chaînes de requête
A propos des commandes et des paramètres de requête
Consignes d'utilisation des commandes et des paramètres de requête
Analyse de commande de requête
A propos de la syntaxe d'un nom de rubrique entièrement qualifié
Utilisation de commandes de requêtes avec des rubriques de table externe
A propos de la syntaxe de spécification d'une rubrique de type Global
49
49
50
51
51
52
54
43
43
44
44
45
45
46
47
48
23
23
36
38
39
39
33
34
34
35
41
41
42
30
30
31
31
27
29
29
30
23
24
26
27
27
4
Références des commandes de requête
Commande de requête –dbnames (noms des bases de données)
Commande de requête –delete (supprimer l'enregistrement)
Commande de requête –dup (dupliquer l'enregistrement)
Commande de requête –edit (modifier l'enregistrement)
Commandes de requête –find, –findall ou –findany (rechercher les enregistrements)
Commande de requête –findquery (recherche composée)
Commande de requête –layoutnames (noms des modèles)
Commande de requête –new (nouvel enregistrement)
Commande de requête –scriptnames (noms des scripts)
Commande de requête –view (affichage des informations de modèle)
Références de paramètre de requête
Paramètre de requête –db (nom de base de données)
Paramètre de requête –delete.related (suppression d'enregistrements externes),
Paramètre de requête –field (nom de rubrique Conteneur)
Paramètre de requête fieldname (nom de rubrique non-Conteneur)
Paramètre de requête fieldname.op (opérateur de comparaison)
Paramètre de requête –lay (modèle)
Paramètre de requête –lay.response (changer de modèle pour la réponse)
Paramètre de requête –lop (opérateur logique)
Paramètres de requête –max (nombre maximal d'enregistrements)
Paramètre de requête –modid (ID de la modification)
Commande de requête –query (requête de recherche composée)
Paramètre de requête –recid (ID d'enregistrement)
Paramètre de requête –relatedsets.filter (filtrage d'enregistrements de table externe)
Paramètre de requête –relatedsets.max (limitation d'enregistrements de table externe)
Paramètre de requête –script (Script)
Paramètre de requête –script.param (transfert du paramètre au script)
Paramètre de requête –script.prefind (script avant une recherche)
Paramètre de requête –script.prefind.param (transfert du paramètre au script avant recherche)
Paramètre de requête –script.presort (script avant un tri)
Paramètre de requête –script.presort.param (transfert du paramètre au script avant recherche)
Paramètre de requête –skip (enregistrements ignorés)
Paramètre de requête –sortfield (rubrique de tri)
Paramètre de requête –sortorder (ordre de tri)
Annexe B
Codes d'erreur de la publication Web personnalisée
Numéros de code d'erreur au format XML
Numéros des codes d'erreur des bases de données FileMaker :
70
70
70
62
62
62
63
60
61
61
61
64
65
65
65
66
58
59
59
59
57
58
58
58
55
56
56
57
55
55
55
55
66
67
67
67
68
68
5
Annexe C
Modifications de requête XML dans FileMaker 12
Modifications de syntaxe de requête XML
Modifications de sémantique de requête XML
Différences de l'analyse de requête
Différences de traitement de requête
Différences dans les codes d'erreur renvoyés
78
78
78
78
79
80
81
6
Préface
Présentation de ce guide
Ce guide suppose que vous avez déjà une certaine expérience dans le domaine du langage XML, du développement de sites Web et de l'utilisation de FileMaker
®
Pro pour la création de bases de données. Vous devez comprendre les bases de la conception des bases de données avec
FileMaker Pro, ainsi que les concepts de rubriques, de liens, de modèles, de tables externes et d'objets Conteneur. Pour plus d'informations sur FileMaker Pro, reportez-vous à l'aide de
FileMaker Pro.
Concernant la Publication Web personnalisée avec le langage XML sous FileMaker Server, ce guide donne des informations sur :
1
les éléments nécessaires au développement d'une solution de Publication Web personnalisée
à l'aide du langage XML ;
1
la façon de publier des bases de données à l'aide du langage XML ;
1
les éléments que les utilisateurs Web doivent employer pour accéder à une solution de publication Web personnalisée ;
1
la façon d'obtenir des données XML à partir de bases de données hébergées par
FileMaker Server ;
Important
Vous pouvez télécharger la version PDF de la documentation de FileMaker à l'adresse suivante : http://www.filemaker.fr/support/product/documentation.html. Toutes les mises à jour de ce document sont également disponibles sur le site Web.
La documentation de FileMaker Server inclut les informations suivantes :
Pour plus d'informations sur Consultez le document
Installation et configuration de FileMaker Server
Guide de démarrage de FileMaker Server
Aide FileMaker Server
Guide de FileMaker WebDirect™
Méthode permettant de rendre les bases de données FileMaker Pro et FileMaker Pro
Advanced accessibles aux utilisateurs de navigateurs Web via un réseau intranet ou
Internet
Publication Web personnalisée avec PHP
Publication Web personnalisée avec XML
Publication Web personnalisée de FileMaker Server avec PHP
Publication Web personnalisée FileMaker Server avec XML
(ce manuel)
Guide ODBC et JDBC FileMaker
Installation et paramétrage des pilotes ODBC et
JDBC, et utilisation d'ODBJ et de JDBC
Normes et instructions SQL prises en charge par le logiciel FileMaker
Guide de référence SQL FileMaker.
Chapitre 1
Introduction à la Publication Web personnalisée
FileMaker Server vous permet de publier vos bases de données FileMaker Server sur Internet ou sur un intranet. Vous pouvez procéder de différentes manières :
Publication avec FileMaker WebDirect : Avec FileMaker WebDirect, vous avez la possibilité de publier rapidement et simplement des modèles à partir d'une base de données sur le Web.
Aucune installation de logiciels supplémentaires n’est nécessaire, avec un navigateur Web compatible et un accès à Internet ou à un intranet, les utilisateurs Web peuvent se connecter à votre solution FileMaker WebDirect pour consulter, éditer, trier ou chercher des enregistrements,
à condition que vous leur donniez des privilèges d’accès.
Avec FileMaker WebDirect, FileMaker Server doit être en cours d'exécution sur l'ordinateur hôte.
L'interface utilisateur ressemble à la version bureau de l'application FileMaker Pro. Les pages
Web et les formulaires sur lesquels l'utilisateur agit dépendent des modèles et des affichages définis dans la base de données FileMaker Pro. Pour plus d’informations, consultez le Guide de
FileMaker WebDirect.
Publication statique : Si vos données ne changent pas souvent ou si vous ne souhaitez pas que les utilisateurs puissent se connecter directement à votre base de données, vous pouvez faire appel à la publication statique. Avec cette dernière, vous exportez les données d'une base de données FileMaker Pro pour créer une page Web, que vous pouvez ensuite personnaliser à l'aide du langage HTML. Ainsi, la page n'est pas modifiée lorsque des données de la base le sont et les utilisateurs ne se connectent pas directement à votre base (Avec FileMaker WebDirect, les données sont mises à jour dans le navigateur Web dès qu'elles sont mises à jour dans la base de données). Pour plus d'informations, consultez l'Aide de FileMaker Pro.
Publication Web personnalisée : Pour intégrer votre base de données FileMaker à un site Web personnalisé, utilisez les technologies de Publication Web personnalisée disponibles avec
FileMaker Server. Pour FileMaker Server, qui héberge les bases de données publiées, il n'est pas nécessaire d'installer ni d'exécuter FileMaker Pro pour que la Publication Web personnalisée soit disponible.
La Publication Web personnalisée vous permet :
1
intégrer votre base de données à un autre site Web ;
1
déterminer la façon dont les utilisateurs interagissent avec les données ;
1
contrôler l'affichage des données dans les navigateurs Web.
FileMaker Server propose deux technologies de Publication Web personnalisée :
1
Publication Web personnalisée avec PHP : Utilisez l'API FileMaker pour PHP, qui propose une interface PHP orientée objet pour les bases de données FileMaker Pro, ce qui permet d'intégrer vos données FileMaker dans une application web PHP. Comme vous codez les pages Web
PHP vous-même, vous avez le contrôle complet de l'interface utilisateur et du mode d'interaction entre l'utilisateur et les données.
1
Publication Web personnalisée avec XML : Utilisez la publication de données XML pour
échanger des données FileMaker avec d'autres sites Web et applications. Grâce aux requêtes
URL HTTP avec les commandes et les paramètres de requête de FileMaker, vous pouvez interroger une base de données hébergée par FileMaker Server et télécharger les données obtenues au format XML, et utiliser les données obtenues de la façon qui vous plaît.
Chapitre 1 | Introduction à la Publication Web personnalisée 8
A propos du moteur de publication Web
Pour prendre en charge FileMaker WebDirect et la Publication Web personnalisée,
FileMaker Server utilise un jeu de composants logiciels appelé Moteur de Publication Web de
FileMaker Server. Le moteur de Publication Web gère les interactions entre le navigateur Web d'un utilisateur, votre serveur Web et FileMaker Server.
Publication Web personnalisée avec XML : Les utilisateurs Web accèdent à votre solution de
Publication Web personnalisée en cliquant sur un lien HREF ou en saisissant un URL (Uniform
Resource Locator) qui indique l'adresse du serveur Web, ainsi qu'une requête qui contient la chaîne de requête FileMaker. Le moteur de publication Web renvoie les données XML spécifiées dans la requête de chaîne.
Publication Web personnalisée avec PHP : Lorsqu'un utilisateur Web accède à votre solution de Publication Web personnalisée, PHP sur FileMaker Server se connecte au moteur de
Publication Web et répond via l'API de FileMaker pour PHP.
Utilisation du moteur de publication Web de FileMaker Server pour la Publication Web personnalisée
Navigateur
Web
1
6
Serveur Web
Module de serveur Web
API FM et code PHP
2
5
Moteur de publication
Web
Noyau de publication Web
3
Products.fmp12
Customers.fmp12
Base de données
Serveur
4
Traitement d'une requête du moteur de publication Web
1. Une requête est envoyée par un navigateur ou une application au serveur web.
2. Le serveur Web achemine la requête par le module serveur Web de FileMaker jusqu'au moteur de publication Web.
3. Le moteur de publication Web recherche les données dans la base de données hébergée par le serveur de bases de données.
4. FileMaker Server envoie les données FileMaker demandées au moteur de publication Web.
5. Le moteur de publication Web convertit les données FileMaker pour répondre à la requête.
1
Pour les requêtes PHP, le moteur de publication Web répond à la requête API.
1
Pour les requêtes XML, le moteur de publication Web envoie directement les données XML au serveur Web.
6. Le serveur Web envoie le résultat au navigateur web ou au programme demandeur.
Important
La sécurité est un aspect important de la publication de données sur le Web.
Consultez les règles de sécurité dans le Manuel de l'utilisateur FileMaker Pro, disponible au format PDF à l'adresse hhttp://www.filemaker.fr/support/product/documentation.html.
Chapitre 1 | Introduction à la Publication Web personnalisée 9
Publication Web personnalisée avec PHP
L'API FileMaker pour PHP propose une interface PHP orientée objet aux bases de données
FileMaker. L'API de FileMaker pour PHP permet l'accès aux données et logiques stockées dans une base de données FileMaker Pro et leur publication sur le Web, ainsi que leur export vers d'autres applications. L'API gère également les commandes de recherche complexes et composées permettant l'extraction et le filtrage des informations stockées dans des bases de données FileMaker Pro.
Conçu à l'origine comme un langage de programmation procédural, PHP est devenu un langage de développement Web orienté objet. PHP propose des fonctionnalités de langage de programmation permettant de construire n'importe quel type de logique dans une page de site.
Par exemple, vous pouvez utiliser les constructions logiques conditionnelles pour contrôler la génération de page, l'acheminement des données ou un déroulement d'opérations. PHP permet
également l'administration du site et la sécurité.
Publication Web personnalisée avec XML
La Publication Web personnalisée avec XML vous permet d'envoyer des demandes de requêtes
à une base de données FileMaker Pro hébergée par FileMaker Server, et d'afficher, modifier ou manipuler les résultats. L'utilisation d'une requête HTTP avec les commandes et les paramètres appropriés vous aide à récupérer les données FileMaker sous la forme d'un document XML.
Vous pouvez alors exporter les données XML vers d'autres applications.
Comparaison entre PHP et XML
La section suivante propose quelques grandes lignes permettant de déterminer la meilleure solution pour votre site.
Raisons de choisir PHP
1
PHP est un langage de script procédural orienté objet plus puissant, mais son apprentissage est relativement simple. Des nombreuses ressources sont disponibles pour la formation, le développement et l'assistance.
1
L'API de FileMaker pour PHP permet l'accès aux données et logiques stockées dans une base de données FileMaker Pro et leur publication sur le Web, ainsi que leur export vers d'autres applications.
1
PHP permet d'utiliser des logiques conditionnelles pour contrôler la construction de la page ou les flux.
1
PHP propose des fonctionnalités de langage de programmation permettant de construire n'importe quel type de logique dans une page de site.
1
PHP est l'un des langages de script les plus populaires du web.
1
PHP est un langage libre ; il est disponible sur http://php.net.
1
PHP permet l'accès à une grande variété de modules tiers que vous pouvez intégrer dans vos solutions.
Remarque
Pour plus d'informations sur la Publication Web personnalisée avec PHP, consultez la section Publication Web personnalisée FileMaker Server avec PHP.
Chapitre 1 | Introduction à la Publication Web personnalisée 10
Raisons de choisir XML
1
La syntaxe des paramètres d'interrogation XML de FileMaker est conçue pour l'interaction avec les bases de données, ce qui simplifie le développement de solutions.
1
XML est une norme W3C.
1
XML est un format lisible par les hommes et les machines. Il gère Unicode, ce qui permet la communication des données dans n'importe quelle langue écrite.
1
XML est bien adapté à la présentation d'enregistrements, de listes et de données structurées en liste.
1
Vous pouvez utiliser FMPXMLRESULT pour accéder aux données XML en utilisant la Publication
Web personnalisée et pour l'export XML à partir de bases de données FileMaker Pro.
Chapitre 2
A propos de la fonction de Publication Web personnalisée utilisant le langage XML
Création de sites Web dynamiques avec le moteur de publication Web
Le moteur de publication Web dote FileMaker Server de la Publication Web personnalisée en utilisant la publication de données XML. La Publication Web personnalisée offre divers avantages :
1
Personnalisation : Vous pouvez déterminer comment les utilisateurs Web interagissent avec les données FileMaker et comment les données s'affichent dans les navigateurs Web.
1
Echange de données : L'utilisation du format XML de FileMaker vous permet d'échanger des données FileMaker avec d'autres sites Web et d'autres applications.
1
Intégration des données : Vous pouvez intégrer des données FileMaker dans d'autres sites
Web, avec d'autres middlewares et avec des applications personnalisées. Vous pouvez faire en sorte que les données s'affichent comme si elles provenaient d'un autre site Web au lieu d'afficher un modèle FileMaker complet dans le navigateur Web.
1
Sécurité : L'administrateur FileMaker Server peut activer ou désactiver individuellement les fonctions de Publication Web XML pour toutes les bases de données hébergées sur le serveur.
En tant que propriétaire de la base de données FileMaker, vous pouvez contrôler l'accès des utilisateurs Web à la Publication Web XML pour chaque base de données.
1
Contrôle et filtrage des données publiées : Vous pouvez contrôler et filtrer les données et le type des données contenues dans la base de données que vous souhaitez publier tout en empêchant l'utilisation non autorisée de la base de données. Vous pouvez également masquer les métadonnées, comme par exemple les noms de la base de données et de la rubrique.
1
Utilisation d'une norme ouverte : Les outils, les ressources et le personnel compétent auxquels vous avez accès pour les solutions de Publication Web personnalisée sont plus importants. Si vous connaissez déjà le langage XML standard, vous pouvez vous lancer immédiatement dans le développement de solutions. Vous devez néanmoins connaître la syntaxe d'URL et les paramètres de requête à employer pour utiliser la Publication Web personnalisée avec XML.
La Publication Web personnalisée avec XML vous permet de récupérer des données dans les bases de données FileMaker et de les utiliser facilement dans d'autres formats de sortie.
L'utilisation d'une requête HTTP avec les commandes et les paramètres appropriés vous aide à récupérer les données FileMaker sous la forme d'un document XML. Vous pouvez alors exporter
Chapitre 2 | A propos de la fonction de Publication Web personnalisée utilisant le langage XML 12
Fonctions clés de la Publication Web personnalisée avec XML
La Publication Web personnalisée FileMaker Server avec XML fournit plusieurs nouvelles fonctionnalités importantes :
1
Les bases de données sont hébergées sur FileMaker Server et l'application FileMaker Pro ne doit pas forcément être lancée.
1
Vous pouvez utiliser le traitement JavaScript côté serveur de XML.
1
Comme dans FileMaker Pro, l'accès aux données, aux modèles et aux rubriques, est basé sur les paramètres de compte d'utilisateur définis dans les privilèges d'accès de la base de données. Le moteur de publication Web présente également plusieurs autres améliorations en matière de
sécurité. Consultez la section « Protection de vos bases de données publiées », page 15.
1
Les utilisateurs Web peuvent exécuter des scripts complexes contenant plusieurs actions.
FileMaker prend en charge près de 65 actions de script dans la Publication Web personnalisée.
Consultez la section « Scripts FileMaker et Publication Web personnalisée », page 20.
1
Vous pouvez transmettre une valeur de paramètre à un script FileMaker. Pour plus d'informations,
consultez les rubriques « Paramètre de requête –script.param (transfert du paramètre au script) »,
page 65, « Paramètre de requête –script.prefind.param (transfert du paramètre au script avant
1
La grammaire XML fmresultset vous permet d'accéder aux rubriques par leur nom et de manipuler les données relatedset (table externe).
1
Pour accéder aux données d'une base de données, vous devez indiquer un modèle. Consultez
la section annexe A, « Noms corrects utilisés dans les chaînes de requête ».
Configuration pour la publication Web
Configuration requise pour la publication d'une base de données à l'aide de la
Publication Web personnalisée
Pour publier des bases de données à l'aide de la fonction de Publication Web personnalisée avec
XML, il vous faut :
1
un déploiement FileMaker Server comportant ;
1
un serveur Web, Microsoft IIS (Windows) ou Apache (OS X)
1
le serveur de bases de données FileMaker, avec option Publication Web personnalisée activée ;
1
le moteur de publication Web installé et configuré ;
1
une ou plusieurs bases de données FileMaker Pro hébergées par FileMaker Server ;
1
l'adresse IP ou le nom de domaine de l'hôte exécutant le serveur Web.
1
Un navigateur Web et un accès au serveur Web pour développer et tester la solution de publication Web personnalisée.
Pour plus d'informations, consultez le Guide de démarrage de FileMaker Server.
Chapitre 2 | A propos de la fonction de Publication Web personnalisée utilisant le langage XML 13
Eléments à utiliser par les utilisateurs Web pour accéder à une solution de publication Web personnalisée
Pour accéder à une solution de Publication Web personnalisée utilisant XML, les utilisateurs Web doivent posséder :
1
un navigateur Web ;
1
un accès à Internet ou à un intranet, ainsi qu'un accès au serveur Web ;
1
l'adresse IP ou le nom de domaine de l'hôte exécutant le serveur Web.
Si la base de données est protégée par un mot de passe, les utilisateurs Web doivent également saisir un nom d'utilisateur et un mot de passe pour accéder au compte de la base de données.
Connexion à Internet ou à un intranet
Lorsque vous publiez des bases de données sur Internet ou sur un intranet, l'ordinateur hôte doit exécuter FileMaker Server et les bases de données que vous souhaitez partager doivent être hébergées et accessibles. En outre :
1
Publiez votre base de données sur un ordinateur possédant une connexion permanente à Internet ou à un intranet. En effet, si la connexion n'est pas permanente, les utilisateurs Web doivent attendre que l'hôte se connecte à Internet ou à un intranet pour accéder à la base de données.
1
L'ordinateur hôte du serveur Web, partie intégrante du déploiement FileMaker Server, doit posséder une adresse IP statique (permanente) dédiée ou un nom de domaine. Si vous vous connectez à Internet par le biais d'un fournisseur d'accès Internet (FAI), votre adresse IP est généralement attribuée de façon dynamique (elle est donc différente à chaque fois que vous vous connectez). Le cas échéant, les utilisateurs Web auront plus de difficultés à localiser une base de données. Si vous ne savez pas de quel type d'accès vous disposez, contactez votre fournisseur d'accès à Internet ou l'administrateur du réseau.
Etape suivante
Voici quelques suggestions pour commencer à développer des solutions de Publication Web personnalisée :
1
Si ce n'est pas déjà fait, utilisez l'Admin Console de FileMaker Server pour activer la Publication
Web personnalisée. Reportez-vous à l'aide de FileMaker Server et au Guide de démarrage de
FileMaker Server.
1
Dans FileMaker Pro, ouvrez chaque base de données FileMaker à publier et assurez-vous que chacune d'entre elles dispose du ou des privilèges d'accès étendus pour la Publication Web
1
Pour savoir comment accéder aux données dans les bases de données FileMaker en utilisant
le langage XML, consultez la section « Accès aux données XML via le moteur de publication
Chapitre 3
Préparation des bases de données pour la
Publication Web personnalisée
Avant d'utiliser la Publication Web personnalisée avec une base de données, vous devez préparer la base de données et la protéger contre les accès non autorisés.
Activation de la Publication Web personnalisée dans une base de données
Vous devez activer la Publication Web personnalisée avec XML dans chaque base de données que vous souhaitez publier. Si vous n'activez pas la Publication Web personnalisée avec XML dans la base de données, les utilisateurs Web ne seront pas en mesure de l'utiliser pour accéder
à la base de données, même si elle est hébergée par un serveur FileMaker Server configuré pour prendre en charge un Moteur de publication Web.
Pour activer la Publication Web personnalisée pour une base de données :
1. Dans FileMaker Pro, ouvrez la base de données que vous souhaitez publier en utilisant un compte bénéficiant du jeu de privilèges Accès intégral. Une autre possibilité consiste à ouvrir la base de données en utilisant un compte bénéficiant des privilèges d'accès Gérer les autorisations étendues.
2. Affectez la Publication Web personnalisée comprenant des privilèges XML étendus en utilisant ce mot de passe :
fmxml
3. Affectez le(s) jeu(x) de privilèges comprenant le privilège d'accès étendu de Publication Web personnalisée à un ou plusieurs comptes, ou au compte Admin ou d'invité.
Remarque
Au moment de définir les noms des comptes et les mots de passe relatifs aux solutions de publication Web personnalisée, utilisez les caractères ASCII imprimables, par exemple
a
-
z
,
A
-
Z
et
0
-
9
. Pour sécuriser davantage encore les noms des comptes et les mots de passe, intégrez des caractères de ponctuation du type «
!
» et «
%
» mais n'utilisez pas les deux points. Pour obtenir des informations sur la configuration de comptes, consultez l'aide
FileMaker Pro.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 15
Accès à une base de données protégée
La Publication Web personnalisée avec XML vous permet de limiter l'accès à vos bases de données publiées à l'aide d'une protection par mot de passe de vos bases de données, d'un cryptage de la base de données et de connexions sécurisées. Lorsqu'ils utilisent une solution de Publication Web personnalisée pour accéder à une base de données, les utilisateurs Web peuvent être invités à spécifier leurs informations de compte. Si le compte Invité de la base de données est désactivé ou ne possède aucun jeu de privilèges d'accès activé comprenant un privilège d'accès étendu pour la Publication Web personnalisée, le moteur de publication Web utilise une authentification de base HTTP pour demander aux utilisateurs Web de s'authentifier.
Le navigateur de l'utilisateur Web affiche la boîte de dialogue d'authentification de base HTTP pour permettre à l'utilisateur de saisir le nom d'utilisateur et le mot de passe d'un compte bénéficiant d'un privilège d'accès étendu pour la Publication Web personnalisée.
La liste suivante résume le processus qui se produit lorsqu'un utilisateur web utilise une solution de Publication Web personnalisée pour accéder à une base de données :
1
Si vous n'avez pas défini de mot de passe pour un compte, les utilisateurs Web devront uniquement spécifier le nom de compte.
1
Si le compte Invité est désactivé, les utilisateurs sont invités à donner un nom de compte et un mot de passe lorsqu'ils accèdent à une base de données. Un privilège d'accès étendu pour la
Publication Web personnalisée doit être activé pour ce compte.
1
Si le compte Invité est activé et bénéficie d'un jeu de privilèges comprenant un privilège d'accès
étendu pour la Publication Web personnalisée, tous les utilisateurs Web peuvent automatiquement ouvrir la base de données avec les privilèges d'accès du compte Invité. Si le privilège étendu de Publication Web personnalisée est attribué au compte Invité :
1
Les utilisateurs Web n'ont pas besoin de spécifier de nom de compte ni de mot de passe lorsqu'ils ouvrent un fichier.
1
Tous les utilisateurs Web se connectent automatiquement avec le compte Invité et héritent des privilèges d'accès de celui-ci. Vous pouvez permettre aux utilisateurs de changer de compte de connexion via leur navigateur Web grâce à la commande de script Reconnexion (par exemple, pour basculer du compte Invité à un autre compte, jouissant de privilèges plus étendus).
1
Le jeu de privilèges par défaut des comptes Invité fournit un accès en « lecture seule ».
Vous pouvez modifier les privilèges par défaut de ce compte, notamment les privilèges
étendus. Consultez l'Aide FileMaker Pro.
Remarque
Par défaut, les utilisateurs Web ne peuvent pas modifier le mot de passe de leur compte depuis un navigateur Web. Vous pouvez intégrer cette fonction dans une base de données grâce à l'action de script Modifier le mot de passe, qui permet aux utilisateurs Web de changer leur mot de passe depuis leur navigateur. Consultez l'Aide FileMaker Pro.
Protection de vos bases de données publiées
La fonction de Publication Web personnalisée utilisant le langage XML vous permet de limiter l'accès à vos bases de données publiées.
1
Affectez des mots de passe aux comptes de base de données utilisés pour la Publication Web personnalisée.
1
Activez uniquement la fonction de Publication Web personnalisée utilisant le langage XML dans les jeux de privilèges des comptes que vous souhaitez autoriser à accéder à vos bases de données publiées.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 16
1
Désactivez la Publication Web personnalisée avec XML pour une base de données spécifique en désélectionnant le privilège étendu fmxml pour tous les jeux de privilèges d'accès de cette base de données. Consultez l'Aide FileMaker Pro.
1
Activez ou désactivez la Publication Web personnalisée pour toutes les solutions de Publication
Web personnalisée dans le moteur de publication Web à l'aide de l'Admin Console de FileMaker
Server. Consultez le Guide de démarrage de FileMaker Server et l'Aide FileMaker Server.
1
Configurez votre serveur Web de façon à restreindre les adresses IP ayant accès à vos bases de données via le moteur de publication Web. Vous pouvez par exemple indiquer que seuls les utilisateurs Web utilisant l'adresse IP 192.168.100.101 sont autorisés à accéder à vos bases de données. Pour plus d'informations sur la restriction d'adresses IP, consultez la documentation de votre serveur Web.
FileMaker Server prend en charge le cryptage des données écrites sur disque et des données transférées aux clients.
1
Cryptez votre base de données à l'aide de la fonction Cryptage de base de données de
FileMaker Pro Advanced. Le cryptage protège le fichier de base de données FileMaker et tous les fichiers temporaires écrits sur disque. Pour plus d'informations sur le cryptage d'une base de données, consultez le Guide de l'utilisateur de FileMaker Pro, le Guide de démarrage de
FileMaker Server et l'Aide FileMaker Pro.
1
Une base de données cryptée hébergée sur FileMaker Server s'ouvre à l'aide de l'Admin
Console ou de l'interface de ligne de commande (CLI). En tant qu'administrateur de
FileMaker Server, ouvrez le fichier avec son mot de passe de cryptage de base de données afin que les clients FileMaker puissent utiliser la base de données cryptée.
1
Une fois que l'administrateur de FileMaker Server a ouvert la base de données cryptée
FileMaker avec le mot de passe de cryptage, les clients FileMaker n'ont pas besoin du mot de passe de cryptage pour accéder à la base de données cryptée. Pour plus d'informations sur l'ouverture d'une base de données cryptée, consultez l'Aide FileMaker Server.
1
Utilisez le cryptage Secure Socket Layer (SSL) pour les communications entre votre serveur Web et vos navigateurs Web. Le cryptage SSL convertit les informations échangées entre les serveurs et les clients en informations incompréhensibles, grâce à l'utilisation de formules mathématiques appelées algorithmes de cryptage. Ces algorithmes sont utilisés pour retransformer les informations en données lisibles via des clés de cryptage. Une connexion HTTPS permet d'accéder aux connexions SSL. Une fois qu'elles sont paramétrées et opérationnelles, le client n'a plus rien à faire. Pour plus d'informations sur l'activation, la configuration et la gestion de vos connexions SSL, consultez la documentation de votre serveur Web.
Pour plus d'informations sur la protection de votre base de données, consultez le
Guide de l'utilisateur de FileMaker Pro, disponible au format PDF à l'adresse http://www.filemaker.fr/support/product/documentation.html.
Prise en charge du serveur Web pour les types de média Internet (MIME)
Votre serveur Web détermine la prise en charge des types MIME (Multipurpose Internet Mail
Extensions) actuellement enregistrés pour Internet. Le moteur de publication Web ne change pas la prise en charge MIME par le serveur Web. Pour plus d'informations, consultez la documentation de votre serveur Web.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 17
A propos de la publication du contenu des rubriques Conteneur sur le Web
Le contenu d'une rubrique Conteneur peut être imbriqué dans la base de données, lié par référence à l'aide d'un chemin relatif ou stocké en externe.
Objets de rubriques Conteneur imbriqués dans une base de données
Si une rubrique Conteneur stocke les fichiers réels dans la base de données FileMaker, toute action sur le contenu de la rubrique conteneur est inutile lorsque le fichier de base de données est
Remarques
1
Le moteur de Publication Web prend en charge un téléchargement progressif des fichiers audio (.mp3), des fichiers vidéo (.mov, .mp4 et .avi recommandés) et des fichiers PDF pour les conteneurs interactifs. Par exemple, un utilisateur Web peut commencer à visionner un film, même si la totalité du fichier vidéo n'est pas encore téléchargée. Pour rendre ce téléchargement progressif possible, vous devrez créer les fichiers en utilisant des options qui prennent en charge la lecture en direct ou qui sont optimisés pour s'afficher sur le Web. Par exemple, créez les fichiers
PDF à l'aide de l'option « Optimisé pour un affichage Web ».
1
Lorsque le paramètre FileMaker Server
Activer des connexions sécurisées
n'est pas sélectionné, les connexions que FileMaker Server utilise pour transférer des données ne sont pas cryptées pendant le transfert.
1
Les clients FileMaker voient les données du conteneur interactif avec un léger retard.
1
FileMaker Server décrypte les données de la rubrique Conteneur vers un dossier cache sur le serveur lorsqu'un client FileMaker Pro, FileMaker Go ou Web interroge des données. Ces données restent décryptées dans le dossier cache du serveur pendant deux heures, jusqu'à ce que FileMaker Server vide périodiquement le dossier cache. Les données ne sont pas mises en cache localement sur le client.
1
Lorsque le paramètre FileMaker Server
Activer des connexions sécurisées
est sélectionné,
FileMaker Server utilise des connexions sécurisées pour transférer des données. Les clients
FileMaker téléchargent l'intégralité des donnés du Conteneur avant que l'utilisateur ne puisse interagir avec ces données. Les données sont tout aussi sécurisées que si la solution était une base de données locale, étant donné qu'aucun fichier du cache temporaire n'est créé et que les données sont cryptées pendant le transfert.
Le serveur de bases de données doit être arrêté et redémarré lorsque le paramètre
Activer des connexions sécurisées
est modifié, afin que le nouveau paramètre soit appliqué.
Rubriques Conteneur avec fichiers référencés
Si une rubrique Conteneur contient une référence de fichier, vous devez suivre les étapes suivantes pour publier les fichiers référencés à l'aide du moteur de publication Web :
Pour publier des objets de rubrique Conteneur stockés comme référence de fichier :
1. Stockez les fichiers d'objet Conteneur dans le dossier Web, situé dans le dossier
FileMaker Pro.
2. Dans FileMaker Pro, insérez les objets dans la rubrique Conteneur et sélectionnez l'option
Stocker uniquement la référence au fichier
.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 18
3. Copiez ou déplacez les fichiers d'objet référencé du dossier Web vers le même emplacement relatif, dans le dossier racine du logiciel de serveur.
1
Pour IIS (Windows) :
[drive]:\Program Files\FileMaker\FileMaker Server\HTTPServer\conf où [drive] correspond au lecteur sur lequel réside le composant Moteur de Publication
Web de votre déploiement FileMaker Server.
1
Pour Apache (OS X) : /Bibliothèque/FileMaker Server/HTTPServer/htdocs
Remarques
1
Pour les objets Conteneur stockés sous forme de référence externe, votre serveur Web doit
être configuré pour prendre en charge les types MIME (Multipurpose Internet Mail Extensions) correspondant aux types de fichiers que vous souhaitez publier, par exemple des vidéos. Votre serveur Web détermine la prise en charge des types MIME actuellement enregistrés pour
Internet. Le moteur de publication Web ne change pas la prise en charge MIME par le serveur
Web. Pour plus d'informations, consultez la documentation de votre serveur Web.
1
Toutes les séquences QuickTime sont stockées dans une rubrique Conteneur sous forme de référence.
Rubriques Conteneur avec données stockées en externe
Si une rubrique Conteneur stocke des objets en externe (en d'autres termes, si vous avez sélectionné
Stocker les données de conteneur en externe
dans la boîte de dialogue Options de rubrique Filemaker Pro), utilisez FileMaker Pro pour transférer des fichiers de base de données depuis le système de fichiers clients vers FileMaker Server. Lorsque vous utilisez
FileMaker Pro pour télécharger une base de données, les données de la rubrique Conteneur stockées en externe sont téléchargées vers FileMaker Server dans le cadre du processus.
Pour plus d'informations sur le transfert de fichiers de base de données vers FileMaker Server, consultez l'Aide FileMaker Pro.
Lorsque vous téléchargez manuellement une base de données qui utilise une rubrique Conteneur avec des objets stockés en externe, vous devez exécuter ces étapes pour publier les objets
Conteneur stockés en externe en utilisant le moteur de Publication Web.
Pour télécharger manuellement une base de données :
1. Placez le fichier de base de données à l'emplacement adéquat sur le serveur. Placez les fichiers de base de données FileMaker Pro que FileMaker Server doit ouvrir (ou leurs raccourcis (Windows) ou alias (MacOS)) dans les dossiers suivants :
1
Windows :
[drive]:\Program Files\FileMaker\FileMaker Server\Data\Databases\ où [drive] correspond au lecteur principal servant au démarrage de votre système.
1
OS X : /Bibliothèque/FileMaker Server/Data/Databases/
Vous pouvez également placer les fichiers dans un dossier de bases de données supplémentaire défini en option.
2. Dans le dossier dans lequel vous avez placé la base de données, créez un dossier nommé
RC_Data_FMS, s'il n'existe pas encore.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 19
3. Dans le dossier RC_Data_FMS, créez un dossier dont le nom correspond à celui de votre base de données. Par exemple, si votre base de données s'appelle Clients, créez un dossier nommé
Clients. Placez les objets stockés en externe dans le dossier que vous venez de créer.
Remarque
Lorsque les bases de données sont hébergées sur FileMaker Server, plusieurs bases de données ne peuvent en aucun cas partager un dossier commun d'objets Conteneur.
Les objets Conteneur de chacune des bases de données doivent se trouver dans un dossier identifié par ce nom de base de données.
4. Pour les fichiers partagés depuis OS X, changez les fichiers de façon à ce qu'ils appartiennent au groupe
fmsadmin
.
Pour plus d'informations sur le téléchargement manuel de bases de données, consultez l'Aide
FileMaker Pro.
Remarques
1
Le moteur de Publication Web prend en charge un téléchargement progressif des fichiers audio
(.mp3), des fichiers vidéo (.mov, .mp4 et .avi recommandés) et des fichiers PDF pour les conteneurs interactifs. Par exemple, un utilisateur Web peut commencer à visionner un film, même si la totalité du fichier vidéo n'est pas encore téléchargée. Pour rendre ce téléchargement progressif possible, vous devrez créer les fichiers en utilisant des options qui prennent en charge la lecture en direct ou qui sont optimisés pour s'afficher sur le Web. Par exemple, créez les fichiers PDF à l'aide de l'option « Optimisé pour un affichage Web ».
1
Lorsque le paramètre FileMaker Server
Activer des connexions sécurisées
n'est pas sélectionné, les connexions que FileMaker Server utilise pour transférer des données ne sont pas cryptées pendant le transfert.
1
Les clients FileMaker voient les données du conteneur interactif avec un léger retard.
1
FileMaker Server décrypte les données de la rubrique Conteneur vers un dossier cache sur le serveur lorsqu'un client FileMaker Pro, FileMaker Go ou Web interroge des données. Ces données restent décryptées dans le dossier cache du serveur pendant deux heures, jusqu'à ce que FileMaker Server vide périodiquement le dossier cache. Les données ne sont pas mises en cache localement sur le client.
1
Lorsque le paramètre FileMaker Server
Activer des connexions sécurisées
est sélectionné,
FileMaker Server utilise des connexions sécurisées pour transférer des données. Les clients
FileMaker téléchargent l'intégralité des données du Conteneur avant que l'utilisateur ne puisse interagir avec ces données. Les données sont tout aussi sécurisées que si la solution était une base de données locale, étant donné qu'aucun fichier du cache temporaire n'est créé et que les données sont cryptées pendant le transfert.
Le serveur de bases de données doit être arrêté et redémarré lorsque le paramètre
Activer des connexions sécurisées
est modifié, afin que le nouveau paramètre soit appliqué.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 20
Affichage des données d'une rubrique Conteneur par les utilisateurs Web
Lorsque vous publiez une base de données à l'aide d'un moteur de publication Web, les limites suivantes s'appliquent aux données des rubriques Conteneur :
1
Les utilisateurs Web ne peuvent pas modifier ni compléter le contenu des rubriques Conteneur.
Les utilisateurs Web ne peuvent pas utiliser les rubriques Conteneur pour télécharger des objets vers la base de données.
1
Pour les bases de données utilisant une rubrique Conteneur dans laquelle les miniatures sont activées, le moteur de publication Web télécharge l'intégralité du fichier et pas uniquement une miniature.
Scripts FileMaker et Publication Web personnalisée
La fonction Gérer les scripts de FileMaker Pro peut automatiser les tâches fréquentes et combiner plusieurs tâches. Lorsque les scripts FileMaker sont utilisés avec la Publication Web personnalisée, ils permettent aux utilisateurs Web d'exécuter plusieurs tâches ou une série de tâches.
FileMaker prend en charge plus de 65 actions de script dans la publication Web personnalisée.
Les utilisateurs Web peuvent effectuer différentes tâches automatisées lorsque vous utilisez des scripts dans une chaîne de requête pour une URL. Pour visualiser les actions de script non prises en charge, sélectionnez
Publication Web personnalisée
dans la liste
Afficher la compatibilité
de la fenêtre Modifier le script de FileMaker Pro. Les actions de script grisées ne sont pas prises en charge par la publication Web personnalisée. Pour obtenir des informations sur la création de scripts, consultez l'aide FileMaker Pro.
Astuces et considérations à propos des scripts
Bien qu'un grand nombre d'actions de script fonctionnent de manière identique sur le Web,
données, testez tous les scripts qui seront exécutés depuis un navigateur Web. Veillez à vous connecter avec différents comptes d'utilisateur, afin de vous assurer qu'ils fonctionnent comme prévu pour tous les clients. Consultez le fichier journal du moteur de Publication Web (wpe.log) pour rechercher d'éventuelles erreurs liées aux scripts. Pour plus d'informations, consultez la
section « Utilisation du journal du moteur de publication Web », page 46.
Gardez à l'esprit les astuces et considérations suivantes :
1
Utilisez les comptes et les privilèges pour restreindre l'ensemble des scripts pouvant être exécutés par un utilisateur Web. Vérifiez que les scripts contiennent exclusivement des actions compatibles avec le Web et donnent uniquement accès aux scripts pouvant être utilisés depuis un navigateur Web.
1
Pensez aux effets secondaires des scripts qui exécutent une combinaison d'actions contrôlées par des privilèges. Par exemple, si un script comporte une action visant à supprimer des enregistrements et qu'un utilisateur Web ne se connecte pas avec un compte permettant la suppression d'enregistrements, le script n'exécutera pas l'action Supprimer des enregistrements.
L'exécution du script peut néanmoins se poursuivre et mener à des résultats inattendus.
1
Dans la fenêtre de Modifier le script de ScriptMaker, sélectionnez
Exécuter le script avec tous les privilèges d'accès
pour permettre aux scripts d'effectuer des actions auxquelles les utilisateurs individuels n'ont normalement pas accès. Par exemple, vous pouvez empêcher les utilisateurs de supprimer des enregistrements avec leurs comptes et leurs privilèges, tout en leur permettant d'exécuter un script visant à supprimer certains types d'enregistrements dans les conditions définies au sein du script.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 21
1
Si vos scripts comportent des actions non prises en charge, par exemple des actions incompatibles avec le Web, utilisez l'action de script
Autoriser annulation utilisateur
pour déterminer le traitement des actions suivantes.
1
Si l'option d'action de script
Autoriser annulation utilisateur
est activée, les actions de script non prises en charge empêchent la poursuite du script.
1
Si l'option d'action de script
Autoriser annulation utilisateur
est désactivée, les actions de script non prises en charge sont ignorées et l'exécution du script se poursuit.
1
Si cette action de script n'est pas incluse, les scripts sont exécutés comme si la fonctionnalité
était activée, c'est-à-dire que les actions de script non prises en charge interrompent l'exécution du script.
1
Certains scripts fonctionnant avec une action d'un client FileMaker Pro peuvent nécessiter une action
Valider enreg./requêtes
supplémentaire pour permettre l'enregistrement des données sur l'hôte. Comme les utilisateurs Web ne bénéficient pas d'une connexion directe à l'hôte, ils ne sont pas informés des modifications de données. Par exemple, des fonctions telles que les listes de valeurs conditionnelles ne présentent pas la même réactivité pour les utilisateurs Web parce que les données doivent être enregistrées sur l'hôte avant que leurs effets soient visibles dans la rubrique Liste de valeurs.
1
Tout script modifiant des données doit inclure l'action Valider enreg./requêtes, car toutes les modifications de données ne sont pas visibles dans le navigateur tant que les données ne sont pas sauvegardées ou « soumises » au serveur. Ceci inclut plusieurs actions de script telles que
Couper, Copier, Coller, etc. De nombreuses actions de script uniques doivent être converties en script pour inclure l'action Valider enreg./requêtes. Lors de la conception de scripts destinés
à être exécutés depuis un navigateur Web, incorporez l'action Valider enreg./requêtes en fin de script pour garantir l'enregistrement de toutes les modifications.
1
Pour créer des scripts conditionnels basés sur le type de client, utilisez la fonction
Obtenir(VersionApplication). Si la valeur renvoyée comprend « moteur de publication Web », vous savez que l'utilisateur actuel accède à votre base de données à l'aide de la publication
Web personnalisée. Pour plus d’informations sur les fonctions, consultez l'Aide FileMaker Pro.
Chapitre 3 | Préparation des bases de données pour la Publication Web personnalisée 22
Comportement des scripts dans les solutions de Publication Web personnalisée
Les actions de script suivantes ne fonctionnent pas comme dans FileMaker Pro quand elles sont utilisées sur le Web. Pour obtenir des informations sur toutes les actions de script, consultez l'aide
FileMaker Pro.
Action de script
Exécuter script
Comportement dans les solutions de Publication Web personnalisée
Les scripts ne peuvent pas s'exécuter dans d'autres fichiers, sauf quand ces fichiers sont hébergés par
FileMaker Server et que la Publication Web personnalisée est activée dans les autres fichiers.
Déconnecte les utilisateurs Web, ferme les fenêtres mais ne quitte pas le navigateur Web. Quitter application
Autor. annulation utilisateur
Gestion erreurs
Suspendre/reprendre script
Trier enregistrements
Détermine comment les actions de script non prises en charge sont gérées. Activez cette option pour empêcher la poursuite des scripts, ou désactivez-la pour ignorer les actions non prises en charge. Pour
Les utilisateurs Web ne peuvent pas annuler les scripts de Publication Web personnalisée mais cette option permet aux actions de script non prises en charge d'empêcher la poursuite du script.
Toujours activé avec la Publication Web personnalisée. Les utilisateurs Web ne peuvent pas annuler les scripts de Publication Web personnalisée.
Bien que cette action de script soit prise en charge par la Publication Web personnalisée, il faut éviter de l'employer. Lorsqu'une action de script est suspendue, l'exécution du script l'est également. Seul un script contenant l'action de script Reprendre script permet de procéder à une reprise. Si l'exécution du script reste suspendue jusqu'à expiration de la session, le script n'est pas terminé.
Avec l'action de script Trier enregistrements, vous devez enregistrer un ordre de tri à exécuter dans la
Publication Web personnalisée.
Cette action de script n'a aucun effet dans une solution de Publication Web personnalisée.
Ouvrir URL
Activer rubrique Vous ne pouvez pas utiliser l'action de script Activer rubrique pour activer une rubrique donnée dans le navigateur Web, mais vous pouvez l'employer conjointement à d'autres actions de script pour effectuer des opérations. Par exemple, vous pouvez activer une rubrique, copier son contenu, activer une autre rubrique et y coller la valeur. Pour visualiser l'effet dans le navigateur, assurez-vous de sauvegarder l'enregistrement avec l'action de script Valider enregistrement.
Valider enreg./requêtes Soumet les enregistrements à la base de données.
Déclencheurs de scripts et solutions de Publication Web personnalisée
Dans FileMaker Pro, les déclencheurs de scripts peuvent être activés à la fois par des actions de script et des actions de l'utilisateur (clic sur une rubrique par exemple). Cependant, dans la
Publication Web personnalisée, les scripts sont les seuls à pouvoir activer les déclencheurs de script. Pour plus d'informations sur les déclencheurs de script, consultez l'aide FileMaker Pro.
Remarque
Dans FileMaker Pro 13, pour spécifier que vous souhaitez exécuter un script à l'ouverture d'un fichier, vous devez utiliser le déclencheur de script SurOuverturePremiereFenetre.
De même, pour spécifier que vous souhaitez exécuter un script à la fermeture d'un fichier, vous devez utiliser le déclencheur de script SurFermetureDerniereFenetre.
Chapitre 4
Accès aux données XML avec le moteur de
Publication Web
Vous pouvez utiliser et mettre à jour des données FileMaker au format XML (Extensible Markup
Language) à l'aide du moteur de publication Web. De même que HTML est devenu le langage d'affichage standard pour communiquer sur le Web, XML est devenu le langage standard pour l'échange de données structurées. Un grand nombre d'utilisateurs, d'organisations et d'entreprises utilisent le langage XML pour transférer des informations sur les produits, des transactions, des informations sur le stock, ainsi que d'autres données commerciales.
Utilisation de la Publication Web personnalisée avec XML
Si vous connaissez déjà le langage XML standard, vous pouvez immédiatement à utiliser le moteur de publication Web. Vous devez néanmoins apprendre la syntaxe d'URL et connaître les paramètres de requête à employer pour la Publication Web personnalisée avec XML.
Grâce aux requêtes URL HTTP avec les commandes et les paramètres de requête de FileMaker, vous pouvez interroger une base de données hébergée par FileMaker Server et télécharger les données obtenues au format XML. Par exemple, vous pouvez interroger une base de données pour obtenir tous les enregistrements relatifs à un code postal donné, puis employer les données
XML obtenues comme bon vous semble.
Pour plus d'informations, consultez la Base de connaissances FileMaker
(http://help.filemaker.com).
Remarque
Le moteur de Publication Web génère des données XML correctement formatées et conformes à la spécification XML 1.0. Pour plus de détails sur les conditions requises pour le formatage des données XML, reportez-vous aux spécifications XML disponibles à l'adresse http://www.w3.org.
Différences entre le moteur de publication Web et les options d'importation/exportation FileMaker Pro XML
Le moteur de Publication Web et FileMaker Pro permettent tous les deux d'utiliser des données
XML avec des bases de données FileMaker. Cependant, il existe des différences importantes entre ces deux méthodes :
1
Pour accéder aux données XML, le moteur de publication Web prend en charge les grammaires fmresultset, FMPXMLRESULT et FMPXMLLAYOUT. Pour l'importation XML,
FileMaker Pro utilise la grammaire FMPXMLRESULT, et pour l'exportation, il utilise la grammaire
FMPXMLRESULT
. Consultez la section « Accès aux données XML via le moteur de publication
1
Pour accéder aux données XML à l'aide du moteur de publication Web, utilisez une chaîne de requête du moteur de publication Web dans une URL. Pour importer et exporter des données
XML avec FileMaker Pro, utilisez les commandes ou les scripts du menu FileMaker Pro.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 24
1
Le moteur de publication Web est basé sur le serveur et peut être installé sur le même hôte que
FileMaker Server ou sur un hôte différent. L'importation et l'exportation de données XML de
FileMaker Pro se font à partir d'un ordinateur de bureau.
1
Vous pouvez accéder de façon dynamique aux données XML à partir des bases de données
FileMaker en utilisant des requêtes URL avec le moteur de publication Web. La fonction d'exportation de données XML de FileMaker Pro génère un fichier de données XML spécifié à l'avance.
1
Les opérations sur les données XML via un moteur de publication Web sont interactives.
L'importation et l'exportation de données XML de FileMaker Pro se font selon un processus par lot.
1
Contrairement à FileMaker Pro, le moteur de publication Web peut accéder aux données XML
à partir d'une table externe FileMaker.
1
Contrairement à FileMaker Pro, le moteur de publication Web peut accéder aux données d'une rubrique de type Conteneur.
1
Contrairement à FileMaker Pro, le moteur de publication Web fournit un accès en temps réel aux données FileMaker via HTTP ou HTTPS.
Remarque
Pour en savoir plus sur l'utilisation de FileMaker Pro pour effectuer des importations et des exportations de données au format XML, consultez l'Aide FileMaker Pro.
Génération de données XML par le moteur de publication Web à partir d'une requête
Une fois qu'une demande de données XML a été envoyée au serveur Web, le moteur de publication Web interroge la base de données FileMaker et renvoie les données sous forme de document XML.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 25
Navigate ur Web
1. Une requête
HTTP ou HTTPS demandant des données XML est envoyée d'un navigateur Web ou d'un programme à un serveur Web.
Serveur Web
Module de serveur
Web
2. Le serveur Web adresse la requête au noyau de publication
Web.
Moteur de publication
Web FileMaker Server
Noyau de publication
Web
Moteur de Publication
Web personnalisée
(CWPE)
3. Le noyau de publication Web soumet la requête à la base de données hébergée par le serveur de bases de données FileMaker.
FileMaker
Database Server
La demande de données XML est acheminée du navigateur Web ou du programme vers le serveur de bases de données FileMaker.
Products.fmp12
Customers.fmp12
Orders.fmp12
Catalog.fmp12
Les données XML sont renvoyées par le serveur de bases de données FileMaker au navigateur Web ou au programme
Navigateur
Web
6. Le serveur
Web envoie la sortie au programme ou au navigateur
Web.
5. Le noyau de publication
Web convertit les données en XML et les envoie au serveur Web.
Serveur Web
Module de serveur
Web
Moteur de publication
Web FileMaker Server
Noyau de publication
Web
Moteur de Publication
Web personnalisée
(CWPE)
4. Le serveur de bases de données FileMaker envoie les données demandées au noyau de publication Web.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 26
Processus général d'accès aux données XML à partir du moteur de publication Web
Voici un aperçu du processus consistant à employer le moteur de publication Web pour accéder aux données XML dans une base de données FileMaker.
1. Vérifiez si la publication XML est activée dans l'Admin Console de FileMaker Server.
Consultez l'Aide FileMaker Server.
2. Dans FileMaker Pro, ouvrez chaque base de données FileMaker à publier et assurez-vous que pour chacune d'entre elles, le privilège étendu
fmxml
est activé pour la fonction de Publication
Pour accéder aux données XML dans une table externe, définissez l'affichage de modèle de base de données sur
Afficher sous forme de formulaire
ou sur
Afficher sous forme de liste
.
Si un utilisateur ou un script modifie l'affichage du modèle de base de données et le définit sur
Afficher sous forme de tableau
, seul le premier enregistrement (la première rangée de la table externe) est accessible sous forme de données XML.
Les données XML sortent dans un ordre qui correspond à l'ordre dans lequel les objets de la rubrique ont été ajoutés au modèle. Si vous souhaitez que l'ordre des données XML corresponde à l'ordre dans lequel les rubriques apparaissent à l'écran (du haut vers le bas et de la gauche vers la droite), sélectionnez toutes les rubriques, regroupez-les, puis dégroupezles. Cette procédure réinitialise l'ordre du modèle pour le faire correspondre à l'ordre de l'écran.
3. Envoyez une requête HTTP ou HTTPS sous la forme d'une URL qui spécifie la grammaire XML
FileMaker, une commande de requête, puis un ou plusieurs paramètres de requête FileMaker au moteur de publication Web, par l'intermédiaire d'un formulaire HTML, d'un lien HREF ou d'un script dans votre programme ou votre page Web. Vous pouvez également entrer l'URL dans un navigateur Web.
d'informations sur les commandes de requête et sur les paramètres, consultez les sections
« Utilisation de chaînes de requête FileMaker pour rechercher des données XML », page 39,
et annexe A, « Noms corrects utilisés dans les chaînes de requête ».
4. Le moteur de publication Web utilise la grammaire spécifiée dans l'URL et génère les données
XML contenant les résultats de votre requête, par exemple un jeu d'enregistrements de la base de données, puis les renvoie à votre programme ou à votre navigateur Web.
5. S'il est équipé d'un analyseur XML, le navigateur Web affiche les données, ou le programme utilise les données de la façon que vous avez indiquée.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 27
A propos de la syntaxe d'URL pour les données XML et les objets de type Conteneur
Cette section décrit la syntaxe d'URL à utiliser au niveau du moteur de publication Web pour accéder aux données XML et aux objets de type Conteneur à partir de bases de données FileMaker.
A propos de la syntaxe d'URL pour les données XML
La syntaxe d'URL à employer pour utiliser le moteur de publication Web et accéder aux données
XML à partir de bases de données FileMaker est la suivante :
<scheme>://<host>[:<port>]/fmi/xml/<xml_grammar>.xml[?<query string>] où :
1
<scheme>
peut correspondre au protocole HTTP ou HTTPS.
1
<host>
correspond à l'adresse IP ou au nom de domaine de l'hôte sur lequel le serveur Web est installé.
1
<port>
est facultatif et spécifie le port utilisé par le serveur Web. Si aucun port n'est précisé, le port par défaut du protocole est utilisé (port 80 pour HTTP ou port 443 pour HTTPS).
1
<xml_grammar>
est le nom de la grammaire XML FileMaker. Les valeurs possibles sont fmresultset
, FMPXMLRESULT ou FMPXMLLAYOUT. Consultez les rubriques « Utilisation de la
grammaire fmresultset », page 31 et « Utilisation d'autres grammaires XML FileMaker », page 34.
1
<query string>
associe une commande de requête à un ou plusieurs paramètres de requête pour la publication XML FileMaker. (La commande –dbnames ne requiert aucun
paramètre.) Consultez les rubriques « Utilisation de chaînes de requête FileMaker pour
Remarque
La syntaxe d'URL, notamment les noms de commande et de paramètre de requête, applique la distinction majuscules-minuscules, à l'exception des parties de la chaîne de requête.
La majorité des URL sont écrites en minuscules, à l'exception des deux noms de grammaire, qui sont en majuscules : FMPXMLRESULT et FMPXMLLAYOUT. Pour plus d'informations sur les règles de distinction majuscules-minuscules applicables à la chaîne de requête, consultez la section
« Consignes d'utilisation des commandes et des paramètres de requête », page 50.
Voici deux exemples d'URL permettant d'accéder aux données XML via le moteur de publication Web : http://server.company.com/fmi/xml/fmresultset.xml?-db=products&-lay=sales
&-findall http://192.168.123.101/fmi/xml/FMPXMLRESULT.xml?-db=products&-lay=sales
&-findall
A propos de la syntaxe d'URL pour les objets FileMaker de type Conteneur dans les solutions XML
Dans un document XML généré pour une solution XML, la syntaxe à employer pour faire référence à un objet de type Conteneur est différente pour les rubriques de données de Conteneur qui stockent l'objet concerné dans la base de données de celle pour les rubriques de données de
Conteneur qui stockent une référence à l'objet.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 28
Si une rubrique Conteneur stocke l'objet lui-même dans la base de données
L'élément <data> de la rubrique Conteneur utilise la syntaxe d'URL suivante pour faire référence
à l'objet :
<data>/fmi/xml/cnt/data.<extension>?<query string></data> où <extension> est l'extension du nom de fichier qui identifie le type d'objet, par exemple .jpg.
L'extension du nom de fichier définit le type MIME qui permet au navigateur Web d'identifier correctement les données de type Conteneur. Pour plus d'informations concernant <query string>
, consultez la section précédente « A propos de la syntaxe d'URL pour les données XML ».
Par exemple :
<data>/fmi/xml/cnt/data.jpg?-db=products&-lay=sales&-field=product_image(1)
&-recid=2</data>
Remarque
Dans le document XML généré pour une rubrique Conteneur, la valeur du paramètre de requête -field est un nom de rubrique qualifié complet. Le nombre entre parenthèses indique le nombre de répétitions pour la rubrique Conteneur. Il est généré à la fois pour les
Pour extraire les données de conteneur de la base de données, utilisez la syntaxe suivante :
<scheme>://<host>[:<port>]/fmi/xml/cnt/data.<extension>?<query string>
Pour plus d'informations concernant <scheme>, <host> ou <port>, consultez la section
« A propos de la syntaxe d'URL pour les données XML ».
Par exemple : http://www.company.com/fmi/xml/cnt/data.jpg?-db=products&-lay=sales
&-field=product_image(1)&-recid=2
Si une rubrique Conteneur contient une référence à un fichier et non à un objet réel
L'élément <data> de la rubrique Conteneur contient un chemin d'accès relatif faisant référence
à l'objet. Par exemple :
<data>/images/logo.jpg</data>
Remarque
L'objet Conteneur référencé doit ê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 ayant le même emplacement relatif dans le dossier racine du logiciel de serveur Web. Consultez la
section « A propos de la publication du contenu des rubriques Conteneur sur le Web », page 17.
Si une rubrique Conteneur est vide
L'élément <data> de la rubrique est vide.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 29
A propos du codage de texte URL
Les URL utilisées pour accéder aux données XML et aux objets de type Conteneur doivent absolument être codées au format UTF-8 (Unicode Transformation Format 8 bits). Consultez la
section « A propos des données UTF-8 », page 39.
Par exemple, pour définir la valeur de la rubrique « info » à fiancée, vous pouvez utiliser l'URL suivante : http://server.company.com/fmi/xml/fmresultset.xml?-db=members
&-lay=relationships&-recid=2&info= fianc%C3%A9e&-edit
Dans cet exemple d'URL, %C3%A9 est la représentation codée au format UTF-8 du caractère é.
Pour plus d'informations sur le codage de texte URL, consultez les spécifications de l'URL disponible à l'adresse http://www.w3.org.
Accès aux données XML via le moteur de publication Web
Pour accéder aux données XML via le moteur de publication Web, utilisez une URL qui spécifie le nom de la grammaire FileMaker à employer, une commande de requête FileMaker, puis un ou plusieurs paramètres de requête FileMaker. A partir de votre base de données, le moteur de publication Web génère des données XML formatées à l'aide de l'un des types de grammaire suivants :
1
fmresultset : Il s'agit de la grammaire que nous recommandons d'utiliser pour le moteur de publication Web lors de l'accès aux données XML. Elle est flexible et particulièrement adaptée
à un accès par le nom simplifié aux rubriques et à une manipulation plus facile des données relatedset
(table externe). Cette grammaire est également plus étroitement liée à la terminologie et aux fonctionnalités de FileMaker, notamment aux options de stockage de type
Global et à l'identification des rubriques de type Statistique et Calcul. Pour faciliter la publication
Web, cette grammaire se veut plus prolixe que la grammaire FMPXMLRESULT. Consultez la
section « Utilisation de la grammaire fmresultset », page 31.
1
FMPXMLRESULT et FMPXMLLAYOUT : Vous pouvez employer les grammaires
FMPXMLRESULT
et FMPXMLLAYOUT avec le moteur de publication Web pour accéder aux données
XML. Pour utiliser une feuille de style dédiée à l'exportation XML et à la publication Web personnalisée, utilisez la grammaire FMPXMLRESULT. Pour accéder aux listes de valeurs et aux informations d'affichage des rubriques dans des modèles, utilisez la grammaire FMPXMLLAYOUT.
Consultez la section « Utilisation d'autres grammaires XML FileMaker », page 34.
En fonction de la grammaire spécifiée dans la requête de type URL, le moteur de publication Web génère un document XML utilisant l'une des grammaires disponibles. Chaque document XML comporte une déclaration d'espace de nom XML par défaut pour la grammaire. Consultez la
section « A propos des espaces de nom pour le langage XML de FileMaker ». Pour afficher et
manipuler des données FileMaker au format XML, utilisez l'une de ces grammaires dans votre document ou dans votre page Web.
Remarque
Les données XML générées par le moteur de publication Web sont codées au
format UTF-8 (Unicode Transformation Format 8). Consultez la section « A propos des données
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 30
A propos des espaces de nom pour le langage XML de FileMaker
Des espaces de nom XML uniques aident à distinguer les balises XML de l'application à laquelle ils sont destinés. Par exemple, si vos documents XML contiennent deux éléments <DATABASE> destinés respectivement à des données XML FileMaker et à des données XML Oracle, les espaces de nom permettent d'identifier les éléments <DATABASE> pour chacun de ces types de données.
Le moteur de Publication Web génère un espace de nom par défaut pour chaque grammaire.
Pour cette grammaire Cet espace de nom par défaut est généré
fmresultset xmlns="http://www.filemaker.com/xml/fmresultset"
FMPXMLRESULT xmlns="http://www.filemaker.com/fmpxmlresult"
FMPXMLLAYOUT xmlns="http://www.filemaker.com/fmpxmllayout"
A propos des codes d'erreurs des bases de données FileMaker
Accessoirement, le moteur de publication Web renvoie un code d'erreur au début de chaque document XML répertoriant une erreur dans l'exécution de la commande de requête la plus récemment exécutée. La valeur zéro (0) indique qu'il n'y a pas d'erreur.
Pour cette grammaire La syntaxe utilisée est
fmresultset <error code="0"></error>
FMPXMLRESULT
FMPXMLLAYOUT
<ERRORCODE>0</ERRORCODE>
<ERRORCODE>0</ERRORCODE>
L'élément de code d'erreur dans le document XML indique des erreurs relatives à la base de
Récupération des définitions de type de document pour les grammaires FileMaker
Utilisez une requête HTTP pour récupérer les définitions de type de document (DTD) pour les grammaires FileMaker.
Pour cette grammaire Utilisez la requête HTTP suivante
fmresultset http://<host>[:<port]/fmi/xml/fmresultset.dtd
FMPXMLRESULT http://<host>[:<port]/fmi/xml/FMPXMLRESULT.dtd
FMPXMLLAYOUT http://<host>[:<port]/fmi/xml/FMPXMLLAYOUT.dtd
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 31
Utilisation de la grammaire fmresultset
Les noms des éléments XML de cette grammaire utilisent la terminologie FileMaker et le stockage des rubriques est séparé des types de rubrique. La grammaire offre également la possibilité d'identifier les rubriques de type Statistique, Calcul et Global.
Pour utiliser la grammaire fmresultset, indiquez le nom de la grammaire fmresultset dans l'URL qui recherche le document XML à partir du moteur de publication Web : fmresultset.xml
Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-findall
Remarque
Veillez à utiliser des minuscules pour spécifier la grammaire fmresultset.
Le moteur de publication Web génère alors un document XML utilisant la grammaire fmresultset
. Dans le document XML, le moteur de Publication Web fera référence à la définition du type de document pour la grammaire fmresultset dans l'instruction <!DOCTYPE> située sur la deuxième ligne du document, immédiatement après l'instruction <?xml...?>.
L'instruction <!DOCTYPE> indique l'URL à employer pour télécharger la DTD relative à la grammaire fmresultset.
Description des éléments de la grammaire fmresultset
La grammaire fmresultset se compose principalement des éléments <datasource>,
<metadata>
et <resultset>.
élément <datasource>
Dans la grammaire fmresultset, l'élément <datasource> contient les attributs table, layout, date-format, time-format, timestamp-format, total-count et database.
1
L'attribut date-format de l'élément <datasource> indique le format des dates dans le document XML : jj/MM/aaaa où :
1
MM
est la valeur à 2 chiffres relative au mois (de 01 à 12, 01 correspondant au mois de janvier et
12, au mois de décembre)
1
jj
est la valeur à 2 chiffres relative au jour du mois (de 01 à 31)
1
aaaa
est la valeur à 4 chiffres relative à l'année
1
L'attribut time-format de l'élément <datasource> indique le format des heures dans le document XML :
HH:mm:ss où :
1
HH est la valeur à 2 chiffres pour les heures (de 00 à 23 pour le format 24 heures)
1
mm est la valeur à 2 chiffres pour les minutes (de 00 à 59)
1
ss
est la valeur à 2 chiffres pour les secondes (de 00 à 59)
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 32
1
L'attribut timestamp-format de l'élément <datasource> associe les formats de date et d'heure dans un horodatage : jj/MM/aaaa HH:mm:ss
élément <metadata>
L'élément <metadata> de la grammaire fmresultset contient un ou plusieurs éléments
<field-definition>
et <relatedset-definition>, chacun contenant des attributs pour l'une des rubriques de cet ensemble de résultats.
L'attribut <field-definition> définit :
1
si la rubrique est de type auto-enter (yes ou no)
1
si la rubrique est de type four-digit-year (yes ou no)
1
si la rubrique est de type global (yes ou no)
1
le nombre maximal de valeurs multivaluées (attribut max-repeat)
1
le nombre maximal de caractères autorisé (attribut max-characters)
1
si la rubrique est de type not-empty (yes ou no)
1
si la rubrique est réservée aux données numériques (yes ou no)
1
le format du résultat (text, number, date, time, timestamp ou container)
1
si la rubrique est de type time-of-day (yes ou no)
1
le type (normal, calculation ou summary)
1
et le nom de la rubrique (entièrement qualifié si nécessaire)
L'élément <relatedset-definition> correspond à une table externe. Chaque rubrique correspondante dans une table externe est représentée par l'élément <field-definition> intégré à l'élément <relatedset-definition>. Si une table externe possède plusieurs rubriques correspondantes, les définitions des rubriques correspondantes sont regroupées dans un même élément <relatedset-definition>.
élément <resultset>
L'élément <resultset> contient les éléments <record> renvoyés comme étant le résultat d'une requête et d'un attribut pour le nombre total d'enregistrements trouvés. Chaque élément
<record>
contient les données de rubrique pour l'un des enregistrements dans l'ensemble des résultats, y compris les attributs mod-id et record-id de l'enregistrement, et l'élément <data> contenant les données pour l'une des rubriques de l'enregistrement.
Chaque enregistrement d'une table externe est représenté par un élément <record> intégré à l'élément <relatedset>. L'attribut de comptage de l'élément <relatedset> indique le nombre d'enregistrements de la table externe, et l'attribut de table spécifie la table associée à la table externe.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 33
Exemple de données XML dans la grammaire fmresultset
L'exemple ci-dessous représente les données XML générées à l'aide de la grammaire fmresultset
.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE fmresultset PUBLIC "-//FMI//DTD fmresultset//EN"
""http://localhost:80/fmi/xml/fmresultset.dtd">
<fmresultset xmlns="http://www.filemaker.com/xml/fmresultset" version="1.0">
<error code="0" />
<product build="12/31/2014" name="FileMaker Web Publishing Engine" version="0.0.0.0" />
<datasource database="art" date-format="MM/dd/yyyy" layout="web3" table="art" time-format="HH:mm:ss" timestamp-format="MM/dd/yyyy HH:mm:ss" total-count="12" />
<metadata>
<field-definition auto-enter="no" four-digit-year="no" global="no" maxrepeat="1" name="Title" not-empty="no" numeric-only="no" result="text" time-ofday="no" type="normal" />
<field-definition auto-enter="no" four-digit-year="no" global="no" maxrepeat="1" name="Artist" not-empty="no" numeric-only="no" result="text" timeof-day="no" type="normal" />
<relatedset-definition table="artlocations">
<field-definition auto-enter="no" four-digit-year="no" global="no" max-repeat="1" name="artlocations::Location" not-empty="no" numeric-only="no" result="text" time-of-day="no" type="normal" />
<field-definition auto-enter="no" four-digit-year="no" global="no" max-repeat="1" name="artlocations::Date" not-empty="no" numeric-only="no" result="date" time-of-day="no" type="normal" />
</relatedset-definition>
<field-definition auto-enter="no" four-digit-year="no" global="no" max-repeat="1" name="Style" not-empty="no" numeric-only="no" result="text" time-of-day="no" type="normal" />
<field-definition auto-enter="no" four-digit-year="no" global="no" max-repeat="1" name="length" not-empty="no" numeric-only="no" result="number" time-of-day="no" type="calculation" />
</metadata>
<resultset count="1" fetch-size="1">
<record mod-id="6" record-id="14">
<field name="Title">
<data>Spring in Giverny 3</data>
</field>
<field name="Artist">
<data>Claude Monet</data>
</field>
<relatedset count="0" table="artlocations" />
<field name="Style">
<data />
</field>
<field name="length">
<data>19</data>
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 34
</field>
</record>
</resultset>
</fmresultset>
Utilisation d'autres grammaires XML FileMaker
Les autres grammaires XML FileMaker contiennent des informations au sujet des types de rubrique, des listes de valeur et des modèles. FMPXMLRESULT est une grammaire fonctionnellement
équivalente à fmresultset. Pour accéder aux listes de valeurs et aux informations d'affichage des rubriques dans des modèles, utilisez la grammaire FMPXMLLAYOUT. Les grammaires
FMPXMLRESULT
et FMPXMLLAYOUT sont plus compactes pour les échanges de données.
Pour utiliser la grammaire FMPXMLRESULT, indiquez le nom de la grammaire dans l'URL qui recherche le document XML à partir du moteur de publication Web :
FMPXMLRESULT.xml
Par exemple : http://192.168.123.101/fmi/xml/FMPXMLRESULT.xml?-db=employees&-lay=family
&-findall
Pour utiliser la grammaire FMPXMLLAYOUT, indiquez le nom de la grammaire avec la commande de requête –view dans l'URL qui recherche le document XML à partir du moteur de publication
Web :
FMPXMLLAYOUT.xml
Par exemple : http://192.168.123.101/fmi/xml/FMPXMLRESULT.xml?-db=employees&-lay=family
&-view
Remarque
Veillez à entrer le nom des grammaires FMPXMLRESULT et FMPXMLLAYOUT en majuscules.
Dans le document XML généré, le moteur de Publication Web référence la définition du type de document de la grammaire dans l'instruction <!DOCTYPE> située sur la deuxième ligne du document, immédiatement après l'instruction <?xml...?>. L'instruction <!DOCTYPE> indique l'URL à employer pour télécharger la DTD relative à la grammaire.
Description des éléments de la grammaire FMPXMLRESULT
Dans la grammaire FMPXMLRESULT, l'élément <DATABASE> contient les attributs NAME,
RECORDS, DATEFORMAT, LAYOUT et TIMEFORMAT.
L'attribut DATEFORMAT de l'élément <DATABASE> permet de déterminer le format des dates dans le document XML. L'attribut TIMEFORMAT de l'élément <DATABASE> permet de déterminer le format des heures dans le document XML. Les formats date et heure des grammaires
FMPXMLRESULT
et fmresultset sont identiques. Consultez la section « Description des
éléments de la grammaire fmresultset », page 31.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 35
L'élément <METADATA> de la grammaire FMPXMLRESULT comporte un ou plusieurs éléments
<FIELD>
contenant chacun des informations pour l'une des rubriques/colonnes de l'ensemble des résultats, dont le nom de la rubrique définie dans la base de données, le type de rubrique, la tolérance du choix Oui ou Non pour les rubriques vides (attribut EMPTYOK), ainsi que le nombre maximal de rubriques multivaluées (attribut MAXREPEAT). Les valeurs autorisées pour les types de rubriques sont les suivantes : TEXT, NUMBER, DATE, TIME, TIMESTAMP et CONTAINER.
L'élément <RESULTSET> contient tous les éléments <ROW> renvoyés comme étant le résultat d'une requête et d'un attribut pour le nombre total d'enregistrements trouvés. Chaque élément
<ROW>
contient les données de la rubrique/colonne pour l'une des rangées de l'ensemble des
les données pour une rubrique/colonne de la rangée dans laquelle plusieurs éléments <DATA> représentent l'une des valeurs d'une rubrique multivaluée ou d'une rubrique de table externe.
Exemple de données XML dans la grammaire FMPXMLRESULT
L'exemple ci-dessous représente les données XML générées à l'aide de la grammaire
FMPXMLRESULT
.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE FMPXMLRESULT PUBLIC "-//FMI//DTD FMPXMLRESULT//EN"
""http://localhost:80/fmi/xml/FMPXMLRESULT.dtd">
<FMPXMLRESULT xmlns="http://www.filemaker.com/fmpxmlresult">
<ERRORCODE>0</ERRORCODE>
<PRODUCT BUILD="12/31/2014" NAME="FileMaker Web Publishing Engine"
VERSION="0.0.0.0" />
<DATABASE DATEFORMAT="MM/dd/yyyy" LAYOUT="web" NAME="art" RECORDS="12"
TIMEFORMAT="HH:mm:ss" />
<METADATA>
<FIELD EMPTYOK="YES" MAXREPEAT="1" NAME="Title" TYPE="TEXT" />
<FIELD EMPTYOK="YES" MAXREPEAT="1" NAME="Artist" TYPE="TEXT" />
<FIELD EMPTYOK="YES" MAXREPEAT="1" NAME="Image" TYPE="CONTAINER" />
</METADATA>
<RESULTSET FOUND="1">
<ROW MODID="6" RECORDID="15">
<COL>
<DATA>Spring in Giverny 4</DATA>
</COL>
<COL>
<DATA>Claude Monet</DATA>
</COL>
<COL>
<DATA>/fmi/xml/cnt/data.jpg?-db=art&-lay=web&-recid=15&field=Image(1)</DATA>
</COL>
</ROW>
</RESULTSET>
</FMPXMLRESULT>
L'ordre des éléments <COL> correspond à l'ordre des éléments <FIELD> dans l'élément
<METADATA>
: par exemple, si les rubriques « Title » et « Artist » sont répertoriées dans l'élément
<METADATA>
, « Village Market » puis « Camille Pissarro » apparaissent dans le même ordre dans les éléments <RESULTSET> et <ROW>.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 36
Description des éléments dans la grammaire FMPXMLLAYOUT
Dans la grammaire FMPXMLLAYOUT, l'élément<LAYOUT> contient le nom du modèle, le nom de la base de données et les éléments <FIELD> de chaque rubrique figurant dans le modèle correspondant de la base de données. Chaque élément <FIELD> décrit le type de style de la rubrique et contient l'attribut VALUELIST pour toute liste de valeurs associée à la rubrique.
L'élément <VALUELISTS> contient un ou plusieurs éléments <VALUELIST> pour chaque liste de valeurs répertoriée dans le modèle, chacun de ces éléments comportant le nom de la liste de valeurs et un élément <VALUE> pour chaque valeur de la liste.
En fonction des options sélectionnées dans la boîte de dialogue
Rubriques pour la liste de valeurs
de la base de données FileMaker, l'élément <VALUE> dispose d'un attribut DISPLAY qui contient la valeur de la première rubrique uniquement, la valeur de la seconde rubrique uniquement ou les deux rubriques d'une liste de valeurs. Par exemple, supposons que la première rubrique d'une liste de valeurs stocke le numéro d'ID d'un style d'art (par exemple « 100 ») et que la seconde rubrique affiche le nom associé au style au style d'art (par exemple « Impressionism »). Voici un résumé du contenu de l'attribut DISPLAY lorsque les différentes combinaisons d'options sont sélectionnées dans la boîte de dialogue
Rubriques pour la liste de valeurs
:
1
Si l'option
Afficher également les valeurs de la seconde rubrique
n'est pas sélectionnée, l'attribut DISPLAY contient pour valeur dans la première rubrique, d'une liste de valeurs uniquement. Dans l'exemple de données XML suivant, l'attribut DISPLAY contient uniquement le numéro d'ID du style d'art :
<VALUELISTS>
<VALUELIST NAME="style">
<VALUE DISPLAY="100">100</VALUE>
<VALUE DISPLAY="101">101</VALUE>
<VALUE DISPLAY="102">102</VALUE>
</VALUELIST>
</VALUELISTS>
1
Si les options
Afficher également les valeurs de la seconde rubrique
et
Afficher uniquement les valeurs de la seconde rubrique
sont toutes les deux sélectionnées, l'attribut
DISPLAY contient la valeur dans la seconde rubrique uniquement. Dans l'exemple de données
XML suivant, l'attribut DISPLAY contient uniquement le nom du style d'art :
<VALUELISTS>
<VALUELIST NAME="style">
<VALUE DISPLAY="Impressionism">100</VALUE>
<VALUE DISPLAY="Cubism">101</VALUE>
<VALUE DISPLAY="Abstract">102</VALUE>
</VALUELIST>
</VALUELISTS>
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 37
1
Si l'option
Afficher également les valeurs de la seconde rubrique
est sélectionnée et que l'option
Afficher uniquement les valeurs de la seconde rubrique
ne l'est pas, l'attribut DISPLAY contient les valeurs, dans les deux rubriques, d'une liste de valeurs. Dans l'exemple de données
XML suivant, l'attribut DISPLAY contient le numéro d'ID du style d'art, ainsi que son nom :
<VALUELISTS>
<VALUELIST NAME="style">
<VALUE DISPLAY="100 Impressionism">100</VALUE>
<VALUE DISPLAY="101 Cubism">101</VALUE>
<VALUE DISPLAY="102 Abstract">102</VALUE>
</VALUELIST>
</VALUELISTS>
Pour les rubriques de date, d'heure et d'horodatage, les données des listes de valeurs sont formatées à l'aide du format « fm » pour ce type de rubrique. Les formats « fm » sont jj/MM/aaaa
pour la date, HH:mm:ss pour l'heure et jj/MM/aaaa HH:mm:ss pour l'horodatage. Par exemple, si une liste de valeur « birthdays » est utilisée pour un menu local dans la rubrique « birthdate » d'un modèle et que la rubrique « birthdate » est de type date, alors les valeurs résultantes pour cette liste de valeurs seront toutes au format de date « fm ».
Remarque
Si deux rubriques de types différents dans un modèle partagent la même liste de valeurs, le type de la première rubrique détermine le format des données de la liste de valeurs.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web
Exemple de données XML dans la grammaire FMPXMLLAYOUT
L'exemple ci-dessous représente les données XML générées à l'aide de la grammaire
FMPXMLLAYOUT
.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE FMPXMLLAYOUT PUBLIC "-//FMI//DTD FMPXMLLAYOUT//EN"
""http://localhost:80/fmi/xml/FMPXMLLAYOUT.dtd">
<FMPXMLLAYOUT xmlns="http://www.filemaker.com/fmpxmllayout">
<ERRORCODE>0</ERRORCODE>
<PRODUCT BUILD="12/31/2014" NAME="FileMaker Web Publishing Engine"
VERSION="0.0.0.0" />
<LAYOUT DATABASE="art" NAME="web2">
<FIELD NAME="Title">
<STYLE TYPE="EDITTEXT" VALUELIST="" />
</FIELD>
<FIELD NAME="Artist">
<STYLE TYPE="EDITTEXT" VALUELIST="" />
</FIELD>
<FIELD NAME="Image">
<STYLE TYPE="EDITTEXT" VALUELIST="" />
</FIELD>
<FIELD NAME="artlocations::Location">
<STYLE TYPE="EDITTEXT" VALUELIST="" />
</FIELD>
<FIELD NAME="artlocations::Date">
<STYLE TYPE="EDITTEXT" VALUELIST="" />
</FIELD>
<FIELD NAME="Style">
<STYLE TYPE="POPUPMENU" VALUELIST="style" />
</FIELD>
</LAYOUT>
<VALUELISTS>
<VALUELIST NAME="style">
<VALUE DISPLAY="Impressionism">100</VALUE>
<VALUE DISPLAY="Cubism">101</VALUE>
<VALUE DISPLAY="Abstract">102</VALUE>
</VALUELIST>
</VALUELISTS>
</FMPXMLLAYOUT>
38
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 39
A propos des données UTF-8
Les données XML générées par le moteur de publication Web sont codées au format UTF-8
(Unicode Transformation Format 8 bits). Ce format compresse les données du format
Unicode standard 16 bits au format 8 bits pour les caractères ASCII. Les analyseurs
XML sont nécessaires à la prise en charge des codages Unicode et UTF-8.
Le codage au format UTF-8 comprend les représentations directes de la plupart des caractères utilisés en anglais, avec les valeurs 0 à 127 pour le jeu de caractères ASCII standard, et fournit des codages multi-octets pour les caractères Unicode dont les valeurs sont supérieures.
Remarque
Veillez à utiliser un navigateur Web ou un éditeur de texte prenant en charge les fichiers UTF-8.
Le format du codage UTF-8 présente les caractéristiques suivantes :
1
Tous les caractères ASCII correspondent à des caractères UTF-8 d'un octet. Une chaîne ASCII valide est une chaîne UTF-8 valide.
1
Tout caractère non ASCII (tout caractère dont le bit de poids fort est défini) fait partie d'un caractère multi-octet.
1
Le premier octet d'un caractère au format UTF-8 indique le nombre d'octets supplémentaires dans le caractère en question.
1
Le premier octet d'un caractère multi-octet est facilement identifiable par rapport aux octets suivants. Il est ainsi facile de repérer le début d'un caractère quel que soit son emplacement dans un flux de données.
1
La conversion entre le format UTF-8 et le format Unicode ne pose aucun problème.
1
Le codage au format UTF-8 est relativement compact. Dans le cas d'un texte contenant un pourcentage élevé de caractères ASCII, ce type de codage est plus compact que le codage au format Unicode. Dans le pire des cas, une chaîne UTF-8 n'est que 50 % plus grande que la chaîne Unicode équivalente.
Utilisation de chaînes de requête FileMaker pour rechercher des données XML
Pour rechercher des données XML dans une base de données FileMaker, utilisez les commandes et les paramètres de requête dans une chaîne de requête. Par exemple, utilisez la commande de requête –findall dans la chaîne de requête suivante d'une URL pour demander une liste de tous les produits d'une base de données FileMaker dont le nom est « products ».
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=products-lay=sales&-findall
Une chaîne de requête doit contenir uniquement une seule commande de requête, du type –new.
La plupart des commandes de requête exigent également plusieurs paramètres de requête concordants dans la chaîne de requête. Par exemple, toutes les commandes de requête, à l'exception de –dbnames, ont besoin du paramètre –db, qui spécifie la base de données sur laquelle effectuer la recherche.
Vous pouvez également utiliser des commandes et des paramètres de requête dans une URL.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 40
Utilisez cette commande de requête
–dbnames
–delete
–dup
–edit
–find
–findall
–findany
–findquery
–layoutnames
–view
Cette section contient un récapitulatif des commandes et des paramètres de requête de
FileMaker. Pour plus d'informations sur leur utilisation dans une chaîne de requête, consultez la
section « Noms corrects utilisés dans les chaînes de requête », page 49.
–new
–scriptnames
Pour exécuter cette commande
Extraire le nom de toutes les bases de données hébergées et partagées sur le Web.
Supprimer l'enregistrement.
Dupliquer l'enregistrement.
Modifier un enregistrement.
Rechercher des enregistrements.
Rechercher tous les enregistrements.
Rechercher un enregistrement aléatoire.
Accomplir une requête de recherche complexe ou composée.
Extraire le nom de tous les modèles disponibles correspondant à une base de données spécifique, hébergée et partagée sur le Web.
Ajouter un nouvel enregistrement.
Extraire le nom de tous les scripts disponibles correspondant à une base de données spécifique, hébergée et partagée sur le Web.
Extraire les informations du modèle d'une base de données si la grammaire
FMPXMLLAYOUT
est spécifiée. Extraire la section de <metadata> du document
XML et un jeu d'enregistrements vides si la grammaire fmresultset ou
FMPXMLRESULT
est spécifiée.
Utilisez ce paramètre de requête Avec ces commandes de requête
–db (nom de la base de données)
Obligatoire pour toutes les commandes de requête, à l'exception de –dbnames
–delete.related
–field
Facultatif pour –edit
Obligatoire pour indiquer une rubrique dans une URL pour les requêtes de type
Conteneur. Consultez la section « A propos de la syntaxe d'URL pour les objets
FileMaker de type Conteneur dans les solutions XML », page 27.
fieldname fieldname.op (opérateur)
–lay (nom du modèle)
–lay.response
–lop
(passer à un modèle pour obtenir une réponse XML)
(opérateur logique)
–max
(nombre maximal d'enregistrements)
–modid
(ID de modification)
Un nom de rubrique au moins est obligatoire avec –edit. Facultatif pour –find.
Consultez la section « Paramètre de requête fieldname (nom de rubrique non-
Facultatif pour –find
Obligatoire pour toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames
Obligatoire pour toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames
Facultatif pour –find
Facultatif pour –find, –findall et –findquery
–query
–recid
(ID de l'enregistrement)
–relatedsets.filter
–relatedsets.max
Facultatif pour –edit
Obligatoire pour les requêtes de recherche composée -findquery
Obligatoire pour –edit, –delete, –dup. Facultatif pour –find
Facultatif pour –find, –findall, –findany, –edit, –new, –dup et –findquery
Facultatif avec –find, –edit, –new, –dup et –findquery.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 41
Utilisez ce paramètre de requête
–script
(exécution du script)
–script.param
(transmettre une valeur de paramètre au script spécifié par
–script
)
–script.prefind
(exécution du script avant –find, –findany et –findall)
–script.prefind.param
(transmettre une valeur de paramètre au script spécifié par –script.prefind)
–script.presort
(exécuter le script avant le tri)
–script.presort.param
(transmettre une valeur de paramètre au script spécifié par –script.presort)
–skip
(ignorer les enregistrements)
–sortfield.[1-9]
(trier la rubrique)
–sortorder.[1-9]
(trier l'ordre)
Avec ces commandes de requête
Facultatif pour –find, –findall, –findany, –new, –edit, –delete, –dup,
–view
et –findquery
Facultatif pour –script et –findquery
Facultatif pour –find, –findany, –findall et –findquery
Facultatif pour –script.prefind et –findquery
Facultatif pour –find, –findall et –findquery
Facultatif pour –script.presort et –findquery
Facultatif pour –find, –findall et –findquery
Facultatif pour –find, –findall et –findquery
Facultatif pour –find, –findall
Passage d'un modèle à un autre pour obtenir une réponse XML
Le paramètre de requête –lay indique le modèle à utiliser pour extraire des données XML.
Souvent, le même modèle se révèle adapté au traitement des données répertoriées dans la requête. Dans certains cas, vous devrez rechercher les données qui utilisent un modèle contenant des rubriques qui, pour des raisons de sécurité, n'existent dans aucun autre modèle servant à l'affichage des résultats (pour rechercher des données dans une rubrique, il faut que celle-ci soit placée dans le modèle indiqué dans la requête XML).
Pour définir un modèle destiné à l'affichage des réponses XML qui soit différent du modèle utilisé pour le traitement de la requête XML, utilisez le paramètre de requête facultatif –lay.response.
Par exemple, la requête suivante recherche les valeurs supérieures à 100 000 dans la rubrique
« Salary » du modèle « Budget ». Les données obtenues s'affichent via le modèle « ExecList », qui n'inclut pas la rubrique « Salary ». http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=Budget&Salary=100000&Salary.op=gt&-find&-lay.response=ExecList
Comprendre le traitement d'une requête XML
Plusieurs paramètres de requête interviennent dans le traitement d'une requête XML et dans la génération d'un document XML.
Voici l'ordre dans lequel FileMaker Server et le moteur de publication Web traitent une requête XML :
1. Traitez le paramètre de requête –lay.
2. Définissez les valeurs des rubriques de type Global dans la requête (la partie .global= d'une URL).
3. Traitez le paramètre de requête –script.prefind si indiqué.
4. Traitez les commandes de requête de type –find ou –new.
Chapitre 4 | Accès aux données XML avec le moteur de Publication Web 42
5. Traitez le paramètre de requête –script.presort, si indiqué.
6. Triez les données obtenues, si un tri a été indiqué.
7. Traitez le paramètre de requête –script, si indiqué.
8. Traitez le paramètre de requête –lay.response pour passer d'un modèle à un autre, si indiqué.
9. Générez le document XML.
Si l'une des étapes décrites ci-dessus génère un code d'erreur, le traitement de la requête s'arrête ; les étapes suivantes ne sont alors pas exécutées. Toutefois, toutes les étapes antérieures dans la requête restent exécutées.
Par exemple, imaginons une requête qui supprime l'enregistrement ouvert, trie les enregistrements, puis exécute un script. Si le paramètre –sortfield pointe vers une rubrique qui n'existe pas, la requête supprime l'enregistrement ouvert et renvoie le code d'erreur 102 (« Rubrique manquante »), mais n'exécute cependant pas le script.
Dépannage de l'accès aux documents XML
Si vous rencontrez des difficultés pour accéder aux documents XML avec le moteur de publication
Web, vérifiez les points suivants :
1
Les privilèges étendus contenus dans la base de données sont définis pour une Publication
Web personnalisée pour XML et affectés à un compte utilisateur. Consultez la section
« Activation de la Publication Web personnalisée dans une base de données », page 14.
1
La base de données est hébergée sur le composant Serveur de bases de données de
FileMaker Server, et elle est ouverte par FileMaker Server. Consultez l'Aide 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 XML est activée dans le moteur de publication Web. Consultez l'Aide
FileMaker Server.
Chapitre 5
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 :
2. Assurez-vous que XML a été activé et correctement paramétré dans l'Admin Console de
FileMaker Server.
Remarque
Vous trouverez des instructions dans l'Aide FileMaker Server.
3. Vérifiez le bon fonctionnement du serveur Web et du moteur de publication Web.
4. Copiez ou déplacez les éventuels objets Conteneur référencés sur la machine contenant le 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
Lorsque vous utilisez FileMaker Pro pour télécharger une base de données, les données de la rubrique Conteneur stockées en externe sont téléchargées vers FileMaker Server dans le cadre du processus. Pour plus d'informations sur le transfert de fichiers de base de données vers FileMaker Server, consultez l'Aide FileMaker Pro.
1
Lorsque vous téléchargez manuellement une base de données utilisant une rubrique
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 18.
5. Copiez les composants supplémentaires de votre application Web sur la machine hébergeant le serveur Web. Votre application Web traite les données XML avant de les envoyer vers une autre application ou au client.
Chapitre 5 | Stockage, test et suivi d'un site 44
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érifier 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 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 20 pour obtenir des
informations sur la conception de scripts adaptés au Web.
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 en choisissant un déploiement sur une seule machine (le serveur Web, le moteur de publication Web et le serveur de bases de données se trouvant sur un même ordinateur), vous pouvez tester votre site de Publication Web personnalisée en utilisant http://127.0.0.1/ dans
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>
Chapitre 5 | Stockage, test et suivi d'un site 45
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.
<?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>
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 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
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.
Apache (OS X) : 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.
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 5 | Stockage, test et suivi d'un site 46
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.
Le fichier wpe.log se trouve sur le composant Moteur de publication Web du déploiement
FileMaker Server :
1
IIS (Windows) : [drive]:\Program Files\FileMaker\FileMaker
Server\HTTPServer\logs\wpe.log
où [drive] correspond au lecteur principal servant au démarrage de votre système.
1
Apache (OS X) : /Bibliothèque/FileMaker Server/HTTPServer/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
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 FileMaker Server.
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] 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.
Chapitre 5 | Stockage, test et suivi d'un site 47
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
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
02/06/2014 15:15:31 -0700 - - - - INFO - - Le moteur de publication Web de FileMaker Server a commencé.
02/06/2014 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é
02/06/2014 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"
02/06/2014 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
02/06/2014 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
09/06/2014 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
02/06/2014 15:30:42 -0700 WPC_SERVER 192.168.100.101:0 jdoe XML
ERROR - - La communication a échoué
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.
Chapitre 5 | Stockage, test et suivi d'un site 48
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) : [drive]:\Program Files\FileMaker\FileMaker Server\
Admin\admin-master-tomcat\logs\ où [drive] correspond au lecteur principal servant au démarrage de votre système.
1
Apache (OS X) : /Bibliothèque/FileMaker Server/Admin/ admin-master-tomcat/logs/
Annexe A
Noms corrects utilisés dans les chaînes de requête
Cette annexe décrit les noms valides des commandes et des paramètres de requête que vous pouvez utiliser dans une chaîne de requête lorsque vous accédez à des données FileMaker à l'aide du moteur de publication Web.
A propos des commandes et des paramètres de requête
Voici une liste complète des noms de commandes de requête et des noms de paramètres de requête :
Noms des commandes de requête
–dbnames
–delete
–dup
–edit
–find
, –findall, –findany (Voir , page 56.)
–findquery
–layoutnames
–new
–scriptnames
–view
Noms des paramètres de requête
–db
–field
fieldname
fieldname.op
–lay
–lay.response
–lop
–max
–modid
–query
–recid
–relatedsets.filter
–relatedsets.max
–script
–script.param
–script.prefind
–script.prefind.param
–script.presort
–script.presort.param
–skip
–sortfield.[1-9]
–sortorder.[1-9]
Important
Le paramètre –lay servant à spécifier un modèle est nécessaire avec toutes les commandes de requête, à l'exception de –dbnames, –layoutnames et –scriptnames.
Annexe A | Noms corrects utilisés dans les chaînes de requête 50
Consignes d'utilisation des commandes et des paramètres de requête
Lorsque vous utilisez des commandes et des paramètres de requête dans une chaîne de requête, gardez les consignes suivantes à l'esprit :
1
Une chaîne de requête doit contenir une seule commande de requête, ni plus, ni moins. Une chaîne de requête peut par exemple contenir –new pour ajouter un nouvel enregistrement, mais –new et –edit ne peuvent être contenus dans la même chaîne de requête.
1
La majorité des commandes de requête nécessitent divers paramètres de requêtes correspondants dans la chaîne de requête. Par exemple, toutes les commandes de requête, à l'exception de –dbnames, ont besoin du paramètre –db, qui spécifie la base de données sur laquelle effectuer la recherche. Consultez le tableau des paramètres requis dans la section
« Utilisation de chaînes de requête FileMaker pour rechercher des données XML », page 39.
1
Pour les paramètres de requête et les noms de rubrique, indiquez la valeur particulière que vous souhaitez utiliser, par exemple -db=employees. Pour les commandes de requête, n'indiquez pas le signe = ou une valeur après le nom de la commande, par exemple –findall.
1
Le moteur de publication Web convertit tous les mots réservés en minuscules, notamment les commandes de requête, les paramètres de requête et les valeurs de commande pour lesquelles des valeurs spécifiques sont attendues (par exemple : –lop=and, –lop=or,
–sortorder=ascend
, –sortorder=descend, –max=all).
1
Les noms de bases de données, de modèles et de rubriques utilisés dans les chaînes de requête ne tiennent pas compte de la casse, vous pouvez par exemple indiquer
–lay=mylayout
pour spécifier le nom de modèle MyLayout.
1
Il est déconseillé d'utiliser des points ou des parenthèses dans les noms de rubrique. Dans certains cas, les noms de rubrique comportant des points peuvent fonctionner mais en aucun cas, ils ne peuvent contenir les exceptions suivantes :
1
Le point ne peut pas être suivi d'un chiffre. Par exemple, myfield.9 est un nom de rubrique invalide.
1
Le point ne peut pas être suivi de la chaîne de texte op (les deux lettres « op »).
Par exemple, myfield.op est un nom de rubrique invalide.
1
Le point ne peut pas être suivi de la chaîne de texte global (le mot « global »).
Par exemple, myfield.global est un nom de fichier invalide.
Les noms de rubrique contenant l’une de ces exceptions ne sont pas accessibles via
XML lorsque vous utilisez une requête HTTP. Ces constructions sont destinées aux
1
Pour la commande –find, la valeur d'une rubrique ne tient pas compte de la casse. Par exemple, vous pouvez aussi bien écrire Field1=Blue que Field1=blue. Pour les commandes –new and –edit, la casse que vous utilisez dans la valeur d'une rubrique est conservée et stockée dans la base de données exactement comme vous la spécifiez dans la chaîne de requête. Par exemple, LastName=Doe.
Annexe A | Noms corrects utilisés dans les chaînes de requête 51
Analyse de commande de requête
Le moteur de publication Web analyse les commandes de requête dans l'ordre suivant, et arrête d'analyser les requêtes XML à la première erreur. Si un code d'erreur est renvoyé, ce dernier correspond à la première erreur détectée.
1. La requête contient-elle une commande, et cette commande est-elle valide ?
Il s'agit d'une erreur si la requête ne contient pas de commande ou utilise une commande inconnue. Par exemple : -database
2. La requête comporte-t-elle deux commandes ?
Par exemple : -find&-edit
3. La requête comporte une valeur incorrecte pour une commande ou un paramètre ?
Par exemple : -lop=amd
4. Le paramètre de nom de base de données requis (–db parameter) manque t-il dans la requête ?
5. Le paramètre de nom de modèle requis (–lay parameter) manque t-il dans la requête ?
6. La requête comporte-t-elle un tri non valide ?
7. La requête contient-elle des paramètres de rubrique non valides ?
Remarque
Si une requête contient une information valide, mais superflue, elle est traitée sans erreur. Par exemple, si vous spécifiez le paramètre –lop dans une commande –delete, ce paramètre –lop est ignoré, car il ne rend pas la requête non valide ou ambigüe.
Pour plus d'informations sur les codes d'erreur spécifiques renvoyés, consultez la section
annexe B, « Codes d'erreur de la publication Web personnalisée ».
A propos de la syntaxe d'un nom de rubrique entièrement qualifié
Un nom de rubrique entièrement qualifié identifie une instance précise d'une rubrique. Dans la mesure où les rubriques possédant des noms communs peuvent être basées sur différentes tables, vous devez utiliser des noms entièrement qualifiés, dans certains cas, pour éviter les erreurs.
La syntaxe permettant de spécifier un nom de rubrique entièrement qualifié est la suivante : table-name::field-name(repetition-number).record-id où :
1
table-name
est le nom de la table qui contient la rubrique. Le nom de la table est uniquement requis si la rubrique ne se trouve pas dans la table sous-jacente du modèle spécifié dans la chaîne de requête.
Annexe A | Noms corrects utilisés dans les chaînes de requête 52
1
field-name(repetition-number)
, qui est une valeur spécifique dans une rubrique multivaluée, est uniquement requis pour les rubriques multivaluées. Le nombre de répétitions commence à compter à partir du chiffre 1. Par exemple, field-name(2) correspond à la seconde valeur dans la rubrique multivaluées. Si vous n'indiquez pas de numéro de valeur pour une rubrique multivaluée, c'est la première valeur qui est utilisée. Le numéro de valeur est requis pour les commandes de requête –new and –edit impliquant des rubriques multivaluées, mais n'est pas requis pour la commande –find.
1
record-id
est l'ID de l'enregistrement, qui est uniquement requis si vous utilisez une chaîne de requête pour ajouter ou modifier des enregistrements dans des rubriques de table externe.
commandes de requête –new et –edit impliquant des rubriques de table externe, mais n'est pas requis pour la commande –find.
Remarque
Pour être accessibles, les rubriques doivent être placées dans le modèle que vous spécifiez dans la chaîne de requête.
Utilisation de commandes de requêtes avec des rubriques de table externe
Les sections suivantes décrivent le fonctionnement des commandes de requêtes avec des rubriques de table externe.
Ajout d'enregistrements à une table externe
Pour ajouter un nouvel enregistrement à une table externe en même temps qu'un enregistrement parent, utilisez la commande de requête –new et effectuez les opérations suivantes dans une chaîne de requête :
1
Utilisez le nom de rubrique entièrement qualifié pour la rubrique de table externe correspondante.
1
Spécifiez 0 en guise d'ID d'enregistrement après le nom de la rubrique de table externe liée.
1
Spécifiez au moins une des rubriques pour l'enregistrement parent, avant de spécifier la rubrique de table externe liée.
1
Spécifiez les données pour la rubrique source (rubrique clé) dans l'enregistrement parent.
Par exemple, l'URL suivant ajoute simultanément un nouvel enregistrement Employee parent pour John Doe, et un nouvel enregistrement lié pour Jane dans la table externe. Le nom de la table liée est Dependents et le nom de la rubrique liée dans la table externe est Names. La rubrique source ID stocke un numéro d'identification de type Employee. http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=family&FirstName=John&LastName=Doe&ID=9756&Dependents::Names.0=Jane&-new
Remarque
Vous ne pouvez ajouter qu'un enregistrement correspondant à une table externe par requête.
Annexe A | Noms corrects utilisés dans les chaînes de requête 53
Modification d'enregistrements dans une table externe
Pour modifier un ou plusieurs enregistrements dans une table externe, utilisez la commande
–edit
et un ID d'enregistrement pour spécifier l'enregistrement parent qui contient les enregistrements de table externe que vous souhaitez modifier. Spécifiez l'enregistrement de table externe spécifique à modifier en utilisant son ID d'enregistrement dans un nom de rubrique entièrement qualifié. Vous pouvez déterminer un ID d'enregistrement à partir de l'attribut d'ID d'enregistrement de l'élément <record> dans l'élément <relatedset> dans les données XML.
Consultez la section « Utilisation de la grammaire fmresultset », page 31.
Par exemple, l'URL suivante modifie un enregistrement d'une table externe dans laquelle l'enregistrement parent affiche l'ID d'enregistrement 1001. « Dependents » est le nom de la table liée, « Names » est le nom de la rubrique liée dans la table externe et le chiffre 2 dans
« Names.2 » est l'ID d'enregistrement d'un enregistrement de table externe. http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-recid=1001&Dependents::Names.2=Kevin&-edit
Voici un exemple illustrant comment utiliser une seule requête pour modifier plusieurs enregistrements de table externe par le biais de l'enregistrement parent : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-recid=1001&Dependents::Names.2=Kevin&Dependents::Names.5=Susan&-edit
Vous pouvez également utiliser la commande –edit et spécifier 0 en guise d'ID d'enregistrement de table externe pour ajouter un nouvel enregistrement lié dans la table externe pour un enregistrement parent existant. Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-recid=1001&Dependents::Names.0=Timothy&-edit
Suppression d’enregistrements dans une table externe
Pour supprimer des enregistrements dans une table externe, utilisez le paramètre
–delete.related
avec la commande –edit au lieu d'employer la commande –delete.
Par exemple, l’URL suivante supprime l’enregistrement « 1001 » de la table « employés » : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-recid=1001&-delete
En revanche, l'URL suivante supprime l'enregistrement d'une table externe dont l'ID d'enregistrement est « 3 » dans la table liée nommée « Dependents » et dont l'ID d'enregistrement parent est « 1001 ». http://192.168.123.101/fmi/xml/fmresultset.xml?
db=employees&-lay=family
&-recid=1001&-delete.related=Dependents.3&-edit
Pour plus d'informations, consultez la section « Paramètre de requête –delete.related
(suppression d'enregistrements externes), », page 59.
Annexe A | Noms corrects utilisés dans les chaînes de requête 54
Requêtes de rubriques de table externe
Dans une solution comportant de nombreux enregistrements liés, l'interrogation et le tri des enregistrements externes peuvent demander beaucoup de temps. Pour limiter le nombre d'enregistrements et de lignes à afficher dans un ensemble lié, utilisez les paramètres
–relatedsets.filter
et –relatedsets.max avec les requêtes de recherche. Pour plus
d'informations, consultez les sections « Paramètre de requête –relatedsets.filter (filtrage
d'enregistrements de table externe) », page 64 et « Paramètre de requête –relatedsets.max
(limitation d'enregistrements de table externe) », page 65.
A propos de la syntaxe de spécification d'une rubrique de type Global
La syntaxe de spécification d'une rubrique de type Global est la suivante : table-name::field-name(repetition-number).global
où global identifie une rubrique utilisant le stockage global. Pour plus d'informations sur tablename
de type Global, consultez l'Aide FileMaker Pro.
Vous devez utiliser la syntaxe .global pour identifier une rubrique de type Global dans une chaîne de requête. Le moteur de publication Web définit les valeurs de paramètres pour les rubriques de type Global avant d'exécuter la commande de requête ou de définir toute autre valeur de paramètre dans la chaîne de requête. Pour les requêtes XML directes, les valeurs globales expirent immédiatement une fois la requête lancée.
Si vous n'utilisez pas la syntaxe .global pour identifier une rubrique de type Global dans une chaîne de requête, le moteur de publication Web traite la rubrique de type Global avec le reste de la chaîne de requête, sans définir la valeur de la rubrique de type Global au préalable.
Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=departments
&Country.global=USA&-recid=1&-edit
Annexe A | Noms corrects utilisés dans les chaînes de requête 55
Références des commandes de requête
Cette section contient des informations sur des commandes de requête disponibles pour les requêtes XML.
Commande de requête –dbnames (noms des bases de données)
Extrait le nom de toutes les bases de données hébergées par FileMaker Server et activées pour la Publication Web personnalisée avec XML.
Paramètres de requête indispensables : (aucun)
Par exemple :
Pour extraire les noms de bases de données : http://192.168.123.101/fmi/xml/fmresultset.xml?-dbnames
Commande de requête –delete (supprimer l'enregistrement)
Supprime l'enregistrement indiqué par le paramètre –recid.
Paramètres de requête indispensables : –db, –lay, –recid
Paramètres de requête facultatifs : –script
Par exemple :
Pour supprimer un enregistrement : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-recid=4&-delete
Commande de requête –dup (dupliquer l'enregistrement)
Duplique l'enregistrement spécifié par –recid.
Paramètres de requête indispensables : –db, –lay, –recid
Paramètres de requête facultatifs : –script
Par exemple :
Pour dupliquer l'enregistrement spécifié : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-recid=14&-dup
Commande de requête –edit (modifier l'enregistrement)
Met à jour l'enregistrement indiqué par le paramètre –recid et renseigne les rubriques avec le contenu de n'importe quelle paire nom rubrique/valeur. Le paramètre –recid indique le nom de l'enregistrement qui doit être modifié.
Paramètres de requête indispensables : –db, –lay, –recid et un ou plusieurs noms de rubriques
Paramètres de requête facultatifs : –modid, –script, nom de rubrique
Remarque
Pour plus d'informations sur la modification d'enregistrements dans une table
externe, consultez la section « Modification d'enregistrements dans une table externe », page 53.
Annexe A | Noms corrects utilisés dans les chaînes de requête 56
Par exemple :
Pour modifier un enregistrement : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-recid=13&Country=USA&-edit
Commandes de requête –find, –findall ou –findany (rechercher les enregistrements)
Soumet une requête utilisant des critères de recherche spécifiques.
Paramètres de requête indispensables : –db, –lay
Paramètres de requête facultatifs : –recid, –lop, –op, –max, –skip, –sortorder,
–sortfield
, –script, –script.prefind, –script.presort, field name
Exemples :
Pour chercher un enregistrement par son nom de rubrique : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=family&Country=USA&-find
Remarque
Le fait de spécifier un nom de rubrique à plusieurs reprises dans une même requête n'est pas pris en charge ; FileMaker Server analyse toutes les valeurs mais utilise uniquement la dernière valeur analysée.
Pour chercher un enregistrement par son ID d'enregistrement : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-recid=427&-find
Pour chercher tous les enregistrements de la base de données, utilisez –findall : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-findall
Pour chercher un enregistrement de façon aléatoire, utilisez –findany : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-lay=family
&-findany
Commande de requête –findquery (recherche composée)
Soumet une requête de recherche avec des critères de recherche multiples ainsi que des exceptions.
Paramètres de requête indispensables : –db, –lay, –query
Paramètres de requête facultatifs : –max, –skip, –sortorder, –sortfield, –script,
–script.prefind
, –script.presort
Par exemple :
Rechercher les enregistrements des chats ou des chiens qui ne s'appellent pas « Fluffy ». http://host/fmi/xml/fmresultset.xml?-db=vetclinic&-lay=animals
&-query=(q1);(q2);!(q3)&-q1=typeofanimal&-q1.value=Cat&-q2=typeofanimal
&-q2.value=Dog&-q3=name&-q3.value=Fluffy&-findquery
Annexe A | Noms corrects utilisés dans les chaînes de requête 57
Utilisation de la commande -findquery pour les recherches composées
Une instruction –findquery se compose de quatre parties, dans l'ordre suivant :
1
Le paramètre de requête –query
1
Les déclarations de demande de requête, composées de l'identificateur de requête et des opérations de demande.
1
Le champ de recherche et les définitions de valeur pour chaque identificateur de requête.
1
Définissez les identifiants de requête. Un identificateur de requête est représenté par la lettre
« q » suivie d'un nombre. Par exemple : -q1
1
Définissez les valeurs d'identifiant avec le paramètre. Par exemple : q1.value=fieldvalue
1
Définissez les opérateurs d'identifiant de requête en l'incluant en tant que partie de l'expression fieldvalue. Par exemple, utilisez un astérisque comme opérateur
« begins with » : -q1.value=fieldvalue*
1
La commande –findquery, à la fin de l'instruction complète.
Commande de requête –layoutnames (noms des modèles)
Extrait le nom de tous les modèles disponibles pour une base de données spécifique, hébergée par FileMaker Server et activée pour la Publication Web personnalisée avec XML.
Paramètres de requête indispensables : –db
Par exemple :
Pour extraire les noms des modèles disponibles : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-layoutnames
Commande de requête –new (nouvel enregistrement)
Crée un nouvel enregistrement et renseigne cet enregistrement avec le contenu de n'importe quelle paire nom/valeur d'une rubrique.
Paramètres de requête indispensables : –db, –lay
Paramètre de requête facultatif : un ou plusieurs noms de rubriques, –script
Remarque
Pour plus d'informations sur la manière d'inclure de nouvelles données dans une
table externe, consultez la section « Ajout d'enregistrements à une table externe », page 52.
Par exemple :
Pour ajouter un nouvel enregistrement : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&Country=Australia&-new
Annexe A | Noms corrects utilisés dans les chaînes de requête 58
Commande de requête –scriptnames (noms des scripts)
Extrait le nom de tous les scripts disponibles pour une base de données spécifique, hébergée par FileMaker Server et activée pour la Publication Web personnalisée avec XML.
Paramètres de requête indispensables : –db
Par exemple :
Pour extraire les noms de tous les scripts : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees&-scriptnames
Commande de requête –view (affichage des informations de modèle)
Si la grammaire FMPXMLLAYOUT est spécifiée, cette commande extrait des informations de modèle d'une base de données et les affiche dans la grammaire FMPXMLLAYOUT. Si une grammaire de données (fmresultset or FMPXMLRESULT) est spécifiée, la commande extrait la section de métadonnées d'un document XML et un recordset vide.
Paramètres de requête indispensables : –db, –lay
Paramètres de requête facultatifs : –script
Exemples :
Pour extraire des informations de modèle : http://192.168.123.101/fmi/xml/FMPXMLLAYOUT.xml?-db=employees
&-lay=departments&-view
Pour extraire des informations de métadonnées : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-view
Références de paramètre de requête
Cette section contient des informations sur des paramètres de requête disponibles pour les requêtes XML.
Paramètre de requête –db (nom de base de données)
Indique la base de données à laquelle la commande de requête s'applique.
Valeur : Nom de la base de données sans l'extension de nom de fichier, si elle existe.
Remarque
Lorsque vous indiquez le nom de la base de données pour le paramètre –db dans les chaînes de requête, n'incluez pas l'extension du nom de fichier. Le nom de fichier réel de la base de données peut éventuellement comprendre une extension, mais les extensions ne sont pas autorisées comme valeur pour le paramètre –db.
Obligatoire pour : Toutes les commandes de requête, à l'exception de –dbnames
Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-findall
Annexe A | Noms corrects utilisés dans les chaînes de requête 59
Paramètre de requête –delete.related (suppression d'enregistrements externes),
Supprime un enregistrement dans une rubrique de table externe.
Facultatif pour : La commande de requête –edit
Nécessite : Un nom de table liée et un ID d'enregistrement
Par exemple :
L'exemple suivant supprime l'enregistrement d'une table externe dont l'ID d'enregistrement est
« 20 » dans la table liée nommée « jobtable » et dont l'ID d'enregistrement parent est « 7 ». http://host/fmi/xml/fmresultset.xml?-db=career&-lay=applications&-recid=7
&-delete.related=jobtable.20&-edit
Paramètre de requête –field (nom de rubrique Conteneur)
Indique le nom d'une rubrique Conteneur.
Obligatoire pour : Les requêtes de données dans une rubrique Conteneur.
Paramètre de requête fieldname (nom de rubrique non-Conteneur)
Les noms de rubrique sont utilisés pour contrôler les critères de la commande de requête –find ou pour modifier le contenu d'un enregistrement. Quand vous devez spécifier une valeur pour une rubrique non-conteneur pour une commande ou un paramètre de requête, utilisez le nom de rubrique sans le trait d'union (-) en guise de partie nom de la paire nom/valeur.
Nom : Nom de la rubrique dans la base de données FileMaker. Si la rubrique ne se trouve pas dans la table sous-jacente du modèle spécifié dans la chaîne de requête, le nom de rubrique doit
être entièrement qualifié.
Il est déconseillé d'utiliser des points ou des parenthèses dans les noms de rubrique. Dans certains cas, les noms de rubrique comportant des points peuvent fonctionner mais en aucun cas, ils ne peuvent contenir les exceptions suivantes :
1
Le point ne peut pas être suivi d'un chiffre. Par exemple, myfield.9 est un nom de rubrique invalide.
1
Le point ne peut pas être suivi de la chaîne de texte op (les deux lettres « op »). Par exemple, myfield.op est un nom de rubrique invalide.
1
Le point ne peut pas être suivi de la chaîne de texte global (le mot « global »). Par exemple, myfield.global est un nom de fichier invalide.
Les noms de rubrique contenant l’une de ces exceptions ne sont pas accessibles via XML lorsque vous utilisez une requête HTTP. Ces constructions sont destinées aux ID d'enregistrements,
Valeur : Pour les commandes de requête –new et –edit, indiquez la valeur à stocker dans la rubrique de l'enregistrement actuel. Pour les commandes de requête –find, indiquez la valeur que vous souhaitez rechercher dans la rubrique. Lorsque vous indiquez la valeur d'une rubrique de type date, heure ou horodatage, utilisez le format « fm ». Les formats « fm » sont jj/MM/aaaa pour la date, HH:mm:ss pour l'heure et jj/MM/aaaa HH:mm:ss pour l'horodatage.
Obligatoire pour : La commande de requête –edit
Facultatif pour : Les commandes de requête –new et –find
Annexe A | Noms corrects utilisés dans les chaînes de requête 60
Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-op=eq&FirstName=Sam&-max=1&-find
Remarque
Le fait de spécifier un nom de rubrique à plusieurs reprises dans une même requête n'est pas pris en charge ; FileMaker Server analyse toutes les valeurs mais utilise uniquement la dernière valeur analysée. gte lt lte neq bw ew gt
Mot-clé
eq cn
Paramètre de requête fieldname.op (opérateur de comparaison)
Indique l'opérateur de comparaison à appliquer au nom de rubrique précédant l'opérateur.
Les opérateurs de comparaison sont utilisés avec la commande de requête –find.
Valeur : L'opérateur que vous voulez utiliser. L'opérateur par défaut est « begins with ».
Les opérateurs valables sont les suivants :
Opérateur FileMaker Pro équivalent
=word
*word* word*
*word
> word
>= word
< word
<= word omit, word
Facultatif pour : La commande de requête –find
Nécessite : Un nom de rubrique et une valeur.
La syntaxe de spécification d'un opérateur de comparaison est la suivante : table-name::field-name=value&table-name::field-name.op=op-symbol où :
1
table-name
est la table contenant la rubrique et est uniquement requise si la rubrique n'est pas dans la table source du modèle spécifié dans la chaîne de requête.
1
op-symbol
est l'un des mots-clés du tableau précédent, tel que cn.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&name=Tim&name.op=cn&-find
Vous pouvez utiliser n'importe quel opérateur de recherche FileMaker Pro en spécifiant le mot-clé bw
. Par exemple, pour chercher une plage de valeurs à l'aide de l'opérateur de plage (...), spécifiez le mot-clé bw et placez les caractères ... devant le critère de recherche.
Annexe A | Noms corrects utilisés dans les chaînes de requête 61
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&IDnum=915...925&IDnum.op=bw&-find
Pour plus d'informations sur les opérateurs pouvant être utilisés pour rechercher du texte, consultez l'Aide FileMaker Pro.
Paramètre de requête –lay (modèle)
Indique le modèle de base de données que vous souhaitez utiliser.
Valeur : Nom du modèle.
Obligatoire pour : Toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames.
Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-view
Paramètre de requête –lay.response (changer de modèle pour la réponse)
Indique que FileMaker Server doit utiliser le modèle spécifié par le paramètre –lay lors du traitement d'une requête et passer au modèle spécifié par le paramètre–lay.response pour le traitement de la réponse XML.
Si vous n'incluez pas le paramètre –lay.response, FileMaker Server utilise le modèle spécifié par le paramètre –lay pour le traitement de la requête et de la réponse.
Vous pouvez utiliser le paramètre –lay.response pour les requêtes XML.
Valeur : Nom du modèle.
Facultatif pour : Toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames.
Par exemple : http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=Budget&Salary=100000&Salary.op=gt&-find&-lay.response=ExecList
Paramètre de requête –lop (opérateur logique)
Indique comment les critères de recherche de la commande de requête –find sont combinés en recherche « and » ou « or ».
Valeur : and ou or
Si le paramètre de requête –lop n'est pas inclus, alors la commande de requête –find utilise la valeur « and ».
Facultatif pour : La commande de requête –find
Remarque
Non pris en charge par la commande de requête -findquery.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&Last+Name=Smith&Birthdate=2/5/1972&-lop=and&-find
Annexe A | Noms corrects utilisés dans les chaînes de requête 62
Paramètres de requête –max (nombre maximal d'enregistrements)
Indique le nombre maximum d'enregistrements que vous souhaitez obtenir.
Valeur : Un nombre ou la valeur all pour obtenir tous les enregistrements. Si –max n'est pas spécifié, tous les enregistrements sont renvoyés.
Facultatif pour : Les commandes de requêtes –find, –findall et -findquery
Remarque
Le paramètre de requête –max n'affecte pas les valeurs renvoyées pour les enregistrements externes. Pour limiter le nombre de lignes renvoyées pour les enregistrements
Exemples :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-max=10&-findall http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-max=all&-findall
Paramètre de requête –modid (ID de la modification)
L'ID de modification est un compteur incrémentiel indiquant la version actuelle d'un enregistrement.
En spécifiant un ID de modification lorsque vous utilisez une commande de requête –edit, vous pouvez vous assurer que vous éditez la version actuelle d'un enregistrement. Si l'ID de modification que vous spécifiez ne correspond pas à la valeur d'ID de modification actuelle dans la base de données, la commande de requête –edit n'est pas autorisée et un code d'erreur est renvoyé.
Valeur : Un ID de modification unique, indiquant la version actuelle d'un enregistrement dans une base de données FileMaker.
Facultatif pour : La commande de requête –edit
Nécessite : le paramètre –recid
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-recid=22&-modid=6&last_name=Jones&-edit
Commande de requête –query (requête de recherche composée)
Indique les noms de requête et les critères de recherche d'une requête de recherche composée.
Consultez la section « Commande de requête –findquery (recherche composée) », page 56.
Valeur : Une expression de requête.
Obligatoire pour : La commande de requête –findquery
La syntaxe d'une requête de recherche composée est :
-query=request-declarationsrequest-definitions&-findquery
Où :
<request-declarations>
représente au moins deux déclarations de requête.
1
Chaque déclaration de requête se compose d'un ou plusieurs identificateur(s) de requête, séparé(s) par des virgules et mis entre parenthèses. Un identificateur de requête est représenté par la lettre « q » suivie d'un nombre. Par exemple : q1
Annexe A | Noms corrects utilisés dans les chaînes de requête 63
1
Entourées de parenthèses, les requêtes multiples agissent comme un opérateur logique ET, ce qui réduit le résultat de la recherche. Par exemple, (q1, q2) renvoie des enregistrements correspondant à q1 et q2.
Remarque
Il est déconseillé d'utiliser les mêmes rubriques pour les variables q dans le même critère de recherche « and ».
1
Comme avec FileMaker Pro, chaque requête peut être une recherche ou une exclusion. Une requête de recherche ajoute les enregistrements correspondants au jeu d'enregistrements trouvés ; une exclusion les en retire. Par défaut, les requêtes sont des recherches. Pour une requête d'exclusion, placer un point d'exclamation ( !) devant la parenthèse ouvrante.
Par exemple : (q1);!(q2)
Dans cet exemple, q1 est une requête de recherche ; q2 est une requête d'exclusion car elle est précédée d'un point d'exclamation.
1
Les requêtes sont séparées par des points-virgules. Les requêtes multiples agissent comme un opérateur logique OU, ce qui élargit le résultat de la recherche. Par exemple, (q1);(q2) renvoie des enregistrements correspondant à q1 ou q2. Les requêtes d'exclusion n'agissent pas comme un opérateur logique OU car elles excluent des enregistrements du résultat de la recherche.
1
Les requêtes sont exécutées dans l'ordre indiqué ; le jeu d'enregistrements trouvé inclut les résultats de la totalité de la requête de recherche composée.
<request-definitions>
est une définition de requête correspondant à chaque déclaration de requête. Chaque définition de requête se compose d'une rubrique de recherche et d'une définition de valeur. Un signe moins (-) indique le début de la définition de requête.
Syntaxe :
-<query-id>=<fieldname>&-<query-id>.value=<value>
Par exemple :
-q1=typeofanimal&-q1.value=Cat
-q2=name&-q2.value=Fluffy
Par exemple :
Rechercher les enregistrements des chats gris qui ne s'appellent pas « Fluffy ».
http://host/fmi/xml/fmresultset.xml?-db=petclinic&-lay=Patients
&-query=(q1, q2);!(q3)&-q1=typeofanimal&-q1.value=Cat&-q2=color
&-q2.value=Gray&-q3=name&-q3.value=Fluffy&-findquery
Paramètre de requête –recid (ID d'enregistrement)
Indique l'enregistrement que vous souhaitez traiter. Utilisé principalement dans les commandes de requête –edit et –delete. Utilisé par la commande -view pour extraire des données de liste de valeurs liées dans la grammaire FMPXMLLAYOUT.
Valeur : Un ID d'enregistrement qui est l'identifiant unique d'un enregistrement dans une base de données FileMaker.
Obligatoire pour : Les commandes de requête –edit, –delete et –dup
Facultatif pour : Les commandes –find et –view
Annexe A | Noms corrects utilisés dans les chaînes de requête 64
Exemple 1 :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-recid=22&-delete
Exemple 2 :
http://localhost/fmi/xml/FMPXMLLAYOUT.xml?-db=test&-lay=empty&-view&-recid=9
Paramètre de requête –relatedsets.filter (filtrage d'enregistrements de table externe)
Spécifie si les enregistrements de table externe à renvoyer dans les résultats de cette requête doivent être filtrés
Valeur : layout ou none
1
Si –relatedsets.filter est paramétré sur layout, alors le paramètre
Rangée initiale
spécifié dans la boîte de dialogue Table externe de FileMaker Pro est respecté.
1
Si le paramètre
Barre de défilement vertical
est activé dans la boîte de dialogue
Table externe, utilisez l'option –relatedsets.max pour indiquer le nombre maximum
d'enregistrements à renvoyer. Consultez la rubrique « Paramètre de requête
–relatedsets.max (limitation d'enregistrements de table externe) » ci-dessous.
1
Si le paramètre
Barre de défilement vertical
est désactivée ou que l'option
–relatedsets.max
n'est pas utilisée, alors le paramètre
Nombre de rangées
de la boîte de dialogue Table externe détermine le nombre d'enregistrements de tables externes
à renvoyer.
1
La valeur par défaut est none si ce paramètre n'est pas précisé. Si –relatedsets.filter est paramétré sur none, alors le moteur de publication Web renvoie tous les enregistrements de la table externe. Les valeurs
Rangée initiale
et
Nombre de rangées
spécifiées dans la boîte de dialogue Table externe sont ignorées.
Remarques :
1
Le paramètre –relatedsets.filter n'a aucun impact sur le mode de tri des enregistrements dans les requêtes XML. Le tri spécifié dans FileMaker Pro est respecté que la valeur de paramètre –relatedsets.filter soit layout ou none.
1
Le paramètre
Filtrer les enregistrements de la table externe
dans la boîte de dialogue Table externe n'est pas compatible avec les requêtes XML. Tout calcul spécifié pour le paramètre
Filtrer les enregistrements de la table externe
est ignoré.
Facultatif pour : –find, –edit, –new, –dup et –findquery.
Exemples :
http://localhost/fmi/xml/fmresultset.xml?
db=FMPHP_Sample&
lay=English
&
relatedsets.filter=none&
findany http://localhost/fmi/xml/fmresultset.xml?
db=FMPHP_Sample
&
lay=English&relatedsets.filter=layout&
relatedsets.max=all&
findany http://localhost/fmi/xml/fmresultset.xml?
db=FMPHP_Sample&
lay=English
&
relatedsets.filter=layout&
relatedsets.max=10&
findany
Annexe A | Noms corrects utilisés dans les chaînes de requête 65
Paramètre de requête –relatedsets.max (limitation d'enregistrements de table externe)
Indique le nombre maximum d'enregistrements externes à renvoyer dans les résultats de cette requête.
La valeur est : un nombre entier ou all.
1
Le paramètre –relatedsets.max est respecté uniquement si le paramètre
Barre de défilement vertical
est activé dans la boîte de dialogue Table externe de FileMaker Pro et si le paramètre –relatedsets.filter est défini sur layout.
1
Si le paramètre –relatedsets.maxindique un nombre entier, alors le moteur de
Publication Web renvoie ce nombre d'enregistrements externes après la rangée initiale.
1
Si le paramètre –relatedsets.max indique all, alors le moteur de Publication Web renvoie tous les enregistrements de tables externes.
Remarque
Pour obtenir des informations sur le filtrage des enregistrements externes,
Facultatif pour : –find, –edit, –new, –dup et –findquery.
Exemples :
http://localhost/fmi/xml/fmresultset.xml?
db=FMPHP_Sample
&
lay=English&relatedsets.filter=layout&
relatedsets.max=all&
findany http://localhost/fmi/xml/fmresultset.xml?
db=FMPHP_Sample&
lay=English
&
relatedsets.filter=layout&
relatedsets.max=10&
findany
Paramètre de requête –script (Script)
Indique le script FileMaker à lancer quand la commande de requête et le tri ont été exécutés.
Consultez la section « Comprendre le traitement d'une requête XML », page 41.
Valeur : Nom du script
Facultatif pour : Toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-script=myscript&-findall
Paramètre de requête –script.param (transfert du paramètre au script)
Transmet un paramètre au script FileMaker spécifié par –script
Valeur : Un simple paramètre texte.
1
Pour transmettre plusieurs paramètres, vous pouvez créer une chaîne délimitant les paramètres et faire en sorte que votre script analyse chacun des paramètres. Par exemple, transmettez param1|param2|param3 en tant que liste, en utilisant le caractère | de codage
URL de la façon suivante : param1%7Cparam2%7Cparam3
1
Pour traiter le paramètre texte en tant que valeur qui ne soit pas du texte, votre script peut convertir la valeur texte. Par exemple, pour convertir la valeur texte en nombre, votre script doit intégrer : ObtenirNombre(Obtenir(ParamètreScript))
Annexe A | Noms corrects utilisés dans les chaînes de requête 66
1
Si votre requête contient –script.param sans –script, alors –script.param est ignoré.
1
Si votre requête contient plusieurs –script.param, alors le moteur de Publication Web utilise la dernière valeur analysée.
Facultatif pour : –script
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-script=myscript&-script.param=Smith%7CChatterjee%7CSu
&-findall
Paramètre de requête –script.prefind (script avant une recherche)
Spécifie le script FileMaker à exécuter avant la recherche et le tri d'enregistrements (le cas
échéant) pendant le traitement d'une commande de requête –find.
Valeur : Nom du script
Facultatif pour : Toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-script.prefind=myscript&-findall
Paramètre de requête –script.prefind.param (transfert du paramètre au script avant recherche)
Transfère un paramètre au script FileMaker spécifié par –script.prefind
Valeur : Un simple paramètre texte.
1
Pour transmettre plusieurs paramètres, vous pouvez créer une chaîne délimitant les paramètres et faire en sorte que votre script analyse chacun des paramètres. Par exemple, transmettez param1|param2|param3 en tant que liste, en utilisant le caractère | de codage
URL de la façon suivante : param1%7Cparam2%7Cparam3
1
Pour traiter le paramètre texte en tant que valeur qui ne soit pas du texte, votre script peut convertir la valeur texte. Par exemple, pour convertir la valeur texte en nombre, votre script doit intégrer : ObtenirNombre(Obtenir(ParamètreScript))
1
Si votre requête contient –script.prefind.param sans –script.prefind, alors
–script.prefind.param
est ignoré.
1
Si votre requête contient plusieurs –script.prefind.param, alors le moteur de publication
Web utilise la dernière valeur analysée.
Facultatif pour : –script.prefind
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-script.prefind=myscript&-script.prefind.param=payroll
&-findall
Annexe A | Noms corrects utilisés dans les chaînes de requête 67
Paramètre de requête –script.presort (script avant un tri)
Spécifie le script FileMaker à exécuter après l'extraction d'enregistrements (le cas échéant) et avant leur tri, pendant le traitement d'une commande de requête –find.
Facultatif pour : Toutes les commandes de requête, à l'exception de –dbnames,
–layoutnames
et –scriptnames.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-script.presort=myscript&-sortfield.1=dept
&-sortfield.2=rating&-findall
Paramètre de requête –script.presort.param (transfert du paramètre au script avant recherche)
Transfère un paramètre au script FileMaker spécifié par –script.presort
Valeur : Un simple paramètre texte.
1
Pour transmettre plusieurs paramètres, vous pouvez créer une chaîne délimitant les paramètres et faire en sorte que votre script analyse chacun des paramètres. Par exemple, transmettez param1|param2|param3 en tant que liste, en utilisant le caractère | de codage
URL de la façon suivante : param1%7Cparam2%7Cparam3
1
Pour traiter le paramètre texte en tant que valeur qui ne soit pas du texte, votre script peut convertir la valeur texte. Par exemple, pour convertir la valeur texte en nombre, votre script doit intégrer : ObtenirNombre(Obtenir(ParamètreScript))
1
Si votre requête contient –script.presort.param sans –script.presort, alors
–script.presort.param
est ignoré.
1
Si votre requête contient plusieurs –script.presort.param, alors le moteur de publication
Web utilise la dernière valeur analysée.
Facultatif pour : –script.presort
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-script.presort=myscript&-script.presort.param=18%7C65
&-sortfield.1=dept&-sortfield.2=rating&-findall
Paramètre de requête –skip (enregistrements ignorés)
Indique le nombre d'enregistrements à ignorer dans l'ensemble d'enregistrements trouvés.
Valeur : Un nombre. Si la valeur est supérieure au nombre d'enregistrements contenus dans l'ensemble d'enregistrements trouvés, aucun enregistrement n'est affiché. La valeur par défaut est 0.
Facultatif pour : La commande de requête –find
Dans l'exemple suivant, les 10 premiers enregistrements de l'ensemble d'enregistrements trouvés sont ignorés et les enregistrements 11 à 15 sont affichés.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=departments&-skip=10&-max=5&-findall
Annexe A | Noms corrects utilisés dans les chaînes de requête 68
Paramètre de requête –sortfield (rubrique de tri)
Spécifie la rubrique à utiliser pour le tri.
La valeur est : field name
Facultatif pour : Les commandes de requête –find ou –findall
Le paramètre de requête –sortfield peut être utilisé plusieurs fois pour effectuer des tris de rubriques multiples. La syntaxe permettant de spécifier la priorité des rubriques de tri est la suivante :
-sortfield.precedence-number=fully-qualified-field-name où precedence-number dans le paramètre de requête –sortfield.precedence-number est un nombre qui indique la priorité à utiliser dans le cas de rubriques à tri multiple. Valeur de precedence-number
:
1
doit commencer par 1.
1
doit s'incrémenter de façon séquentielle.
1
ne doit pas être supérieure à 9.
Dans l'exemple suivant, la rubrique « dept » est triée en premier, puis vient le tour de la rubrique
« rating ». Les deux rubriques sont triées par ordre croissant car le paramètre de requête
–sortorder
n'est pas spécifié.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=performance&-sortfield.1=dept&-sortfield.2=rating&-findall
Paramètre de requête –sortorder (ordre de tri)
Indique l'ordre d'un tri.
Valeur : L'ordre de tri. Les ordres de tri suivants sont valides, quand <value-list-name> est un nom de liste de valeurs tel que Custom :
Mot-clé
ascend
Opérateur FileMaker Pro équivalent
Tri a à z, -10 à 10 descend
Tri z à a, 10 à -10
<value-list-name>
Triez à l'aide de la liste des valeurs spécifiée, associée à la rubrique dans le modèle.
Facultatif pour : Les commandes de requête –find ou –findall
Nécessite : le paramètre de requête –sortfield
Le paramètre de requête –sortorder peut être utilisé avec le paramètre de requête
–sortfield
pour spécifier l'ordre de tri des rubriques de tri multiple. La syntaxe permettant de spécifier l'ordre de tri d'une rubrique de tri est la suivante :
–sortorder.precedence-number=sort-method où :
1
precedence-number
dans le paramètre –sortorder.precedence-number est un nombre situé entre 1 et 9 indiquant le paramètre de requête –sortfield auquel le paramètre de requête –sortorder s'applique.
1
sort-method
est un des mots-clés du tableau précédent permettant de spécifier l'ordre de tri, par exemple ascend.
Annexe A | Noms corrects utilisés dans les chaînes de requête 69
Dans l'exemple suivant, l'ordre de tri de la rubrique ayant la priorité la plus élevée (dept) est ascend, tandis que l'ordre de tri de la rubrique de priorité secondaire (rating) est descend. La valeur 2 affectée
à precedence-number dans -sortorder.2 indique que le paramètre de requête sortorder.2=descend
s'applique au paramètre de requête -sortfield.2=rating.
Par exemple :
http://192.168.123.101/fmi/xml/fmresultset.xml?-db=employees
&-lay=performance&-sortfield.1=dept&-sortorder.1=ascend&-sortfield.2=rating
&-sortorder.2=descend&-findall
Remarque
Si un paramètre de requête –sortorder n'est pas spécifié pour une rubrique de tri, le tri ascendant est utilisé par défaut.
Annexe B
Codes d'erreur de la publication Web personnalisée
Le moteur de publication Web génère des codes d'erreur de base de données et les erreurs de chaîne de requête qui peuvent se produire pendant une requête de données XML.
La présente annexe répertorie les codes d'erreurs connus au moment de la publication de ce document. Pour obtenir la liste des codes d'erreur mis à jour, reportez-vous à la Base de connaissances FileMaker (http://help.filemaker.com).
Numéros de code d'erreur au format XML
Le moteur de publication Web génère un code d'erreur pour les bases de données publiées au format XML lorsque des données sont requises. Ce type de valeur de code d'erreur s'insère au début du document XML dans l'élément <error code> pour la grammaire fmresultset ou dans l'élément <ERRORCODE> pour les grammaires FMPXMLRESULT ou FMPXMLLAYOUT. Un code d'erreur égal à 0 indique qu'aucune erreur ne s'est produite.
Voici un exemple de code d'erreur de base de données dans la grammaire fmresultset :
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE fmresultset PUBLIC "-//FMI//DTD fmresultset//EN"
"/fmi/xml/fmresultset.dtd">
<fmresultset xmlns="http://www.filemaker.com/xml/fmresultset" version="1.0">
<error code="0"></error>
Voici un exemple de code d'erreur de base de données dans la grammaire FMPXMLRESULT :
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE FMPXMLRESULT PUBLIC "-//FMI//DTD FMPXMLRESULT//EN"
"/fmi/xml/FMPXMLRESULT.dtd">
<fmpxmlresult xmlns="http://www.filemaker.com/fmpxmlresult">
<ERRORCODE>0</ERRORCODE>
En tant que développeur de la solution de publication Web personnalisée, il vous appartient de vérifier la valeur de l'élément <error code> ou <ERRORCODE> et d'agir en conséquence.
Le moteur de publication Web ne gère pas les erreurs de base de données.
Numéros des codes d'erreur des bases de données FileMaker
2
3
4
0
1
Numéro d'erreur
-1
Description
Erreur inconnue
Pas d'erreur
L'utilisateur a annulé l'action
Erreur de mémoire
Commande non disponible (par exemple, système d'exploitation incorrect, mode incorrect, etc.)
Commande inconnue
Numéro d'erreur
5
18
19
20
21
14
15
16
17
10
11
12
13
8
9
6
7
111
112
113
114
107
108
109
110
115
116
117
118
130
100
101
102
103
104
105
106
Annexe B | Codes d'erreur de la publication Web personnalisée
Description
Commande incorrecte (par exemple, un calcul n'a pas été indiqué pour une action de script
Définir rubrique)
Fichier accessible en lecture seule
Mémoire insuffisante
Résultat vide
Privilèges d'accès insuffisants
Données requises manquantes
Nom incorrect
Ce nom existe déjà
Le fichier ou l'objet est déjà utilisé
En dehors de l'intervalle
Division par zéro impossible
Echec de l'opération, réessayez (par exemple une requête utilisateur)
Echec de la tentative de conversion d'un jeu de caractères étranger en UTF-16
Le client doit fournir les données du compte pour poursuivre
La chaîne contient des caractères autres que A-Z, a-z, 0-9 (ASCII)
Commande ou opération annulée par un script déclenché
Requête non prise en charge (par exemple, lors de la création d'un lien en dur sur un système de fichiers qui ne prend pas en charge ce type de lien)
Fichier manquant
Enregistrement manquant
Rubrique manquante
Lien manquant
Script manquant
Modèle manquant
Table manquante
Index manquant
Liste de valeurs manquante
Jeu de privilèges d'accès manquant
Tables liées manquantes
Valeur de rubrique incorrecte
Fenêtre manquante
Fonction manquante
Référence de fichier manquante
Ensemble de menus manquant
Objet de modèle manquant
Source de données manquante
Le thème est manquant
Les fichiers sont endommagés ou manquants et doivent être réinstallés
71
404
405
406
407
408
409
307
308
400
401
302
303
304
306
402
403
217
218
300
301
213
214
215
216
209
210
211
212
205
206
207
208
Numéro d'erreur
131
200
201
202
203
204
Annexe B | Codes d'erreur de la publication Web personnalisée
Description
Les fichiers des modules de langue sont manquants (par exemple, les solutions de démarrage)
L'accès à l'enregistrement est interdit
Impossible de modifier la rubrique
L'accès à la rubrique est interdit
Aucun enregistrement à imprimer, ou bien un mot de passe est nécessaire pour imprimer
Aucun accès aux rubriques dans l'ordre de tri
Impossible de créer de nouveaux enregistrements ; l'importation peut remplacer les données existantes
Impossible de modifier le mot de passe ou bien le fichier ne peut pas être modifié
Impossible d'accéder au schéma de base de données ou bien le fichier ne peut pas être modifié
Nombre de caractères insuffisant dans le mot de passe
Le nouveau mot de passe doit être différent du mot de passe existant
Compte utilisateur inactif
Mot de passe expiré
Compte utilisateur et/ou mot de passe incorrect. Réessayez
Le compte utilisateur et/ou le mot de passe n'existe pas
Tentatives de connexion trop nombreuses
Impossible de dupliquer les droits Admin
Impossible de dupliquer un compte Invité
L'utilisateur ne dispose pas de droits suffisants pour modifier le compte administrateur
Le mot de passe et le mot de passe de confirmation ne correspondent pas
Fichier verrouillé ou en cours d'utilisation
L'enregistrement est déjà utilisé par un autre utilisateur
La table est déjà utilisée par un autre utilisateur
Le schéma de base de données est déjà utilisé par un autre utilisateur
Le modèle est déjà utilisé par un autre utilisateur
L'ID de modification d'enregistrement ne correspond pas
La transaction ne peut pas être verrouillée en raison d'une erreur de communication avec l'hôte
Le thème est déjà utilisé et verrouillé par un autre utilisateur
Les critères de recherche sont vides
Aucun enregistrement ne correspond à cette requête
Ceci n'est pas une rubrique clé pour une référence externe
Le nombre maximal d'enregistrements indiqué est atteint pour la version de démonstration de
FileMaker Pro
Ordre de tri incorrect
Le nombre d'enregistrements indiqué dépasse le nombre d'enregistrements pouvant être ignorés
Les critères de remplacement et de renumérotation sont incorrects
Une ou les deux rubriques clés manquent (lien incorrect)
Le type de la rubrique indiquée est incorrect pour ce type d'opération
Ordre d'importation incorrect
72
700
706
707
708
600
601
602
603
506
507
508
509
510
511
512
513
709
710
711
714
715
502
503
504
505
417
418
500
501
Numéro d'erreur
410
412
413
414
415
416
Annexe B | Codes d'erreur de la publication Web personnalisée 73
Description
Ordre d'exportation incorrect
Version de FileMaker Pro incorrecte pour récupérer le fichier
Le type de la rubrique indiquée est incorrect
Résultat impossible à afficher sur le modèle
Un ou plusieurs enregistrements liés requis ne sont pas disponibles
Une clé primaire est requise dans la table source de données
La base de données n'est pas une source de données prise en charge
Echec interne lors de l'opération INSERER dans une rubrique
La date indiquée ne correspond pas aux options d'entrée définies
L'heure indiquée ne correspond pas aux options d'entrée définies
Le numéro indiqué ne correspond pas aux options d'entrée définies
La valeur de la rubrique n'est pas comprise dans la fourchette de valeurs définies
La valeur de la rubrique ne correspond pas à la valeur définie dans les options d'entrée
La valeur de la rubrique ne correspond à aucune donnée existante contenue dans le fichier de base de données des options d'entrée
La valeur de la rubrique n'est pas incluse dans la liste des valeurs définies
La valeur de la rubrique n'est pas conforme aux critères de contrôle de calcul des options d'entrée
Valeur incorrecte saisie en mode Recherche
La rubrique requiert une valeur correcte
La valeur liée est vide ou non disponible
La valeur de la rubrique dépasse la taille de rubrique maximale
Enregistrement déjà modifié par un autre utilisateur
Aucune validation n'a été définie, mais les données ne peuvent pas être affichées en totalité dans la rubrique
Une erreur d'impression s'est produite
L'en-tête et le pied de page combinés sont plus longs qu'une page
Le corps de la page ne tient pas sur une page pour la disposition en colonnes active
Connexion d'imprimante perdue
Le fichier ne possède pas le bon format d'importation
Le fichier EPSF est dépourvu d'images de prévisualisation
Le traducteur graphique est introuvable
Importation de fichier impossible, ou moniteur gérant les couleurs est nécessaire pour effectuer cette opération
L'importation d'une séquence QuickTime a échoué
Impossible de mettre à jour la référence du fichier QuickTime car le fichier de base de données est accessible en lecture seule
Le traducteur d'importation est introuvable
Les privilèges d'accès associés à votre mot de passe ne vous permettent pas d'effectuer cette opération
Feuille de calcul ou plage nommée Excel spécifiée manquante
803
804
805
806
807
808
Annexe B | Codes d'erreur de la publication Web personnalisée
736
737
738
800
801
802
731
732
733
734
735
727
729
730
Numéro d'erreur
716
717
718
719
720
721
722
723
724
725
726
74
Description
Une requête SQL utilisant les instructions DELETE, INSERT ou UPDATE n'est pas autorisée dans l'importation ODBC
Les informations XML/XSL sont insuffisantes pour procéder à l'importation ou à l'exportation
Erreur lors de l'analyse du fichier XML (à partir de Xerces)
Erreur lors de la transformation du fichier XML en fichier XSL (à partir de Xalan)
Erreur lors de l'exportation ; le format souhaité ne prend pas en charge les rubriques multivaluées
Une erreur inconnue s'est produite dans l'analyseur ou le transformateur
Impossible d'importer des données dans un fichier dépourvu de rubriques
Vous ne disposez pas des droits nécessaires pour ajouter des enregistrements ou les modifier dans la table cible
Vous ne disposez pas des droits nécessaires pour ajouter des enregistrements à la table cible
Vous ne disposez pas des droits nécessaires pour modifier les enregistrements dans la table cible
Le fichier d'importation contient davantage d'enregistrements que la table cible. Les enregistrements n'ont pas tous été importés
La table cible contient davantage d'enregistrements que le fichier d'importation. Les enregistrements n'ont pas tous été mis à jour
Erreur lors de l'importation. Des enregistrements n'ont pas été importés
Version d'Excel non prise en charge (convertissez le fichier au format Excel 2007/2008 ou une version ultérieure prise en charge, puis réessayez)
Le fichier servant à l'importation ne contient aucune donnée
Impossible d'insérer ce fichier car il contient d'autres fichiers
Une table ne peut être importée en elle-même
Ce type de fichier n'a pu être affiché sous la forme d'une image
Ce type de fichier n'a pu être affiché sous la forme d'une image. Il sera inséré et affiché sous forme de fichier
Il y a trop de données à exporter dans ce format. Les données seront tronquées.
La table Bento que vous tentez d'importer est manquante
Le thème que vous tentez d'importer existe déjà
Impossible de créer le fichier sur le disque
Impossible de créer un fichier temporaire sur le disque
Impossible d'ouvrir le fichier.
Cette erreur peut être causée par l'un des éléments suivants :
1
Nom de base de données non valide
1
Le fichier est fermé dans FileMaker Server
1
Permission non valide
Le fichier est mono-utilisateur ou bien l'hôte est introuvable
Le fichier ne peut pas être ouvert en lecture seule dans son état actuel
Le fichier est endommagé
Utilisez la commande Récupérer. Le fichier ne peut être ouvert avec cette version de FileMaker Pro
Le fichier n'est pas un fichier FileMaker Pro ou est sérieusement endommagé
Impossible d'ouvrir le fichier car les privilèges d'accès sont endommagés
Annexe B | Codes d'erreur de la publication Web personnalisée
906
920
921
922
901
902
903
905
851
852
853
900
824
825
826
850
956
957
958
959
923
951
954
955
820
821
822
823
815
816
817
819
Numéro d'erreur
809
810
811
812
813
814
75
Description
Le disque/volume est saturé
Le disque/volume est verrouillé
Un fichier temporaire ne peut être ouvert en tant que fichier FileMaker Pro
La capacité de l'hôte a été dépassée
Erreur de synchronisation d'enregistrements sur le réseau
Impossible d'ouvrir le fichier, car le nombre maximal de fichiers ouverts est atteint
Impossible d'ouvrir le fichier de référence externe
Impossible de convertir le fichier
Impossible d'ouvrir le fichier, car il n'appartient pas à cette solution
Impossible d'enregistrer une copie locale d'un fichier distant
Fichier en cours de fermeture
Déconnexion forcée par l'hôte
Fichiers FMI introuvables ; réinstallez les fichiers manquants
Impossible de définir le fichier en mode mono-utilisateur, des invités sont connectés
Le fichier est endommagé ou n'est pas un fichier FileMaker
Le fichier n'est pas autorisé à référencer le fichier protégé
Le chemin d'accès indiqué pour le fichier est non valide
Le chemin est non valide pour le système d'exploitation
Impossible de supprimer un fichier externe du disque
Impossible d'écrire dans un fichier se trouvant dans le stockage externe
Un ou plusieurs conteneurs n'ont pas pu être transférés
Erreur générale de vérification orthographique
Le dictionnaire principal n'est pas installé
Impossible de lancer le système d'aide
Cette commande ne peut pas être utilisée dans un fichier partagé
Aucune rubrique active sélectionnée ; la commande ne peut être utilisée que si une rubrique est active
Le fichier en cours n'est pas partagé ; la commande ne peut être utilisée que si le fichier est partagé
Impossible d'initialiser le correcteur orthographique
Impossible de charger le dictionnaire de l'utilisateur pour modification
Dictionnaire de l'utilisateur introuvable
Dictionnaire de l'utilisateur en lecture seule
Une erreur inattendue s'est produite
Grammaire XML non prise en charge
Aucun nom de base de données
Le nombre maximal de sessions de base de données a été dépassé
Commande en conflit
Paramètre manquant dans la requête
La technologie de Publication Web personnalisée est désactivée
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1300
1301
1400
1401
1402
1403
1404
1405
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
Numéro d'erreur
960
1200
1201
1202
1203
1204
Annexe B | Codes d'erreur de la publication Web personnalisée
Description
Paramètre non valide
Erreur de calcul générique
Paramètres trop peu nombreux dans la fonction
Paramètres trop nombreux dans la fonction
Fin de calcul non conforme
Nombre, chaîne, nom de rubrique ou parenthèse ouvrante « ( » nécessaire
Commentaire non terminé par « */ »
La chaîne doit se terminer par un guillemet
Parenthèses non équilibrées
Opérateur manquant, fonction introuvable ou parenthèse ouvrante « ( » non nécessaire
Nom (nom de rubrique ou de modèle) manquant
Fonction plug-in déjà enregistrée
L'utilisation de listes n'est pas autorisée dans cette fonction
Entrez ici un opérateur (+, -, *,).
Cette variable a déjà été définie dans la fonction Définir
Fonction MOYENNE, NOMBRE, MULTIVALUEE, OBTENIRREPETITION, MAX, MIN, NPV,
ECARTTYPE, SOMME et RECAPITULATIF : le programme a rencontré une expression requérant une seule rubrique.
Ce paramètre est incorrect pour la fonction Obtenir
Seules les rubriques de type Statistique sont autorisées comme premier argument dans
RECAPITULATIF
Rubrique de regroupement incorrecte
Evaluation du nombre impossible
Impossible d'utiliser une rubrique dans sa propre formule
Le type de la rubrique doit être de type normal ou calculé
Le type de données doit être un nombre, une date, une heure ou un horodatage
Impossible d'enregistrer le calcul
La fonction à laquelle il est fait référence n'est pas encore mise en œuvre
La fonction à laquelle il est fait référence n'existe pas
La fonction à laquelle il est fait référence n'est pas prise en charge dans ce contexte
Le nom indiqué ne peut pas être utilisé
Un des paramètres de la fonction que vous tentez d'importer ou de coller a le même nom qu'une fonction déjà dans le fichier
L'initialisation du pilote ODBC a échoué ; assurez-vous que les pilotes ODBC sont correctement installés.
Echec de l'allocation d'environnement (ODBC)
Echec de la libération d'environnement (ODBC)
Echec de la déconnexion (ODBC)
Echec de l'allocation de connexion (ODBC)
Echec de la libération de connexion (ODBC)
76
1626
1627
1628
1629
1630
1631
1504
1505
1506
1507
1550
1551
1412
1413
1414
1450
1451
1501
1502
1503
Numéro d'erreur
1406
1407
1408
1409
1410
1411
Annexe B | Codes d'erreur de la publication Web personnalisée 77
Description
Echec de la vérification de SQL API (ODBC)
Echec de l'allocation d'instruction (ODBC)
Erreur étendue (ODBC)
Erreur étendue (ODBC)
Erreur étendue (ODBC)
Erreur étendue (ODBC)
Erreur étendue (ODBC)
Erreur étendue (ODBC)
L'instruction SQL est trop longue
Action nécessitant une extension de privilège PHP
Action nécessitant une gestion à distance du fichier actif
Echec de l'authentification SMTP
Connexion refusée par le serveur SMTP
Erreur avec SSL
Le serveur SMTP requiert le cryptage de la connexion
L'authentification spécifiée n'est pas prise en charge par le serveur SMTP
L'envoi du ou des emails a échoué
Impossible de se connecter au serveur SMTP
Impossible de charger le module, ou module non valide
Impossible d'installer le module. Impossible de supprimer un module existant ou d'écrire sur le dossier ou le disque
Le protocole n'est pas pris en charge
Echec de l'authentification
Une erreur s'est produite avec SSL
Connexion expirée ; la valeur du délai d'expiration est de 60 secondes
Format d'URL incorrect
Echec de la connexion
Annexe C
Modifications de requête XML dans
FileMaker 12
Cette annexe répertorie les modifications syntaxiques et sémantiques des commandes de requête et des paramètres XML qui ont été introduits dans FileMaker 12. Pour FileMaker 13, la syntaxe et la sémantique sont identiques à celles introduites dans FileMaker 12.
Modifications de syntaxe de requête XML
Les commandes de requête suivantes ont été supprimées pour FileMaker 12 :
1
–process
Les paramètres de requête suivants ont été supprimés pour FileMaker 12 :
1
–encoding
1
–grammar
1
–stylehref
1
–styletype
1
–token.[string]
Modifications de sémantique de requête XML
Différences de l'analyse de requête
Le moteur de publication Web pour FileMaker 12 présente des modifications significatives de l'ordre dans lequel les commandes de requêtes sont analysées. Pour plus d'informations sur
Par exemple, suite à la modification de l'ordre d'analyse de la commande de requête, FileMaker
12 ne prend pas en charge l'utilisation d'une requête –find sans critère de recherche, même si vous y incluez un paramètre –script spécifiant les critères de recherche. Par exemple, la commande de requête qui suit fonctionnerait dans FileMaker 11, en supposant que le script performFind
précise les critères de recherche :
-db=Customers&-lay=account&-script=performFind&-find
Mais dans FileMaker 12, cet exemple renvoie un code d'erreur 400 (critères de recherche vides).
Dans FileMaker 12, vous pouvez inclure -findall comme critère de recherche :
-db=Customers&-lay=account&-findall&-script=performFind
Annexe C | Modifications de requête XML dans FileMaker 12 79
De plus, le moteur de publication Web pour FileMaker 12 :
1
Ignore les commandes valides ou les paramètres superflus dans une requête. Par exemple, dans la requête suivante, le paramètre –lop est un paramètre valide, mais est superflu dans la commande –delete :
-db=test&-lay=test&-recid=82&-delete&f1=hi&-lop=and
Comme le paramètre –lop utilise l'argument valide et, il est ignoré, et aucune erreur n'est renvoyée.
1
Ignore une commande si elle est passée plusieurs fois. Par exemple : -dbnames&-dbnames
Cependant, le moteur de recherche de publication Web renvoie une erreur si vous indiquez plus de deux commandes différentes dans la même requête. Par exemple : -find&-edit
1
Ignore les esperluettes doubles ou les paramètres vides dans une requête. FileMaker 11 renvoie une erreur.
1
Convertit tous les mots réservés en minuscules. FileMaker 11 renvoie parfois des erreurs pour les mots réservés en majuscules dans certains cas.
1
Ignore le paramètre field.op dans une requête autre que –find. FileMaker 11 remplace la rubrique par le paramètre field.op.
1
Ignore toutes les rubriques non globales transmises pour les commandes –findany,
–findall
, –find avec recid, –findquery, –delete et –dup.
1
Exige que des rubriques de type Global soient ajoutées avec le suffixe « .global ».
Différences de traitement de requête
Le moteur de publication Web pour FileMaker 12 :
1
modifie les rubriques de type Global pour les commandes –findall, –findany, –find,
–findquery
, –new, –edit et –dup.
1
Redéfinit les rubriques de type Global modifiées manuellement à leurs valeurs d'origine une fois la requête traitée et les résultats retournés. Les rubriques de type Global modifiées via un script ne sont pas redéfinies.
1
Renvoie tous les enregistrements qui satisfont les critères de recherche pour une requête
–find
avec field-name.op défini à neq et –lop défini à or. FileMaker 11 ne traite pas cette requête correctement.
1
Renvoie tous les enregistrements ayant une valeur pour chaque paramètre de rubrique transmis en tant que chaîne vide dans une requête –find. FileMaker 11 retire chaque rubrique de chaîne vide des critères de recherche.
1
Renvoie des secondes décimales pour les rubriques de date, d'heure et d'horodatage.
FileMaker 11 renvoie des secondes entières.
1
Pour les listes de valeur définies avec le paramètre
Inclure uniquement les valeurs liées à partir de
, ne renvoie pas de valeurs à moins qu'un paramètre recid soit inclus. FileMaker 11 renvoie les valeurs relatives au premier enregistrement.
Annexe C | Modifications de requête XML dans FileMaker 12 80
Différences dans les codes d'erreur renvoyés
Condition d'erreur
Valeurs max et skip non valides. Par exemple :
-db=basicfinds&-lay=layoutone&-max=-1&-findall
Numéro d'ordre de tri manquant ou Exemple non valide :
-db=basicsorts&-lay=layoutone
&-sortfield.=textfield&-findall
Table liée non valide. Par exemple : -db=relfinds
&-lay=layoutone
&aliasdoesntexist::relatedtextfield=sometext&-find
Rubrique de tri vide dans une requête. Par exemple :
-db=basicsorts&-lay=layoutone&-sortfield.1=
&-findall
Requête –find soumise sans aucune rubrique. Par exemple :
-db=basicedits&-lay=layoutone&-find
Code d'erreur
FileMaker 11
Code d'erreur
FileMaker 12
5 (Commande non valide) 960 (Paramètre non valide)
5 (Commande non valide) 404 (Ordre de tri incorrect).
102 (Rubrique manquante).
Ignoré. Aucun code d'erreur.
106 (Table manquante).
102 (Rubrique manquante).
400 (Les critères de recherche sont vides)
Requête –find soumise avec des rubriques de type Global uniquement. Par exemple :
-db=basicfinds&-lay=layoutone
&globaltextfield.global=sales&-find
Pas d'erreur. FileMaker 11 renvoie tous les enregistrements.
Pas d'erreur. FileMaker 11 renvoie tous les enregistrements.
400 (Les critères de recherche sont vides)
Index
A
activation Publication Web personnalisée dans base de données 14
,
Admin Console FileMakerServer 16
authentification de base, Web 15 authentification des utilisateurs Web 15
B
bases de données, protection après publication 15
C
Caractères ASCII, dans les documents XML 39
chaînes de requête
ajout d'enregistrements à des tables externes 52
,
modification d'enregistrements dans des tables externes 53
nom de rubrique entièrement qualifié, syntaxe 51
rubriques de type Global, syntaxe 54
chaînes de requêtes
codage
codage de texte
codes d'erreurs des bases de données 30
commande de requête –process, supprimée pour FileMaker
commandes. Voir chaînes de requête
comparaison des grammaires XML 29
compte Invité
activation 15 avec la Publication Web personnalisée 15 désactivation 15
comptes et privilèges
activation de la Publication Web personnalisée 14
configuration de la publication Web personnalisée 12
création d'un nouvel enregistrement 57
D
–dbnames, commande de requête 55
définitions de type de document (DTD) 30
–delete, commande de requête 55
–delete.related, paramètre de requête 53
dépannage
sites de Publication Web personnalisée 44
dossier Web, copie des objets de rubrique Conteneur 17
E
éléments <error code> et <ERRORCODE> 70
éléments
code d'erreur des bases de données 30
dans la grammaire FMPXMLLAYOUT 36
dans la grammaire FMPXMLRESULT 34
dans la grammaire fmresultset 31
erreurs
à propos des codes d'erreur 70
éléments des codes d'erreurs des bases de données 30
fichiers journaux du serveur Web 45
numéros des codes d'erreur des bases de données 70
exemples
grammaire FMPXMLLAYOUT générée 38
grammaire FMPXMLRESULT générée 35
grammaire fmresultset générée 33
Extensible Markup Language (XML). Voir XML
F
feuilles de style, test 44 fichiers journaux 44
accès au serveur Web 45 description 45
fichiers journaux d'accès au serveur Web, description 45
field name, paramètre de requête (non-conteneur) 59
–field, paramètre de requête (Conteneur) 59
82
–fieldname.op, paramètre de requête 60
FileMaker Server
documentation 6 installation 6
FileMaker WebDirect
FileMakerPro, différences avec le moteur de publication
filtrage des enregistrements des rubriques de table externe 64
–findall, commande de requête 56
–findany, commande de requête 56
–findquery, commande de requête 56
–
fmxml, mot-clé pour l'activation de la publication XML 14
format UTF-8 (Unicode Transformation 8 Bit) 29
,
formulaires HTML de requêtes XML 26
G
grammaires pour XML, description 29
I
informations sur la documentation 6
J
jeu de privilèges d'accès, Publication Web personnalisée 14
L
–lay.response, paramètre de requête 41
–layoutnames, commande de requête 57
lecture en direct. Voir téléchargement progressif
limite des enregistrements de rubrique de table externe 65
M
max-characters, attribut 32 max-repeat, attribut 32
MIME (Multipurpose Internet Mail Extensions), types 16
modèles de base de données disponibles 57
modèles, passage de l'un à l'autre pour une réponse XML 41
–modid, paramètre de requête 62
Modifier le mot de passe, script 15
Moteur de Publication Web
Admin Console 26 génération de documents XML 26
moteur de Publication Web
moteur de publication Web
Moteur de Publication Web personnalisée (CWPE) 24
mots de passe
aucun mot de passe de connexion 15 authentification de base pour les utilisateurs Web 15
définition pour la Publication Web personnalisée 14
script Modifier le mot de passe 15
mots-clés pour l'activation de la Publication Web personnalisée 14
N
nom de rubrique entièrement qualifié, syntaxe 51
noms d'utilisateur
authentification de base pour les utilisateurs Web 15
noms d'utilisateurs
définition pour la Publication Web personnalisée 14
noms de rubrique, syntaxe entièrement qualifiée 51
nouvelles fonctionnalités de la Publication Web personnalisée 12
Noyau de Publication Web illustré 24
numéros des codes d'erreurs des bases de données 70
O
opérateurs de comparaison des rubriques 60 opérateurs, comparaison 60
ordre de traitement de requête XML 41
P
paramètres. Voir chaînes de requête
passage d'un modèle à un autre pour une réponse XML 41
présentation
Publication Web personnalisée 7
présentation générale
étapes pour accéder aux données XML 26
privilège d'accès étendu, Publication Web personnalisée 14
Privilèges d'accès 15 protection des bases de données publiées 15
publication statique, définition 7
publication sur le Web
codes d'erreurs des bases de données 70
connexion à Internet ou à un intranet 13
objets de rubrique Conteneur 17
protection des bases de données 15
Publication Web personnalisée
accès aux solutions par les utilisateurs Web 15
activation dans le moteur de Publication Web 16
activation dans une base de données 14
,
nouvelles fonctionnalités dans 12
restriction d'accès au serveur Web à l'aide des adresses
publication Web personnalisée
utilisation d'une adresse IP statique 13
Q
–query, paramètre de requête 62
R
récapitulatif des étapes pour accéder aux données XML 26
recherche composée
–recid, paramètre de requête 63
récupération des informations de modèle 58 récupération des noms de scripts disponibles 58
récupération des noms des modèles 57
<relatedset-definition> élément 32
–relatedsets.filter, paramètre de requête 64
–relatedsets.max, paramètre de requête 65
requêtes de rubriques de table externe 54
,
requêtes pour des données XML 26
rôle des navigateurs Web dans les requêtes XML 24
Rubriques Conteneur
avec données stockées en externe 18
rubriques Conteneur
accès aux données par les utilisateurs Web 20
avec fichiers référencés 17 publication du contenu de 17
syntaxe d'URL pour accéder aux solutions XML 27
83 rubriques de type Global
rubriques globales
dans la définition de rubrique 32
S
SAT
voir Admin Console FileMaker Server 16
–script, paramètre de requête 65
–script.param, paramètre de requête 65
–script.prefind, paramètre de requête 66
–script.prefind.param, paramètre de requête 66
–script.presort, paramètre de requête 67
–script.presort.param, paramètre de requête 67
–scriptnames, commande de requête 58
scripts
astuces et considérations 20 comptes et privilèges 20 dans la Publication Web personnalisée 20
sécurité
consignes pour la protection de vos bases de données publiées 15
limitation d'accès depuis des adresses IP 16
serveur Web
prise en charge du type MIME 16
sites Web
création à l'aide du moteur de Publication Web 11
pages d'assistance FileMaker 6
–skip, paramètre de requête 67
–sortfield, paramètre de requête 68
–sortorder, paramètre de requête 68
spécification du modèle au moment d'effectuer une requête sur les données XML 41
SSL (Secure Sockets Layer), cryptage 16
suppression d’enregistrements dans une table externe 53
supprimé pour FileMaker 12
supprimée pour FileMaker 12
commande de requête –process 78
syntaxe d'URL pour
objets Conteneur dans les solutions XML 27 requêtes XML 27
T
tables externes
modifications d'enregistrements 53
nombre d'enregistrements 64 rangée initiale 64
suppression d'enregistrements 53
test
Tomcat, utilisation de fichiers journaux 48
traitement d'une requête du moteur de publication Web 8
tri des enregistrements de rubrique de table externe 64
U
utilisateurs Web
accès à des bases de données protégées 15
utilisation des données d'une rubrique Conteneur 20
utilisateurs web
configuration requise pour l'accès aux solutions de Publication Web personnalisée 13
V
vidéos QuickTime, publication sur le Web 18
W
web_server_module_log.txt, fichier journal 47
X
XML
activation dans une base de données 14
,
définitions de type de document (DTD) 30
dépannage de l'accès aux documents XML 42
génération données XML à partir d'une requête 24
<relatedset-definition> élément 32
ordre de traitement de requête 41
publication Web personnalisée 9
récapitulatif des étapes d'accès aux données XML 26
réponse, passage d'un modèle à un autre 41 requête, spécification d'un modèle 41
,
84
Lien public mis à jour
Le lien public vers votre chat a été mis à jour.
Caractéristiques clés
- Publication de bases de données FileMaker Pro sur le Web
- Intégration de données FileMaker dans d'autres sites Web
- Contrôle de l'affichage des données dans les navigateurs Web
- Échange de données FileMaker avec d'autres sites et applications via XML
- Accès aux données, aux modèles et aux rubriques basé sur les privilèges d'accès définis dans la base de données
