Exporter un document d’espace de travail XML (Gestion des données)

Résumé

Crée un document XML lisible du contenu de la géodatabase.

Le document d’espace de travail XML est utile pour partager des structures de géodatabase ou copier des structures de géodatabase d’un type vers un autre.

Utilisation

  • Il est possible de créer la sortie en tant que fichier XML ou que fichier zip compressé qui contient le fichier XML. Pour créer un fichier XML, attribuez une extension .xml au nom du fichier en sortie. Pour créer un fichier ZIP compressé, attribuez une extension .zip ou .z au nom du fichier en sortie.

  • Attention :
    Le document d'espace de travail XML en sortie peut être très volumineux lorsque vous copiez à la fois les données et la structure. Généralement, cette solution n'est pas recommandée pour copier des données de géodatabase. Les autres possibilités pour copier une géodatabase sont notamment l'utilisation de l'outil Copier ou Découper pour extraire des sous-ensembles des données. En outre, le jeu d’outils Paquetage propose des outils pour consolider, empaqueter et partager des couches, des cartes, des localisateurs d’adresses et des résultats de géotraitement.
  • Si l'entrée est un géodatabase ou un jeu de classes d'entités, tous les éléments de données contenus dans cet espace de travail sont exportés. Si vous souhaitez exporter uniquement un sous-ensemble d'éléments de données vers un fichier XML, vous devrez les copier vers une nouvelle géodatabase à exporter.

  • Si vous exportez une classe d'entités dans un réseau, une topologie, une classe de relations ou un MNT, toutes les classes d'entités qui font partie du réseau, de la topologie, de la classe de relations ou du MNT sont également exportées.

  • Les messages d'outil incluront la liste des noms d'éléments de données exportés.

Syntaxe

arcpy.management.ExportXMLWorkspaceDocument(in_data, out_file, {export_type}, {storage_type}, {export_metadata})
ParamètreExplicationType de données
in_data
[in_data,...]

Les jeux de données en entrée à exporter et représenter dans un document d'espace de travail XML. Les données en entrée peuvent être une géodatabase, un jeu de classes d’entités, une classe d’entités, une table, un raster ou un catalogue d’images. S’il existe plusieurs entrées, elles doivent provenir du même espace de travail. Les entrées provenant de plusieurs espaces de travail ne sont pas prises en charge.

Feature Class; Feature Dataset; Raster Dataset; Table; Workspace
out_file

Fichier de document d'espace de travail XML à créer. Il peut s'agir d'un fichier XML (.xml) ou d'un fichier ZIP compressé (.zip ou .z).

File
export_type
(Facultatif)

Détermine si le document d'espace de travail XML en sortie contiendra toutes les données de l'entrée (table et enregistrements de classe d'entités, y compris la géométrie) ou uniquement la structure.

  • DATAExporter à la fois la structure et les données. Il s’agit de l’option par défaut.
  • SCHEMA_ONLYExporte uniquement la structure.
String
storage_type
(Facultatif)

Détermine comment la géométrie de l'entité est stockée lorsque les données sont exportées depuis une classe d'entités.

  • BINARYLa géométrie est stockée dans un format binaire en base64 compressé. Ce format binaire produit un document d'espace de travail de XML plus petit. Utilisez cette option lorsque le document d'espace de travail XML doit être lu par un programme personnalisé utilisant ArcObjects. Il s’agit de l’option par défaut.
  • NORMALIZEDLa géométrie sera stockée dans un format non comprimé, ce qui génère un plus grand fichier. Utilisez cette option lorsque le document d'espace de travail XML doit être lu par un programme personnalisé n'utilisant pas ArcObjects.
String
export_metadata
(Facultatif)

Détermine si les métadonnées sont exportées.

  • METADATASi l'entrée contient des métadonnées, elles sont exportées. Il s’agit de l’option par défaut.
  • NO_METADATANe pas exporter les métadonnées.
Boolean

Exemple de code

Exemple 1 de la fonction ExportXMLWorkspaceDocument (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil ExportXMLWorkspaceDocument en mode immédiat.

import arcpy
arcpy.ExportXMLWorkspaceDocument_management('c:/data/StJohns.gdb', 
                                            'c:/data/StJohns.xml', 
                                            'SCHEMA_ONLY', 'BINARY', 'METADATA')
Exemple 2 d'utilisation de la fonction ExportXMLWorkspaceDocument (script autonome)

Le script Python ci-dessous illustre l'utilisation de l'outil ExportXMLWorkspaceDocument dans un script autonome.

# Name: ExportXMLWorkspaceDocument.py
# Description: Exports the contents of my geodatabase to an XML workspace document. 
# Import system modules
import arcpy
# Set local variables
in_data = 'c:/data/StJohns.gdb'
out_file = 'c:/data/StJohns.xml'
export_option = 'SCHEMA_ONLY'
storage_type = 'BINARY'
export_metadata = 'METADATA'
# Execute ExportXMLWorkspaceDocument
arcpy.ExportXMLWorkspaceDocument_management(in_data, out_file, export_option, 
                                            storage_type, export_metadata)

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes