Importation de données XML

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

Les données XML peuvent correspondre à un fichier 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 ou convertir les données XML en un nouveau fichier FileMaker Pro.

    2. Importation de données XML

    Faites ceci

    Dans un fichier FileMaker Pro existant

    Passez à l'étape 2.

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

    Passez à l'étape 8.
  2. Si vous mettez à jour des enregistrements correspondants ou remplacez des enregistrements existants, créez une copie de sauvegarde du fichier cible.

    Important  La mise à jour d'enregistrements correspondants ou le remplacement d'enregistrements existants écrase les données du fichier cible et est irréversible. Pour conserver vos données, choisissez le menu Fichier > Enregistrer une copie pour créer une copie de sauvegarde du fichier FileMaker Pro 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 ou de remplacement des enregistrements. Consultez la section Importation de données dans FileMaker Pro.

  3. Dans FileMaker Pro, ouvrez le 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 correspondants ou remplacez des enregistrements existants, 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 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.
    • Si vous remplacez des enregistrements existants dans le fichier, assurez-vous que le jeu d'enregistrements trouvés ne contient que les enregistrements à modifier. Au besoin, triez les enregistrements pour que les données de chaque enregistrement du fichier cible soient remplacées par les données de l'enregistrement approprié dans le fichier source.
  6. Choisissez le menu Fichier > Importer 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.

  8. Choisissez le menu Fichier > Ouvrir.
  9. Dans la boîte de dialogue Ouvrir fichier, choisissez Types de fichiers (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 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. Choisissez le type d'importation à effectuer et mettez en correspondance les rubriques du fichier cible avec les données que vous souhaitez importer à partir du fichier source. (Consultez la section 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.

    Si vous convertissez le fichier XML en un nouveau fichier FileMaker Pro, saisissez le nom du nouveau fichier, choisissez un emplacement, puis cliquez sur Enregistrer.

Remarques 

  • Pour plus d'informations 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 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ères 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/.

  • Dans l'action de script Importer enregistrements, lorsque vous spécifiez Données XML comme source de données, vous pouvez indiquer les chemins d'accès des données XML et de la feuille de style XSL de deux manières différentes :
    • Pour Fichier, le chemin d'accès doit être au format FileMaker (consultez la section Création de chemins d'accès).
    • Pour Calcul, le chemin d'accès doit être le chemin d'accès complet au format du système d'exploitation. Par exemple :

      Windows : lettreLecteur:\NomRépertoire\NomFichier

      macOS : /NomRépertoire/NomFichier

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