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

Append (Data Management)

Release 9.3
Last modified March 8, 2012
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

NOTE: This topic was updated for 9.3.1.


Appends multiple input datasets 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} {subtype}

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

The input point, line, or polygon feature classes 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
{subtype}

If subtype is set for a field of the target dataset, then all appended features will have the selected subtype value.

String
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, subtype)

Parameter Explanation Data Type
inputs (Required)

The input point, line, or polygon feature classes 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
subtype (Optional)

If subtype is set for a field of the target dataset, then all appended features will have the selected subtype value.

String

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.