描述
将一个或多个宗地结构追加到现有目标宗地结构。输入宗地结构的空间参考必须与目标宗地结构的空间参考相匹配。
使用方法
使用此工具将新宗地添加到现有宗地结构。例如，您可以将由城市公共建设部门输入的新的分区追加到市县评估人员的税收宗地数据库中。另一个示例是将不同的宗地结构连接到一起形成一个单一的宗地结构。
重合边界点会在追加结构之间进行合并，这样内部宗地结构的拓扑就不会受到任何影响。当点位于要素数据集的 XY 容差的 2 倍容差内时会合并点。
将宗地作为未连接的组追加选项将新宗地作为未连接的组进行追加。未连接宗地存在于宗地结构以外的自己本地的坐标空间中。可以随时将未连接宗地连接到宗地结构中。建议保持一组较小的未连接宗地来降低连接过程的复杂性。
如果无法选择输入宗地结构，则会追加所有宗地和控制点。可通过在输入宗地结构中仅选择控制点来单独追加控制点。可通过在输入宗地结构中仅选择宗地来单独追加宗地。同时选择宗地和控制点可仅追加那些所选要素。
不会追加 Jobs、Adjustments、Accuracy 和 Vectors 系统表中的数据。
输入宗地结构和目标宗地结构中的所有要素都将在追加后保持原样，即使出现宗地相互叠置的情况也是如此。例如，系统不会通过叠置追加宗地来分割或修改现有宗地。重合点始终会被合并。
输入宗地结构和目标宗地结构中的所有控制点都将在追加后保持原样，即使出现控制点相互叠置的情况也是如此。但是，如果所追加的叠置控制点（输入）的相关联点 ID 与现有控制点（目标）相同，则该关联将被移除。现有控制点及其相关联点 ID 将仍保持原样。
如果宗地方案类型、线方案类型或控制方案类型被指定为 TEST，这些输入宗地结构表的方案（字段定义）必须与目标宗地结构表相匹配，才能追加宗地。方案类型参数仅适用于已添加到宗地、线或控制点属性表中的属性。宗地结构系统属性在不同宗地结构中保持一致。如果指定 NO_TEST，输入宗地、线或控制点结构表（字段定义）则不必与表目标结构数据集相匹配。不过，输入宗地结构表中不与目标宗地结构表字段匹配的任何字段都不会被映射。只有两种结构中存在相同的字段，字段才能在输入宗地结构和目标宗地结构之间进行映射。
输入及目标宗地结构的空间参考必须匹配。工具不能追加具有与目标宗地结构的空间参考不同的空间参考的宗地结构。
输入及目标宗地结构的升级版本必须匹配。
宗地结构图层可以用作输入宗地。如果宗地结构图层具有可选择内容，则仅会使用选定的宗地和控制点。
此工具不能使用具有相同名称的多个输入宗地结构图层。虽然 ArcMap 可显示具有相同名称的宗地结构图层，但可能无法使用这些图层。 要解决此限制，请使用工具对话框浏览按钮来浏览各输入宗地的完整路径。
要使用宗地子类型、线子类型和控制点子类型参数，目标宗地结构必须具有已定义的子类型字段，并且已为宗地、线和控制点表分配了子类型代码。在宗地子类型、线子类型或控制点子类型参数中，提供了一个子类型描述，以便为所有被追加到目标宗地结构的新宗地结构要素分配该子类型。
语法
arcpy.fabric.AppendParcelFabric(in_parcels, target, unjoined_group, {parcels_schema_type}, {field_mapping_parcels}, {parcels_subtype}, {lines_schema_type}, {field_mapping_lines}, {lines_subtype}, {control_schema_type}, {field_mapping_control}, {control_subtype})| 参数 | 说明 | 数据类型 |
in_parcels [in_parcels,...] | 将被追加到目标宗地结构的输入宗地结构。输入宗地结构的空间参考必须与目标宗地结构的空间参考相匹配。 | Parcel Fabric Layer |
target | 输入宗地结构将被追加到的现有宗地结构。输入宗地结构的空间参考必须与目标宗地结构的空间参考相匹配。 | Parcel Fabric |
unjoined_group | 确定宗地追加方式。
| Boolean |
parcels_schema_type （可选） | 指定输入宗地结构宗地表的方案（字段定义）是否只有与目标宗地结构宗地表的方案相匹配，才能够追加数据。
| String |
field_mapping_parcels （可选） | 列出将被映射到目标宗地表中的属性字段。此列表包括目标宗地表的现有属性字段及在输入宗地表与目标宗地表之间匹配的属性字段。 由于输入宗地结构被追加到具有预定义方案（字段定义）的现有目标宗地结构中，因此宗地扩展的属性字段映射控件不允许在目标宗地结构中添加或移除字段。 | Field Mappings |
parcels_subtype （可选） | 为被追加到目标宗地结构的宗地结构中的所有新宗地要素分配该子类型的子类型描述。 | String |
lines_schema_type （可选） | 指定输入宗地结构线表的方案（字段定义）是否只有与目标宗地结构线表的方案相匹配，才能够追加数据。
| String |
field_mapping_lines （可选） | 列出将被映射到目标线表中的属性字段。此列表包括目标线表的现有属性字段及在输入线表与目标线表之间匹配的属性字段。 由于输入宗地结构被追加到具有预定义方案（字段定义）的现有目标宗地结构中，因此线扩展的属性字段映射控件不允许在目标宗地结构中添加或移除字段。 | Field Mappings |
lines_subtype （可选） | 为被追加到目标宗地结构的宗地结构中的所有新线要素分配该子类型的子类型描述。 | String |
control_schema_type （可选） | 指定输入宗地结构控制表的方案（字段定义）是否只有与目标宗地结构控制表的方案相匹配，才能够追加数据。
| String |
field_mapping_control （可选） | 列出将被映射到目标控制表中的属性字段。此列表包括目标控制表的现有属性字段及在输入控制表与目标控制表之间匹配的属性字段。 由于输入宗地结构被追加到具有预定义方案（字段定义）的现有目标宗地结构中，因此控制点扩展的属性字段映射控件不允许在目标宗地结构中添加或移除字段。 | Field Mappings |
control_subtype （可选） | 为所有追加到目标宗地结构的宗地结构中的新控制点要素指定该子类型的子类型描述。 | String |
代码示例
AppendParcelFabric 示例 1（Python 窗口）
以下 Python 窗口脚本演示了如何在即时模式下使用 AppendParcelFabric 工具。
import arcpy
arcpy.env.workspace = "C:/data/OaklandCounty.gdb"
arcpy.AppendParcelFabric_fabric("/ParcelData/CountyFabric", "/SubdivisionData/Subdivision", "JOINED_GROUP",
"TEST", "", "", "TEST", "", "", "TEST", "", "")
AppendParcelFabric 示例 2（独立 Python 脚本）
以下脚本演示了如何使用 AppendParcelFabric 工具。
# Name: Append Parcels.py
# Description: Appends a new subdivision to the county's Parcel Fabric
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "E:\City\LocalGovernment.gdb\ParcelEditing"
# Set local variables
in_data = "Parcel_Fabric"
out_data = " E:\County\LocalGovernment.gdb\ParcelEditing\Parcel_Fabric"
# Execute Append Parcels
arcpy.AppendParcelFabric_fabric(in_data, out_data, "JOINED_GROUP","TEST", "", "", "TEST", "", "", "TEST", "", "")
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是