Go to Contents
Page
précédente
 Page
suivante
Table des matières > Enregistrement, importation et exportation de données > Formats de fichier d'importation/exportation pris en charge > Grammaire XML FMPXMLRESULT
Grammaire XML FMPXMLRESULT
La grammaire FMPXMLRESULT contient plus d'informations sur la base de données que la grammaire FMPDSORESULT, comme le nombre d'enregistrements ainsi que le type et le format des rubriques. Ces éléments et attributs sont nécessaires pour que les données XML soient correctement validées.
Utilisez la grammaire FMPXMLRESULT si vous avez besoin des informations de métadonnées METADATA fournies par cette grammaire. FileMaker Pro prenant en charge à la fois l'importation et l'exportation de données dans la grammaire FMPXMLRESULT, ce format se révèle bien adapté au transfert de données entre fichiers FileMaker Pro.
Remarque   En revanche, l'utilisation de la grammaire FMPXMLRESULT n'est pas recommandée avec l'emploi de feuilles de style en cascade (CSS). Si vous souhaitez utiliser des feuilles de style en cascade (CSS) avec vos données XML, utilisez la grammaire FMPDSORESULT.
Dans la grammaire FMPXMLRESULT, l'élément DATABASE contient les attributs NAME, RECORDS, DATEFORMAT, LAYOUT et TIMEFORMAT.
L'attribut DATEFORMAT spécifie le format des dates dans le document XML.
Rubrique Forme complète Forme abrégée
Année
aaaa (4 chiffres)
aa (2 chiffres)
Mois
mm (2 chiffres)
M (1 ou 2 chiffres)
Jour
jj (2 chiffres)
j (1 ou 2 chiffres)
L'attribut TIMEFORMAT spécifie le format des heures dans le document XML.
Rubrique Forme complète Forme abrégée
Heure (1 - 12)
hh (2 chiffres)
h (1 ou 2 chiffres)
Heure (1 - 24)
kk (2 chiffres)
k (1 ou 2 chiffres)
Minutes
mm
 
Secondes
ss
 
AM/PM
a
 
L'élément METADATA comporte un ou plusieurs éléments FIELD, contenant chacun des informations pour l'une des rubriques/colonnes, dont le nom de la rubrique définie dans la base de données, le type de rubrique, la tolérance du choix Oui ou Non pour les rubriques vides (attribut EMPTYOK), ainsi que le nombre maximal de valeurs de rubriques multivaluées (attribut MAXREPEAT). Les valeurs autorisées pour les types de rubriques sont les suivantes : TEXT, NUMBER, DATE, TIME, TIMESTAMP et CONTAINER.
L'élément RESULTSET contient tous les éléments ROW spécifiant les données d'enregistrement dans le format XML. Chaque élément ROW contient les données des rubriques/colonnes d'une ligne des résultats, dont les numéros d'identification d'enregistrement et de modification pour la ligne, ainsi que l'élément COL contenant les données d'une rubrique/colonne de la ligne (où plusieurs éléments DATA représentent l'une des valeurs d'une rubrique multivaluée ou d'une rubrique de table externe).
L'exportation de données XML ne prend pas en charge l'exportation des données de rubriques Multimédia.
Du fait des limitations XML, l'application ne peut exporter qu'un seul enregistrement de chaque rubrique liée.
L'ordre des éléments COL correspond à celui des éléments FIELD de l'élément METADATA. Exemple : lorsque les éléments « Prénom », « Nom » et « Service » sont répertoriés sous l'élément METADATA, les valeurs « Jean », « Bonbeurre » et « Ingénierie » sont répertoriées dans le même ordre sous l'élément RESULTSET ROW.
Remarques
Avant d'importer les données XML, FileMaker Pro utilise un analyseur XML Xerces et un processeur XSLT Xalan pour effectuer les vérifications d'erreurs suivantes sur les données XML (et XSL le cas échéant) :
Vérification de la forme des données XML. Pour plus d'informations, consultez la spécification XML à l'adresse : http://www.w3.org/XML/.
Validation éventuelle de la source de données XML à importer par rapport à sa définition de type de document (DTD).
Si vous spécifiez une feuille de style XSLT, application de cette dernière pour convertir les données XML.
Validation des données XML par rapport à la DTD FMPXMLRESULT fournie par FileMaker.
Avant que les données XML soient présentées dans le format FMPXMLRESULT et validées par rapport à la DTD FileMaker, elles ne peuvent pas contenir de DTD interne. Toute DTD interne (même la DTD FMPXMLRESULT) entraîne l'affichage d'un message d'erreur par l'analyseur ainsi que l'interruption du processus d'importation. Même si les données XML contiennent une référence à une DTD externe, l'analyseur ignore simplement cette dernière en faveur de la DTD FMPXMLRESULT.
Bien que les données XML que vous importez doivent respecter la grammaire FMPXMLRESULT, certains éléments et attributs ne sont pas utilisés pendant l'importation. Ces éléments et attributs sont nécessaires pour que les données XML soient correctement validées. Le tableau ci-dessous définit les éléments et attributs utilisés pendant l'importation des données XML et répertorie les valeurs par défaut autorisées pour les attributs. Dans la plupart des cas, les valeurs d'attribut peuvent être nulles (par exemple, TIMEFORMAT=""), mais les attributs TYPE et EMPTYOK requièrent une valeur. En outre, l'élément FMPXMLRESULT doit toujours déclarer l'espace de nom FileMaker pour la grammaire.
Elément Attributs Utilisé pendant l'importation de données XML Valeur par défaut
FMPXMLRESULT
 
Oui
xmlns="http://www.filemaker.com/ fmpxmlresult"
ERRORCODE
 
Non
 
PRODUCT
 
Non
" "
 
NAME
Non
" "
 
VERSION
Non
" "
 
BUILD
Non
" "
DATABASE
 
Non
 
 
NAME
Non
" "
 
RECORDS
Non
" "
 
DATEFORMAT
Non
" "
 
TIMEFORMAT
Non
" "
 
LAYOUT
Non
" "
METADATA
 
Oui
 
    FIELD
 
Oui
 
 
NAME
Oui
" "
 
TYPE
Oui
"TEXTE", "DATE", "NOMBRE", "HEURE", "HORODATAGE" ou "MULTIMEDIA"
 
EMPTYOK
Non
"OUI" ou "NON"
 
MAXREPEAT
Non
" "
RESULTSET
 
Oui
 
 
FOUND
Non
" "
    ROW
 
Oui
 
 
RECORDID
Non
" "
 
MODID
Non
" "
    COL
 
Oui
 
      DATA
 
Oui
 
Exemple de données XML dans la grammaire FMPXMLRESULT
L'exemple ci-dessous présente des données XML générées dans la grammaire FMPXMLRESULT. Pour obtenir tous les détails sur la définition de type de document (DTD) correspondant à cette grammaire, consultez le fichier fmpxmlresult_dtd.htm, situé dans le sous-dossier Extras en Français du dossier d'installation de l'application FileMaker Pro.

<?xml version="1.0" encoding="UTF-8"?>
<FMPXMLRESULT xmlns="http://www.filemaker.com/fmpxmlresult">
   <ERRORCODE>0</ERRORCODE> 
   <PRODUCT BUILD="23/5/2002" NAME="FileMaker Pro"
   VERSION="7.0"/>
   <DATABASE DATEFORMAT="jj/MM/aa" LAYOUT="récapitulatif"
   NAME="Employés.fp7" RECORDS="23" TIMEFORMAT="hh:mm:ss"/>
   <METADATA>
      <FIELD EMPTYOK="NON" MAXREPEAT="1" NAME="Prénom" TYPE="TEXTE"/>
      <FIELD EMPTYOK="NON" MAXREPEAT="1" NAME="Nom" TYPE="TEXTE"/>
      <FIELD EMPTYOK="OUI" MAXREPEAT="1" NAME="Service" TYPE="TEXTE"/>
   </METADATA>
   <RESULTSET FOUND="2">
      <ROW MODID="47" RECORDID="34"> 
         <COL>
            <DATA>Jean</DATA>
         </COL>
         <COL>
            <DATA>Bonbeurre</DATA>
         </COL>
         <COL>
            <DATA>Ingénierie</DATA>
         </COL>
      </ROW>
      <ROW MODID="89" RECORDID="78">
         <COL> 
            <DATA>Suzanne</DATA>
         </COL>
         <COL>
            <DATA>Jourdan</DATA>
         </COL>
         <COL>
            <DATA>Marketing
            </DATA>
         </COL>
      </ROW>
   </RESULTSET>
</FMPXMLRESULT>
Table des matières > Enregistrement, importation et exportation de données > Formats de fichier d'importation/exportation pris en charge > Grammaire XML FMPXMLRESULT
Page
précédente
 Page
suivante