Enregistrement, importation et exportation de données > Importation de données dans FileMaker Pro Advanced > Importation de données XML
 

Importation de données XML

FileMaker Pro Advanced vous permet d'importer des données XML dans un fichier FileMaker Pro Advanced existant ou de convertir ces données en un nouveau fichier FileMaker Pro Advanced.

Les données XML peuvent correspondre à un fichier physique ou au résultat d'une requête HTTP envoyée à un serveur Web. Par exemple, vous pouvez configurer une base de données Commandes pour l'envoi de numéros de suivi à une société de livraison sous la forme d'une requête HTTP et pour que le serveur Web de cette société vous renvoie les dernières informations de suivi de livraison au format XML que vous pourrez alors importer dans votre base de données Commandes.

Les données XML importées doivent être conformes à la définition du type de document (DTD) FMPXMLRESULT de FileMaker. Si le format de vos données XML est différent, vous pouvez appliquer une feuille de style XSLT (Extensible Stylesheet Language) pendant l'importation pour convertir vos données XML dans la grammaire FMPXMLRESULT. Consultez la section Format XML.

Pour importer des données XML :

1. La première étape varie selon que vous souhaitez importer des données XML dans un fichier FileMaker Pro Advanced ou convertir les données XML en un nouveau fichier FileMaker Pro Advanced.

 

Importation de données XML

Faites ceci

Dans un fichier FileMaker Pro Advanced existant

Passez à l'étape 2.

En convertissant les données XML en un nouveau fichier FileMaker Pro Advanced

Passez à l'étape 8.

2. Si vous mettez à jour des enregistrements existants ou correspondants, créez une copie de sauvegarde du fichier cible dans lequel vous allez importer les données.

Important  La mise à jour d'enregistrements existants ou correspondants écrase les données du fichier cible et est irréversible. Choisissez le menu Fichier > Enregistrer une copie pour créer une copie de sauvegarde du fichier cible. Vous pouvez effectuer cette opération uniquement pour un fichier local (se trouvant sur votre ordinateur). Familiarisez-vous avec le mode de fonctionnement de la procédure de mise à jour des enregistrements. Consultez la section Importation de données dans FileMaker Pro Advanced.

3. Ouvrez le fichier FileMaker Pro Advanced dans lequel vous souhaitez importer les enregistrements (fichier cible).

4. Si le fichier cible comporte plusieurs tables, utilisez le menu local Modèle pour afficher un modèle présentant les enregistrements de la table dans laquelle vous voulez importer les données.

5. Si vous mettez à jour des enregistrements existants ou correspondants, procédez comme ci-après avant d'effectuer l'importation. (Si vous ajoutez de nouveaux enregistrements, passez directement à l'étape suivante.)

Si vous mettez à jour des enregistrements existants dans le fichier, assurez-vous que le jeu d'enregistrements trouvés ne contient que les enregistrements à remplacer. Triez les enregistrements (par exemple, par nom de rubrique) pour vous assurer que les données importées remplaceront les enregistrements appropriés dans le fichier cible.

Si vous mettez à jour des enregistrements correspondants, assurez-vous que le jeu d'enregistrements trouvés ne contient que les enregistrements à mettre à jour. Les enregistrements non inclus dans le jeu d'enregistrements trouvés ne seront pas mis à jour, même si les données des rubriques sources correspondent.

6. Choisissez le menu Fichier > Importer des enregistrements > Source de données XML.

Cette opération affiche la boîte de dialogue Définir les options XML et XSL.

7. Passez à l'étape 10.

Ne suivez les étapes 8 à 9 que si vous convertissez les données XML en un nouveau fichier FileMaker Pro Advanced.

8. Choisissez le menu Fichier > Ouvrir.

9. Dans la boîte de dialogue Ouvrir fichier, choisissez Type (Windows) ou Afficher (macOS) et sélectionnez Source de données XML.

Cette opération affiche la boîte de dialogue Définir les options XML et XSL.

10. Dans la zone Définir la source des données XML, sélectionnez la source des données XML à importer.

La source XML peut correspondre à un fichier ou au résultat d'une requête HTTP.

11. Pour appliquer une feuille de style XSLT aux données XML avant l'importation, activez la case à cocher Utiliser la feuille de style XSL, puis définissez la source de la feuille de style XSLT.

Lorsque les données XML que vous importez ne sont pas conformes à la DTD FMPXMLRESULT, vous devez appliquer une feuille de style XSLT qui convertit les données XML dans la grammaire appropriée. La source XSLT peut correspondre à un fichier ou au résultat d'une requête HTTP.

12. Cliquez sur Continuer.

À l'aide d'un analyseur XSLT reposant sur Xerces et d'un processeur XSLT reposant sur Xalan, FileMaker Pro Advanced applique une feuille de style XSLT (si vous en avez spécifié une) pour transformer les données XML. Si un message d'erreur s'affiche, corrigez l'erreur, puis tentez de recommencer l'importation.

13. Effectuez l'une des opérations suivantes :

 

Si vous importez des données XML

Faites ceci

Dans un fichier FileMaker Pro Advanced existant

Dans la boîte de dialogue Ordre d'importation des rubriques qui s'affiche, choisissez le type d'importation à effectuer, puis mettez en correspondance les rubriques de votre base de données avec les données à importer. (voir Définition de l'opération d'importation et mise en correspondance des rubriques pendant l'importation). Sélectionnez des options dans la boîte de dialogue, puis cliquez sur Importer.

En convertissant les données XML en un nouveau fichier FileMaker Pro Advanced

La boîte de dialogue Nom du fichier converti s'affiche. Entrez le nom du nouveau fichier, sélectionnez un emplacement, puis cliquez sur Enregistrer.

Remarques 

Pour plus de détails sur les conditions requises pour la formation des données XML, reportez-vous à la spécification XML disponible à l'adresse www.w3.org/XML/.

FileMaker Pro Advanced utilise l'analyseur XML Xerces-C++ qui prend en charge les données XML dans les codages de caractères suivants :

ASCII

UTF-8

UTF-16 (Big/Small Endian)

UCS4 (Big/Small Endian)

EBCDIC en codage IBM037 et IBM1140

ISO-8859-1 (Latin1)

Windows-1252

Bien que Windows-1252 constitue le codage de caractère par défaut de Windows, ce codage n'est pas communément reconnu par d'autres outils de traitement de données XML. Si vous utilisez un outil d'édition Windows pour générer des données XML, vérifiez la déclaration encoding=« ... » pour connaître le jeu de caractères qu'il génère. Consultez la liste de questions-réponses (FAQ) concernant Xerces C++ sur le site Web d'Apache à l'adresse xerces.apache.org/xerces-c/.

Si vous générez le chemin du fichier XML à partir d'un calcul, vous devez utiliser le format que le système d'exploitation utilise pour le chemin d'accès complet. Par exemple, les chemins valides suivants :

Windows : lettreLecteur:/NomRépertoire/NomFichier

macOS : /Volumes/NomVolume/NomRépertoire/NomFichier

Si vous concevez une solution multiplateforme, vous pouvez utiliser la fonction Obtenir (PlateformeSystème) pour identifier la plateforme actuelle et utiliser le format approprié à chaque plateforme.