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

Synthèse

Importe le contenu d'un document d'espace de travail XML dans une géodatabase existante.

Utilisation

• La valeur du paramètre Target Geodatabase (Géodatabase cible) doit déjà exister. Il peut s’agir d’une géodatabase fichier, mobile ou d’entreprise. Pour créer une géodatabase vide, utilisez l’outil Créer une géodatabase fichie, Créer une géodatabase mobile ou Créer une géodatabase d’entreprise.

• Si vous importez les données dans une géodatabase fichier ou d'entreprise et que vous souhaitez utiliser un mot-clé de configuration, sélectionnez-en un dans la liste déroulante Configuration Keyword (Mot-clé de configuration). Dans un script Python, vous devez connaître le nom du mot-clé de configuration à utiliser.

• Si la case Allow geoprocessing tools to overwrite existing datasets (Autoriser les outils de géotraitement à remplacer les jeux de données existants) est cochée et qu’un élément de données du document d’espace de travail XML en entrée porte le même nom qu’un élément de données dans la valeur du paramètre Target Geodatabase (Géodatabase cible), l’élément de données est importé avec un nouveau nom unique. Si cette option est activée, les jeux de données existants seront remplacés. Pour plus d’informations sur le remplacement de la sortie de l’outil, reportez-vous à la rubrique Utilisation des options de géotraitement dans ArcGIS Pro.

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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Géodatabase cible	La géodatabase existante dans laquelle le contenu du document d'espace de travail XML sera importé.	Workspace
Importer un fichier	Fichier de document d'espace de travail XML en entrée qui contient le contenu de géodatabase à importer. Il peut s’agir d’un fichier X.xml, d’un fichier .zip compressé ou d’un fichier .z qui contient le fichier .xml.	File
Options d'importation (Facultatif)	Indique si les données (classe d’entités et enregistrements de table, y compris la géométrie) et la structure sont importées, ou si seule la structure est importée. Importer les données et la structure—Les données et la structure sont importées. Il s’agit de l’option par défaut. Importer la structure uniquement—Seule la structure est importée.	String
Mot-clé de configuration (Facultatif)	Mot-clé de configuration de la géodatabase à appliquer lorsque la valeur du paramètre Target Geodatabase (Géodatabase cible) est une géodatabase fichier ou d’entreprise.	String

Sortie obtenue

Étiquette	Explication	Type de données
Géodatabase cible mise à jour	Géodatabase mise à jour.	Workspace

Python

arcpy.management.ImportXMLWorkspaceDocument(target_geodatabase, in_file, {import_type}, {config_keyword})

Nom	Explication	Type de données
target_geodatabase	La géodatabase existante dans laquelle le contenu du document d'espace de travail XML sera importé.	Workspace
in_file	Fichier de document d'espace de travail XML en entrée qui contient le contenu de géodatabase à importer. Il peut s’agir d’un fichier X.xml, d’un fichier .zip compressé ou d’un fichier .z qui contient le fichier .xml.	File
import_type (Facultatif)	Indique si les données (classe d’entités et enregistrements de table, y compris la géométrie) et la structure sont importées, ou si seule la structure est importée. DATA—Les données et la structure sont importées. Il s’agit de l’option par défaut. SCHEMA_ONLY—Seule la structure est importée.	String
config_keyword (Facultatif)	Mot-clé de configuration de la géodatabase à utiliser lorsque la valeur du paramètre target_geodatabase est une géodatabase d'entreprise ou fichier.	String

Sortie obtenue

Nom	Explication	Type de données
out_geodatabase	Géodatabase mise à jour.	Workspace

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction ImportXMLWorkspaceDocument en mode immédiat.

import arcpy
arcpy.management.ImportXMLWorkspaceDocument("C:/Data/Target.gdb", 
                                            "C:/Data/StJohnsData.xml", 
                                            "SCHEMA_ONLY", "DEFAULTS")

Exemple 2 d'utilisation de la fonction ImportXMLWorkspaceDocument (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction ImportXMLWorkspaceDocument dans un script autonome.

# Name: ImportXMLWorkspaceDocument.py
# Description: Import the contents of an XML workspace document into a target 
#              geodatabase. 

# Import system modules
import arcpy

# Set local variables
target_gdb = "c:/data/Target.gdb"
in_file = "c:/data/StJohnsData.xml"
import_type = "SCHEMA_ONLY"
config_keyword = "DEFAULTS"

# Run ImportXMLWorkspaceDocument
arcpy.management.ImportXMLWorkspaceDocument(target_gdb, in_file, import_type, 
                                            config_keyword)

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence

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