Import Parcel Fabric Points (Parcel)

Summary

Imports point data from a source point feature class into the parcel fabric points feature class. Parcel fabric points that match or lie within a proximity tolerance of the source points will be updated with the imported point data. If the source points layer has a selection, only the selected point information will be imported.

Parcel fabric points can be updated in the following ways:

  • Points can be retired and new points can be created with updated information from the imported points.
  • Points can be updated with attribute information from the source points. The existing parcel fabric points still remain active (nonhistoric).

If the source and target parcel fabric points meet the search criteria, and if the source point feature class has z-values, the shape x,y,z coordinates of the parcel fabric points are updated. If the source point feature class does not have z-values, only the shape x,y coordinates of the parcel fabric points are updated and the existing z-values remain unchanged. When the shape x,y coordinates of parcel fabric points are updated, connected parcel lines and polygons are updated to match the new coordinate locations.

When points are created, they can be optionally assigned to a new or existing parcel record.

Usage

  • This tool will modify data in the target parcel fabric. Parcel fabric point attribute values may be changed. Parcel fabric point, line, and polygon geometries may be changed. The tool will not delete parcel fabric features.

  • The search distance is applied by comparing the shape x,y coordinates of the source points with the shape x,y coordinates of the parcel fabric points. The search distance ignores z-values.

  • The tool can update both the attributes and geometry (shape coordinates), or only geometry of parcel fabric points. If attributes are updated, parcel fabric point fields that match fields in the source points feature class will be updated with the source point attribute values.

  • If the spatial references of the source point feature class and target parcel fabric do not match, the tool will project the source point feature class to the coordinate system used by the target parcel fabric. If the geographic datums of the spatial references of the source point feature class and target parcel fabric do not match, a geographic transformation must be performed on the source point feature class to match the geographic datum of the target parcel fabric before running the tool.

  • If more than one parcel fabric point is found within the proximity tolerance of a source point, a conflict will be reported as a warning message. You can optionally report conflicts in a conflicts table. If a conflicts table is specified for the Conflicts Table parameter, the Object IDs of the source point and parcel fabric points are stored in the table.

  • Imported points will be assigned to the record specified in the Record Name parameter. If the record does not already exist, a record will be created with the specified name.

    New points will be imported to retire existing parcel fabric points, imported to an empty parcel fabric, or imported to an area where points don't exist. When importing new points to retire existing points, use the Update Type parameter's Retire and replace option. Existing points will be retired by the record specified in the Record Name parameter.

Syntax

arcpy.parcel.ImportParcelFabricPoints(source_points, target_parcel_fabric, match_point_method, {search_distance}, update_type, {record_name}, {match_field}, {conflicts_table})
ParameterExplanationData Type
source_points

The source point feature class that will be used to update points in the target parcel fabric.

Feature Layer
target_parcel_fabric

The target parcel fabric containing the points that will be updated. The target parcel fabric can be from a file geodatabase, an enterprise geodatabase connected to the default version, or a feature service.

Parcel Layer
match_point_method

Specifies the method that will be used to find parcel fabric points that match the source points.

  • PROXIMITYParcel fabric points that lie within the proximity tolerance of the source points will be matched to the source points and updated. This is the default.
  • NAME_AND_PROXIMITY Parcel fabric points that lie within the proximity tolerance and have the same name as the source points will be matched to the source points and updated.
  • GLOBALID_AND_PROXIMITYParcel fabric points that lie within the proximity tolerance and have the same Global ID as the source points will be matched to the source points and updated. Global IDs are stored in the Global ID field of the parcel fabric points feature class and in the specified Global ID field of the source feature class.
String
search_distance
(Optional)

The distance that will be used to search for parcel fabric points that lie within the proximity of source points. If a parcel fabric point is found within the search distance of a source point, the points will be matched and the parcel fabric point will be updated.

Linear Unit
update_type

Specifies the type of update that will be applied to parcel fabric points that match source points.

  • ALLThe geometry (x,y,z) and matching attribute fields of parcel fabric points will be updated. If the geometry of parcel fabric points are updated, coincident parcel features are updated as well. This is the default.
  • GEOMETRY_XYZ Only the geometry (x,y,z) of the parcel fabric points will be updated. Coincident parcel features will be updated as well.
  • RETIRE_AND_REPLACESource points will be imported as new parcel fabric points. Any matching parcel fabric points will be retired as historic. The Retired By Record field of each matching parcel fabric point will be populated with the GlobalID of the record specified in the Record Name parameter.
String
record_name
(Optional)

The name of the record that will be associated with the new imported points.

If the record already exists in the target parcel fabric, the new points are associated with the record. If the record does not exist, a record will be created. If new points replace existing points, and Update Type is set to Retire and replace (update_type = RETIRE_AND_REPLACE in Python), the record will be used to retire the points as historic.

String
match_field
(Optional)

The field that will be used to match source points to parcel fabric points when Name and proximity (NAME_AND_PROXIMITY in Python) or Global ID and proximity (GLOBALID_AND_PROXIMITY in Python) is used for the Match Point Method (match_point_method in Python) parameter. When searching by name, the field in the source point feature class should be of type Text. When searching by Global ID, the field in the source point feature class should be of type GUID.

Field
conflicts_table
(Optional)

The path and name of the output table that will store conflicts. If more than one parcel fabric point is found within the search tolerance of a source point, the object IDs of the source points and parcel fabric points will be reported in the conflicts table.

Table

Derived Output

NameExplanationData Type
updated_parcel_fabric

The updated parcel fabric.

Parcel Layer

Code sample

ImportParcelFabricPoints example (Python window)

The following Python window script demonstrates how to use the ImportParcelFabricPoints tool to import points to a parcel fabric in immediate mode.

import arcpy

arcpy.parcel.ImportParcelFabricPoints(
    "C:/Parcels/Database.gdb/UpdatePoints",
    "C:/Parcels/Database.gdb/County/CountyFabric", 'PROXIMITY', '0.1 Feet', 
    'ALL', 'Record001', None, "C:/Parcels/Database.gdb/ConflictsTable")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics