Chapitre 5 Stockage, test et suivi d'un site. Filemaker Server 13

ドキュメント

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 :

1. Suivez toutes les étapes mentionnées dans le chapitre 3, « Préparation des bases de données pour la Publication Web personnalisée ».

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.

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.

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.

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 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.

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.

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.

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.

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

l'URL. Pour plus d'informations sur la syntaxe d'URL, consultez la section « A propos de la syntaxe d'URL pour les données XML et les objets de type Conteneur », page 27.

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.

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

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">

<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 :

Journaux d'erreurs et d'accès au serveur Web

Journal du moteur de publication Web

Journal d'erreurs du module de serveur Web

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 :

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.

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ù :

[TIMESTAMP_GMT]

correspond aux date et heure de la saisie, à l'heure de Greenwich (GMT).

[WPC_HOSTNAME]

est le nom de la machine sur laquelle le moteur de publication Web est installé.

[CLIENT_IP:PORT]

est l'adresse IP et le port client d'origine de la requête XML.

[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

[MODULE_TYPE]

est soit : XML, pour la publication Web personnalisée, ou PHP, pour la

Publication Web personnalisée avec requête PHP.

[SEVERITY]

est soit INFO, désignant un message d'information ou ERREUR, désignant un message d'erreur.

[FM_ERROR_CODE]

est le numéro d'erreur renvoyé pour un message d'erreur. Le numéro

d'erreur peut être un code erreur des bases de données FileMaker (voir « Numéros des codes d'erreur des bases de données FileMaker », page 70).

En outre, le numéro d'erreur peut être un numéro HTTP, précédé de la chaîne « HTTP: »

[RETURN_BYTES]

est le nombre d'octets renvoyés par la requête.

[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 :

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é.

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"

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"

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é.

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 :

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.

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

(Voir , page 66.)

–script.presort

(Voir , page 67.)

–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 :

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.

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.

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.

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).

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.

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 :

Le point ne peut pas être suivi d'un chiffre. Par exemple, myfield.9 est un nom de rubrique invalide.

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.

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, comme décrit dans la section « A propos de la syntaxe d'un nom de rubrique entièrement qualifié », ci-dessous.

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ù :

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

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.

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.

Consultez les sections « Ajout d'enregistrements à une table externe », et « Modification d'enregistrements dans une table externe ». Le paramètre record-id est requis pour les

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 :

Utilisez le nom de rubrique entièrement qualifié pour la rubrique de table externe correspondante.

Spécifiez 0 en guise d'ID d'enregistrement après le nom de la rubrique de table externe liée.

Spécifiez au moins une des rubriques pour l'enregistrement parent, avant de spécifier la rubrique de table externe liée.

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

et field-name(repetition-number), consultez la section « A propos de la syntaxe d'un nom de rubrique entièrement qualifié », page 51. Pour plus d'informations sur les rubriques

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 :

Le paramètre de requête –query

Les déclarations de demande de requête, composées de l'identificateur de requête et des opérations de demande.

Le champ de recherche et les définitions de valeur pour chaque identificateur de requête.

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

Définissez les valeurs d'identifiant avec le paramètre. Par exemple : q1.value=fieldvalue

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*

La commande –findquery, à la fin de l'instruction complète.

Pour plus d'informations sur l'utilisation du paramètre –query, consultez la section « Commande de requête –query (requête de recherche composée) », page 62.

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.

Consultez la section « A propos de la syntaxe d'URL pour les données XML et les objets de type Conteneur », page 27.

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é.

Le point ne peut pas être suivi d'un chiffre. Par exemple, myfield.9 est un nom de rubrique invalide.

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.

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,

comme décrit dans la section « A propos de la syntaxe d'un nom de rubrique entièrement qualifié », page 51.

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

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ù :

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.

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

de tables externes, consultez la section « Paramètre de requête –relatedsets.max (limitation d'enregistrements de table externe) », page 65.

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.

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

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 ».

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.

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.

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

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é.

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

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.

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

Nombre de rangées

spécifiées dans la boîte de dialogue Table externe sont ignorées.

Remarques :

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.

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.

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.

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.

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,

consultez la rubrique « Paramètre de requête –relatedsets.filter (filtrage d'enregistrements de table externe) » ci-dessus.

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.

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

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

Si votre requête contient –script.param sans –script, alors –script.param est ignoré.

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.

URL de la façon suivante : param1%7Cparam2%7Cparam3

Si votre requête contient –script.prefind.param sans –script.prefind, alors

–script.prefind.param

est ignoré.

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.

URL de la façon suivante : param1%7Cparam2%7Cparam3

Si votre requête contient –script.presort.param sans –script.presort, alors

–script.presort.param

est ignoré.

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

doit commencer par 1.

doit s'incrémenter de façon séquentielle.

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ù :

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.

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">

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">

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

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

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

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

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

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 :

Nom de base de données non valide

Le fichier est fermé dans FileMaker Server

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

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)

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)

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 :

–process

Les paramètres de requête suivants ont été supprimés pour FileMaker 12 :

–encoding

–grammar

–stylehref

–styletype

–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

l'ordre d'analyse des commandes de requêtes, consultez la section « Analyse de commande de requête », page 51.

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 :

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.

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

Ignore les esperluettes doubles ou les paramètres vides dans une requête. FileMaker 11 renvoie une erreur.

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.

Ignore le paramètre field.op dans une requête autre que –find. FileMaker 11 remplace la rubrique par le paramètre field.op.

Ignore toutes les rubriques non globales transmises pour les commandes –findany,

–findall

, –find avec recid, –findquery, –delete et –dup.

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 :

modifie les rubriques de type Global pour les commandes –findall, –findany, –find,

–findquery

, –new, –edit et –dup.

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.

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.

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.

Renvoie des secondes décimales pour les rubriques de date, d'heure et d'horodatage.

FileMaker 11 renvoie des secondes entières.

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.

400 (Les critères de recherche sont vides)

Index

activation Publication Web personnalisée dans base de données 14

Admin Console 16

Admin Console FileMakerServer 16

API FileMaker pour PHP 9

authentification de base, Web 15 authentification des utilisateurs Web 15

auto-enter, attribut 32

Avantages de PHP 9

bases de données, protection après publication 15

Caractères ASCII, dans les documents XML 39

Caractères Unicode 39

chaînes de requête

ajout d'enregistrements à des tables externes 52

commandes et paramètres 39

consignes 50

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

demande de données XML 39

codage

données XML 29

URL 29

codage de texte

données XML générées 29

URL 29 codage de texte URL 29

codes d'erreurs des bases de données 30

commande de requête –process, supprimée pour FileMaker

12 78

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

compte Invité 15

scripts 20

configuration de la publication Web personnalisée 12

création d'un nouvel enregistrement 57

<datasource> élément 31

–db, paramètre de requête 58

–dbnames, commande de requête 55

déclencheurs 22

définitions de type de document (DTD) 30

–delete, commande de requête 55

dépannage

accès aux documents XML 42

sites de Publication Web personnalisée 44

documentation 6 documentation électronique 6 documentation en ligne 6 documentation JDBC 6 documentation ODBC 6 documentation relative à l'installation 6

dossier Web, copie des objets de rubrique Conteneur 17

–dup, commande de requête 55

–edit, commande de requête 55

é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

espaces de nom pour XML 30

exemples

grammaire FMPXMLLAYOUT générée 38

grammaire FMPXMLRESULT générée 35

grammaire fmresultset générée 33

exportation de données XML 23

Extensible Markup Language (XML). Voir XML

feuilles de style, test 44 fichiers journaux 44

accès au serveur Web 45 description 45

Tomcat 48

web_server_module_log.txt 47

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

<field-definition> élément 32

–fieldname.op, paramètre de requête 60

FileMaker Server

documentation 6 installation 6

FileMaker WebDirect

définition 7

documentation 6

FileMakerPro, différences avec le moteur de publication

Web 23

filtrage des enregistrements des rubriques de table externe 64

–find, commande de requête 56

–findall, commande de requête 56

–findany, commande de requête 56

–findquery, commande de requête 56

FMPXMLLAYOUT, grammaire 23

–

FMPXMLRESULT, grammaire 23

–

fmresultset, grammaire 23

–

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

four-digit-year, attribut 32

grammaires pour XML, description 29

importation de données XML 23

informations sur la documentation 6

jeu de privilèges d'accès, Publication Web personnalisée 14

journal d'application 46

–lay, paramètre de requête 41

–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

–lop, paramètre de requête 61

–max, paramètre de requête 62

max-characters, attribut 32 max-repeat, attribut 32

<metadata> élément 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

génération de données XML 24

moteur de Publication Web

avantages du 11

description 8

journal d'application 46

traitement d'une requête 8

moteur de publication Web

codes d'erreurs générés 70

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

name, attribut 32

–new, commande de requête 57

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

not-empty, attribut 32

nouvelles fonctionnalités de la Publication Web personnalisée 12

Noyau de Publication Web illustré 24

numeric-only, attribut 32

numéros des codes d'erreurs des bases de données 70

opérateurs de comparaison des rubriques 60 opérateurs, comparaison 60

ordre de traitement de requête XML 41

paramètre de requête –encoding, supprimé pour FileMaker 12 78 paramètre de requête –grammar, supprimé pour FileMaker 12 78 paramètre de requête –stylehref, supprimé pour FileMaker 12 78 paramètre de requête –styletype, supprimé pour FileMaker 12 78 paramètre de requête –token, supprimé pour FileMaker 12 78

paramètres. Voir chaînes de requête

passage d'un modèle à un autre pour une réponse XML 41

PDF 6

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

configuration requise pour 12

connexion à Internet ou à un intranet 13

objets de rubrique Conteneur 17

protection des bases de données 15

utilisation de données XML 26

vidéos QuickTime 18

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

avec PHP 9 avec XML 9

compte Invité 15

configuration requise pour 12

définition 7

nouvelles fonctionnalités dans 12

présentation 7

privilège étendu pour 14

restriction d'accès au serveur Web à l'aide des adresses

IP 16

scripts 22

utilisation de scripts 20

publication Web personnalisée

utilisation d'une adresse IP statique 13

–query, paramètre de requête 62

récapitulatif des étapes pour accéder aux données XML 26

recherche composée

commande de requête 56

paramètre de requête 62

–recid, paramètre de requête 63

Reconnexion, script 15

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

requêtes de rubriques de table externe 54

requêtes pour des données XML 26

result, attribut 32

<resultset> élément 32

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

syntaxe 54

rubriques globales

dans la définition de rubrique 32

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

déclencheurs 22

Modifier le mot de passe 15

pour des requêtes XML 26

Reconnexion 15

scripts disponibles 58

sécurité

comptes et mots de passe 16

consignes pour la protection de vos bases de données publiées 15

documentation 8

limitation d'accès depuis des adresses IP 16

serveur Web

fichiers journaux 45

prise en charge du type MIME 16

rôle dans les requêtes XML 24

sites Web

création à l'aide du moteur de Publication Web 11

pages d'assistance FileMaker 6

suivi 45

test 44

–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

suivi des sites Web 45

suppression d’enregistrements dans une table externe 53

supprimé pour FileMaker 12

paramètre de requête –encoding 78 paramètre de requête –grammar 78 paramètre de requête –stylehref 78 paramètre de requête –styletype 78 paramètre de requête –token 78

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

tables externes

ajout d'enregistrements 52

modèle 64

modifications d'enregistrements 53

nombre d'enregistrements 64 rangée initiale 64

suppression d'enregistrements 53

tri d'enregistrements 64

téléchargement progressif 17

test

sites Web 44 sorties XML 44

time-of-day, attribut 32

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

type, attribut 32

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

vidéos QuickTime, publication sur le Web 18

–view, commande de requête 58

web_server_module_log.txt, fichier journal 47

XML

activation dans une base de données 14

analyseurs 26

avantages 10

chaînes de requête 39

codage au format UTF-8 29

codage de texte URL 29

définitions de type de document (DTD) 30

dépannage de l'accès aux documents XML 42

description 23

espaces de nom 30

génération données XML à partir d'une requête 24

grammaire FMPXMLLAYOUT 36

grammaire FMPXMLRESULT 34

grammaire fmresultset 31

<datasource> élément 31

<field-definition> élément 32

<metadata> élément 32

<relatedset-definition> élément 32

<resultset> élément 32

grammaires comparées 29

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

requêtes pour des données 26

spécification XML 1.0 23

<xsl:stylesheet> élément 44

<xsl:template> élément 44

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

Suivi de votre site

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

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

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

Index

関連

Filemaker Server 14 Manuel utilisateur

FileMaker Server 12: Guide XML + Chat IA

FileMaker Server 10 : Guide de Publication Web

FileMaker Server 12 Guide PHP + Assistance IA et PDF

FileMaker Serveur 9: Guide PHP + Chat IA & Accès PDF

FileMaker Server 11 : Guide PHP + Chat IA

Filemaker Server 14 Manuel utilisateur

Filemaker Server 11 Manuel utilisateur

Filemaker Pro 13 Manuel utilisateur

Filemaker Server 12 Manuel utilisateur

Guide FileMaker 12 Publication Web Instantanée | IA

Filemaker Pro 11 Manuel utilisateur