The parcel fabric is a record-driven system. The parcel fabric organizes parcel data based on the form in which it was originally recorded. Parcel data is recorded on legal records such as plans, plats, deeds, and records of survey. Parcels are created and edited in response to changes in the legal record, and parcels are edited using record-driven workflows.
The parcel fabric preserves historic and parent parcels. By capturing the legal record that created or retired a parcel, the parcel lineage can be tracked in both directions. In an enterprise deployment, all edits are tracked, and the parcel fabric can be compared with its state in a previous moment in time.
Creating a parcel record requires the VersionManagementServer for branch versioning. However, it does not require access to the ParcelManager. Creating a new record makes use of the ApplyEdits method of the REST API which is accessed through the FeatureServer endpoint.
In the ArcGIS Python API, this operation is simplified by using the FeatureLayer.edit_features() method.
This notebook will demonstrate:
- Accessing the Records feature layer
- Creating a branch version
- Creating a parcel record with attributes using
FeatureLayer.edit_features()
from arcgis.gis import GIS
from arcgis.features.layer import FeatureLayerCollection
from arcgis.features.layer import FeatureLayerbase_server_url = (
"https://rextapilnx02eb.esri.com/server/rest/services/WashingtonCounty/"
)
gis = GIS(
"https://rextapilnx02eb.esri.com/portal/",
"gisproadv2",
"portalaccount1",
verify_cert=False,
)
# Generate the enpoint urls for feature server and version management
service_endpoints = ["FeatureServer", "VersionManagementServer"]
service_urls = {url: base_server_url + url for url in service_endpoints}Setting `verify_cert` to False is a security risk, use at your own risk.
Branch versioning setup
- Get the Parcel Fabric
FeatureLayerCollection(FLC) - Get the VersionManagementServer object from the FLC
- Create a new branch version
- Get the fully qualified (
owner.name) version name
parcel_fabric_flc = FeatureLayerCollection(service_urls["FeatureServer"], gis)
version_management_server = parcel_fabric_flc.versions
new_version_name = "new_record_version"
version = version_management_server.create(new_version_name)
fq_version_name = version["versionInfo"]["versionName"]
fq_version_name'gisproadv2.new_record_version'
Create a new feature in the Records feature layer
- Get access to the correct feature layer
- Create a dict containing some attributes for the new record
- Get the FeatureLayer
- Use
FeatureLayer.edit_featuresto create the new feature and insert the attributes.
# Get the URL of the Records feature layer
records_fl_url = [n for n in parcel_fabric_flc.layers if n.properties.name == "Records"]
records_fl_url = records_fl_url[0].url
records_fl_url'https://rextapilnx02eb.esri.com/server/rest/services/WashingtonCounty/FeatureServer/1'
Prepare the attributes
# A name for the new record
new_record_name = "ParcelRecord001"
# Record information with empty geometry. The geometry is created during Build
record_dict = {"attributes": {"name": new_record_name}, "geometry": None}
record_dict{'attributes': {'name': 'ParcelRecord001'}, 'geometry': None}Access the Records FeatureLayer
records_fl = FeatureLayer(records_fl_url, gis)
records_fl<FeatureLayer url:"https://rextapilnx02eb.esri.com/server/rest/services/WashingtonCounty/FeatureServer/1">
Insert the new record feature
# Create the new record within the new branch version
new_record = records_fl.edit_features(adds=[record_dict], gdb_version=fq_version_name)
new_record{'addResults': [{'objectId': 112552,
'globalId': '{27518672-D139-45CA-B0DB-D07B96B7A6FD}',
'success': True}],
'updateResults': [],
'deleteResults': []}