Enregistrer en XML

Enregistre une copie d'un fichier ouvert sous forme de représentation XML du schéma, des modèles et des scripts.

Options 

• Nom de la fenêtre spécifie le nom de la fenêtre d'un fichier ouvert. Si l'option n'est pas spécifiée, la fenêtre actuelle est utilisée.

• Fichier de destination est le chemin du fichier XML à créer. Consultez la section Création de chemins d'accès.

• Inclure les détails pour les outils d'analyse ajoute davantage d'informations dans le fichier XML.

  Cette option ajoute l'élément DDR_INFO, qui fournit des informations supplémentaires utiles aux outils tiers d'analyse de votre application personnalisée. En fonction de votre application, cette option est susceptible de générer un fichier XML très volumineux.

• Enregistrer les données binaires de chaque objet de modèle sous son nœud stocke les données binaires de chaque objet de modèle (par exemple, une image) sous le nœud de l'objet dans le fichier XML. Cela peut rendre le XML plus facile à utiliser pour certains outils, mais peut augmenter la taille du fichier XML.

  Lorsque cette option est désélectionnée, une seule référence est stockée sous le nœud de chaque objet de modèle, qui pointe vers le catalogue de données de la bibliothèque où les données binaires sont stockées. Cela peut aider à réduire la taille du fichier lorsque les mêmes données binaires sont utilisées pour de nombreux objets de modèle.

• Spécifier les options au format JSON est une expression de texte pour un objet JSON qui vous permet de spécifier les options suivantes pour cette action de script :

  • catalogs_included (tableau JSON) : un tableau de chaînes de noms de catalogue spécifiant les catalogues à inclure dans le fichier XML. S'il est omis, tous les catalogues sont inclus par défaut.

  • include_details (booléen) : cette option s'apparente à Inclure les détails pour les outils d'analyse et remplace sa valeur, si spécifiée.

  • split_catalogs (booléen) : lorsque true, crée un fichier XML distinct pour chaque catalogue spécifié dans la clé catalogs_included. Lorsque false ou omise, crée un seul fichier XML. Consultez les remarques pour obtenir des détails supplémentaires sur le comportement du catalogue fractionné.

  • standalone_binarydata (booléen) : cette option s'apparente à Enregistrer les données binaires de chaque objet de modèle sous son nœud et remplace sa valeur, si spécifiée.

  Lorsque vous sélectionnez cette option pour la première fois, FileMaker Pro génère automatiquement un calcul de modèle qui renvoie toutes les clés ci-dessus avec des valeurs par défaut, y compris tous les noms de catalogue pris en charge pour catalogs_included, que vous pouvez ensuite personnaliser.

Provient de la version 

18.0

Description 

Cette action de script revient à choisir Outils > Enregistrer une copie au format XML. Consultez la section Documentation des schémas de base de données.

Vous pouvez utiliser Spécifier les options au format JSON pour automatiser des scénarios complexes où vous devez spécifier dynamiquement les catalogues à inclure ou s'il faut diviser la sortie en plusieurs fichiers.

Remarques 

• Pour exécuter cette action de script, l'utilisateur ou le script doit disposer des privilèges d'accès intégral. Consultez la section Création et modification de scripts.

• Ce format XML peut changer d'une version de FileMaker Pro à la suivante. Lorsque vous utilisez le XML pour comparer deux versions d'un fichier FileMaker Pro, assurez-vous que la même version de FileMaker Pro est utilisée pour enregistrer chaque fichier au format XML. Si vous utilisez le XML avec d'autres outils, veillez à ce que ces outils soient conçus pour utiliser le XML enregistré par votre version de FileMaker Pro.

• Pour Spécifier les options au format JSON, lorsque split_catalogs est true :

  • L'option Fichier de destination est traitée comme un nom de dossier, et des fichiers XML distincts sont créés pour chaque catalogue spécifié dans catalogs_included. Si le dossier n'existe pas, cette action de script le crée.

  • La clé standalone_binarydata est automatiquement définie sur true lors du fractionnement des catalogues.

  • La valeur LibraryCatalog est ignorée même si elle est spécifiée dans catalogs_included.

• Si Spécifier les options au format JSON contient une erreur de formatage, l'action de script renvoie le code d'erreur 878 ("Les données JSON spécifiées pour Options contiennent une erreur de formatage et n'ont pas pu être analysées").

Exemple 1 

Enregistre une copie du fichier ouvert dont le nom de la fenêtre est Inventaire en un fichier XML.

Enregistrer en XML [ Nom de la fenêtre: "Inventaire" ; Fichier de destination: "Inventaire.xml" ]

Exemple 2 

Enregistre uniquement les scripts, les modèles et les fonctions personnalisées du fichier spécifié par la fenêtre actuelle dans un fichier XML en utilisant Spécifier les options au format JSON.

Définir variable [ $optionsJson ; Valeur:
  JSONSetElement ( "{}" ;
    [ "catalogs_included" ; JSONMakeArray (
      "ScriptCatalog LayoutCatalog CustomFunctionsCatalog" ;
      " " ; JSONString ) ; JSONArray ] ;
    [ "include_details" ; False ; JSONBoolean ] ;
    [ "split_catalogs" ; False ; JSONBoolean ] ;
    [ "standalone_binarydata" ; False ; JSONBoolean ]
  )
]

Enregistrer en XML [ Nom de la fenêtre: ; Fichier de destination: "MyApp_Schema.xml" ; Inclure les détails pour les outils d'analyse ; Spécifier les options au format JSON: $optionsJson ]

Notez que même si l'option Inclure les détails pour les outils d'analyse est sélectionnée lors de l'action de script, elle est remplacée par la clé include_details dans Spécifier les options au format JSON (si définie sur False).

Exemple 3 

Enregistre les scripts, modèles et rubriques dans des fichiers XML distincts dans un dossier nommé "MyApp_SaveAsXML".

Définir variable [ $optionsJson ; Valeur:
  JSONSetElement ( "{}" ;
    [ "catalogs_included" ; JSONMakeArray (
      "ScriptCatalog LayoutCatalog FieldCatalog" ;
      " " ; JSONString ) ; JSONArray ] ;
    [ "include_details" ; True ; JSONBoolean ] ;
    [ "split_catalogs" ; True ; JSONBoolean ]
  )
]

Enregistrer en XML [ Nom de la fenêtre: ; Fichier de destination: "MyApp_SaveAsXML" ; Spécifier les options au format JSON: $optionsJson ]

Cela crée un dossier nommé "MyApp_SaveAsXML" contenant trois fichiers :

• MyApp_SaveAsXML_ScriptCatalog.xml
• MyApp_SaveAsXML_LayoutCatalog.xml
• MyApp_SaveAsXML_FieldCatalog.xml

Rubriques connexes 

• Page de référence des actions de script