Exporter un document d’espace de travail XML (Outils de 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 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 si 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 Copy (Copier) ou Clip (Découper) pour extraire des sous-ensembles des données. En outre, le jeu d’outils Package (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.

Etiqueter	Explication	Type 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ées—La structure et les données seront exportées. Il s’agit de l’option par défaut. Structure uniquement—Seule 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. Binaire—La 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. Décoché—Les métadonnées ne seront pas exportées.	Boolean

arcpy.management.ExportXMLWorkspaceDocument(in_data, out_file, {export_type}, {storage_type}, {export_metadata})

Nom	Explication	Type 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. `DATA`—La structure et les données seront exportées. Il s’agit de l’option par défaut. `SCHEMA_ONLY`—Seule 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. `BINARY`—La 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. `NORMALIZED`—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
export_metadata (Facultatif)	Indique si les métadonnées seront exportées. `METADATA`—Si l'entrée contient des métadonnées, elles sont exportées. Il s’agit de l’option par défaut. `NO_METADATA`—Les métadonnées ne seront pas exportées.	Boolean

Exemple de code

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

Le script de fenêtre Python ci-après 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 ci-après 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)

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui