Show Navigation | Hide Navigation
You are here:
Geoprocessing tool reference > Data Management toolbox > General toolset > Tools

Append (Data Management)

Release 9.2
Last modified November 29, 2010
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

Appends multiple input dataset into an already existing target dataset. Input datasets can be point, line or polygon feature classes, tables, rasters or raster catalogs.


Illustration

Append (Data Management) illustration

Usage tips

Command line syntax
An overview of the Command Line window
Append_management <inputs; inputs...> <target> {TEST | NO_TEST} {field_mapping}

Parameter Explanation Data Type
<inputs; inputs...>

The input point, line or polygon featureclasses or tables that will be appended into the target dataset.

Table View | Raster Layer
<target>

The existing output feature class, table, raster or raster catalog that will contain the appended input features.

Table View | Raster Layer
{TEST | NO_TEST}

Specifies how input schemas are transferred to the target feature class.

  • TEST — Input schemas must match the schema of the target feature class. An error will be returned if the input schemas do not match the target schema.
  • NO_TEST — Input schemas are not transferred to the target feature class unless they match the schema of the target.

String
{field_mapping}

This parameter maps field contents from the input datasets to the target dataset. This parameter is only valid when NO_TEST is specified for the schema type.

Learn more about using the Field Map parameter.

Field Mapping
Data types for geoprocessing tool parameters


Command line example

workspace d:\project93\data
CreateFeatureclass d:\project93\data multitown.shp POLYGON amherst.shp
Append_management "amherst.shp;hadley.shp;pelham.shp;coldspring.shp" multitown.shp TEST

Scripting syntax
About getting started with writing geoprocessing scripts
Append_management (inputs, target, schema_type, field_mapping)

Parameter Explanation Data Type
inputs (Required)

The input point, line or polygon featureclasses or tables that will be appended into the target dataset.

Table View | Raster Layer
target (Required)

The existing output feature class, table, raster or raster catalog that will contain the appended input features.

Table View | Raster Layer
schema_type (Optional)

Specifies how input schemas are transferred to the target feature class.

  • TEST — Input schemas must match the schema of the target feature class. An error will be returned if the input schemas do not match the target schema.
  • NO_TEST — Input schemas are not transferred to the target feature class unless they match the schema of the target.

String
field_mapping (Optional)

This parameter maps field contents from the input datasets to the target dataset. This parameter is only valid when NO_TEST is specified for the schema type.

Learn more about using the Field Map parameter.

Field Mapping

Data types for geoprocessing tool parameters


Script example

# Purpose: Append several feature classes together

# Create the Geoprocessor object
import arcgisscripting
gp = arcgisscripting.create()

try:
    # Set the workspace (to avoid having to type in the full path to the data every time)
    gp.Workspace =  "d:/project93/data"

    # Set a variable to store the updated feature class
    out_feat_class = "mass_towns.shp"

    # Process:  Create a feature class to update
    gp.CreateFeatureclass(gp.workspace, out_feat_class, "POLYGON",  "amherst.shp")

    # Process: Append the feature classes into the feature class
    gp.Append_management("amherst.shp;hadley.shp;pelham.shp;coldspring.shp", out_feat_class, "NO_TEST")

except:
    # If an error occurred while running a tool print the messages
    print gp.GetMessages()

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.