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.

Paramètres

ÉtiquetteExplicationType 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 XML (.xml) ou d'un fichier ZIP compressé (.zip ou .z) qui contient le fichier XML.

File
Options d'importation
(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.

  • Importer les données et la structureImportez les données et la structure. Il s’agit de l’option par défaut.
  • Importer la structure uniquementImporte uniquement la structure.
String
Mot-clé de configuration
(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

ÉtiquetteExplicationType de données
Géodatabase cible mise à jour

Géodatabase mise à jour.

Espace de travail

arcpy.management.ImportXMLWorkspaceDocument(target_geodatabase, in_file, {import_type}, {config_keyword})
NomExplicationType 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.

  • DATAImportez les données et la structure. Il s’agit de l’option par défaut.
  • SCHEMA_ONLYImporte 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

NomExplicationType 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)

Informations de licence

  • Basic: Non
  • Standard: Nécessite O
  • Advanced: Nécessite O

Rubriques connexes