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

Disponible avec une licence Standard ou Advanced.

Résumé

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

Utilisation

• La géodatabase cible doit déjà exister. Il peut s'agir d'une géodatabase personnelle, fichier ou d'entreprise. Pour créer une nouvelle géodatabase vide, utilisez l'outil Créer une géodatabase fichier.

• 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 Mot-clé de configuration de la boîte de dialogue de l'outil. Dans un script Python, vous devez connaître le nom du mot-clé de configuration à utiliser.

• Si la case Remplacer la sortie des propriétés du projet n'est pas 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 géodatabase cible, celui-ci sera importé avec un nouveau nom unique. Si cette option est activée, les jeux de données existants seront remplacés. Pour trouver la case à cocher Remplacer la sortie, cliquez sur l'onglet Projet et sélectionnez Options. Dans la boîte de dialogue Options, cliquez sur l'onglet Géotraitement.

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

Syntaxe

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

Paramètre	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 XML (.xml) ou d'un fichier ZIP compressé (.zip ou .z) qui contient le fichier XML.	File
import_type (Facultatif)	Détermine 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 —Importez les données et la structure. Il s’agit de l’option par défaut. SCHEMA_ONLY —Importe uniquement la structure.	String
config_keyword (Facultatif)	Mot-clé de configuration de la géodatabase à utiliser lorsque la géodatabase cible est une géodatabase d'entreprise ou fichier.	String

Sortie dérivée

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

Exemple de code

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

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

import arcpy
arcpy.ImportXMLWorkspaceDocument_management("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 l'outil ImportXMLWorkspaceDocument dans un script autonome.

# Name: ImportXMLWorkspaceDocument.py
# Description: Imports 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"
# Execute ImportXMLWorkspaceDocument
arcpy.ImportXMLWorkspaceDocument_management(target_gdb, in_file, import_type, 
                                            config_keyword)

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence

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