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

Disponible avec une licence Standard ou Advanced.

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 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 Overwrite output (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 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

É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 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 structureLes données et la structure sont importées. Il s’agit de l’option par défaut.
  • Importer la structure uniquementSeule 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

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

Géodatabase mise à jour.

Workspace

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 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.

  • DATALes données et la structure sont importées. Il s’agit de l’option par défaut.
  • SCHEMA_ONLYSeule la structure est importée.
String
config_keyword
(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

NomExplicationType 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 illustre l’utilisation de la fonction 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 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"

# Execute ImportXMLWorkspaceDocument
arcpy.ImportXMLWorkspaceDocument_management(target_gdb, in_file, import_type, 
                                            config_keyword)

Informations de licence

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

Rubriques connexes