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

Synthèse

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 un nom au fichier en sortie en utilisant l’extension .xml. Pour créer un fichier .zip compressé, attribuez un nom au fichier en sortie en utilisant l’extension .zip ou .z.

  • 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, ceci n’est pas recommandé pour copier des données de géodatabase. Les autres possibilités pour copier des données de 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 comporte 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, vous devez 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 règles attributaires et toute séquence référencée dans l’expression de script des règles attributaires sont incluses dans l’exportation.

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

Paramètres

ÉtiquetteExplicationType de données
Données en entrée

Jeux de données en entrée qui sont exportés et représentés 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
Fichier en sortie

Fichier de document d’espace de travail XML qui est créé. La sortie peut être un fichier XML (avec l’extension de fichier .xml) ou un fichier XML compressé (avec l’extension de fichier .zip ou .z).

File
Options d’exportation
(Facultatif)

Spécifie 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.

  • DonnéesLa structure et les données seront exportées. Il s’agit de l’option par défaut.
  • Structure uniquementSeule la structure sera exportée.
String
Type de stockage
(Facultatif)

Spécifie si la géométrie de l’entité est stockée lorsque les données sont exportées depuis une classe d’entités.

  • BinaireLa 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.
  • NormaliséLa géométrie sera stockée dans un format non compressé. Cette option 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
Exporter les métadonnées
(Facultatif)

Indique si les métadonnées seront exportées.

  • Activé - Si l'entrée contient des métadonnées, elles sont exportées. Il s’agit de l’option par défaut.
  • Activé - Les métadonnées ne seront pas exportées.
Boolean

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

Jeux de données en entrée qui sont exportés et représentés 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 qui est créé. La sortie peut être un fichier XML (avec l’extension de fichier .xml) ou un fichier XML compressé (avec l’extension de fichier .zip ou .z).

File
export_type
(Facultatif)

Spécifie 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.

  • DATALa structure et les données seront exportées. Il s’agit de l’option par défaut.
  • SCHEMA_ONLYSeule la structure sera exportée.
String
storage_type
(Facultatif)

Spécifie si 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 compressé. Cette option 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)

Indique si les métadonnées seront 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_METADATALes métadonnées ne seront pas exportées.
Boolean

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ExportXMLWorkspaceDocument en mode immédiat.

import arcpy
arcpy.management.ExportXMLWorkspaceDocument('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 suivant illustre l’utilisation de la fonction ExportXMLWorkspaceDocument dans un script autonome.

# Name: ExportXMLWorkspaceDocument.py
# Description: Export 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'

# Run ExportXMLWorkspaceDocument
arcpy.management.ExportXMLWorkspaceDocument(in_data, out_file, export_option, 
                                            storage_type, export_metadata)

Rubriques connexes