ArcMap

Import XML Workspace Document

Available with Standard or Advanced license.

Summary

Imports the contents of an XML workspace document into an existing geodatabase.

Learn more about copying a schema using XML workspaces

Learn more about Geodatabase XML

Usage

  • The Target Geodatabase must already exist and can be a personal, file, or enterprise geodatabase. To create a new, empty geodatabase use the Create File GDB or Create Personal GDB tools.

  • If you are importing into a file or enterprise geodatabase and want to use a configuration keyword, you can choose one from the Configuration Keyword drop-down list on the tool dialog box. In a Python script, you will need to know the name of the configuration keyword to use.

  • If Overwrite the outputs of geoprocessing operations option on the Geoprocessing Options dialog box is unchecked and a data element from the input XML workspace document has the same name as a data element in the Target Geodatabase, the data element will be imported with a new unique name. If this option is checked, existing datasets will be overwritten. For more information about overwriting tool output, see Using geoprocessing options to control tool execution.

  • The tool messages will include the list of data element names that were imported.

Syntax

ImportXMLWorkspaceDocument(target_geodatabase, in_file, {import_type}, {config_keyword})
ParameterExplanationData Type
target_geodatabase

The existing geodatabase where the contents of the XML workspace document will be imported.

Workspace
in_file

The input XML workspace document file containing geodatabase contents to be imported. This can be an XML file (.xml) or a compressed ZIP file (.zip or .z) containing the XML file.

File
import_type
(Optional)

Determines if both data (feature class and table records, including geometry) and schema are imported, or only schema is imported.

  • DATA —Import the data and schema. This is the default.
  • SCHEMA_ONLY —Import the schema only.
String
config_keyword
(Optional)

Geodatabase configuration keyword to be applied if the Target Geodatabase is an enterprise or file geodatabase.

String

Derived Output

NameExplanationData Type
out_geodatabase

The updated geodatabase.

Workspace

Code sample

ImportXMLWorkspaceDocument example 1 (Python window)

The following Python window script demonstrates how to use the ImportXMLWorkspaceDocument tool in immediate mode.

import arcpy
arcpy.ImportXMLWorkspaceDocument_management("C:/Data/Target.gdb", 
                                            "C:/Data/StJohnsData.xml", 
                                            "SCHEMA_ONLY", "DEFAULTS")
ImportXMLWorkspaceDocument example 2 (stand-alone script)

The following Python script demonstrates how to use the ImportXMLWorkspaceDocument tool in a stand-alone script.

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

Environments

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes