Python ArcGIS FeatureLayer.append用法及代码示例

本文简要介绍 python 语言中 arcgis.features.FeatureLayer.append 的用法。

用法:

append(item_id=None, upload_format='featureCollection', source_table_name=None, field_mappings=None, edits=None, source_info=None, upsert=False, skip_updates=False, use_globalids=False, update_geometry=True, append_fields=None, rollback=False, skip_inserts=None, upsert_matching_field=None, upload_id=None, *, return_messages=None, future=False)

返回：

指示成功 (True) 或失败 (False) 的布尔值。当 return_messages 为 True 时，除了布尔值之外，还将返回响应消息作为 tuple 。如果 future = True ，则结果是 Future 对象。调用 result() 获取响应。

append 方法用于更新现有托管的FeatureLayer 对象。有关更多信息，请参阅ArcGIS REST API 文档中的Append (Feature Service/Layer) 页面。

注意：

append 方法仅在 ArcGIS Online 和 ArcGIS Enterprise 10.8.1+ 中可用

Parameter	Description
item_id	可选字符串。包含源文件的门户项目的 ID。与editsUploadFormat 结合使用。
upload_format	必需的字符串。源追加数据格式。默认值为特征集合。值：‘sqlite’ | ‘shapefile’ | ‘filegdb’ | '函数集合' | ‘geojson’ | ‘csv’ | ‘excel’
source_table_name	必需的字符串。即使源数据仅包含一个表(例如，对于文件地理数据库)也需要。 # Example usage: source_table_name= "Building"
field_mappings	可选列表。用于将源数据映射到目标图层。语法：field_mappings=[{“name”:<”targetName”>, “sourceName” : < “sourceName”>}, …] # Example usage: field_mappings=[{"name" : "CountyID", "sourceName" : "GEOID10"}]
edits	可选字典。仅支持特征集合 json。追加支持通过 upload_id 或 item_id 的所有格式。
source_info	可选字典。这仅在从 excel 或 csv 附加数据时才需要。 appendSourceInfo 可以是分析 csv 或 excel 文件返回的发布参数。
upsert	可选的布尔值。可选参数，指定在函数已存在时是否需要将编辑作为更新应用。默认为假。
skip_updates	可选的布尔值。仅当 upsert 为真时才使用参数。
use_globalids	可选的布尔值。指定upsert在匹配特征时是否需要使用GlobalId。
update_geometry	可选的布尔值。该参数仅在 upsert 为真时使用。如果现有要素通过 objectId 或 globalId 匹配源要素，则跳过更新几何并仅更新其属性。(由 useGlobalIds 参数指定)。
append_fields	可选列表。要附加到的目标字段列表。当 upsert=true 或 false 时支持这一点。 #Values: ["fieldName1", "fieldName2",....]
rollback	可选的布尔值。可选参数，指定在失败的情况下是否需要回滚 upsert 编辑。默认为假。
skip_inserts	仅在 upsert 为真时使用。如果值为 true，则用于跳过插入。默认值为假。
upsert_matching_field	可选字符串。通过 upsert 匹配要素时要使用的图层字段。 ObjectId、GlobalId 和任何其他具有唯一索引的字段都可以与 upsert 一起使用。该参数覆盖use_globalids；例如，即使指定 use_globalids = True，也会使用指定 upsert_matching_field。示例：upsert_matching_field=”MyfieldWithUniqueIndex”
upload_id	可选字符串。 upload() 响应中的 itemID 字段，与 appendUploadId REST API 参数相对应。此参数不应与 item_id 参数一起使用。
return_messages	可选布尔值。当设置为 True 时，将从追加返回的消息将被返回。如果 False ，则不会返回响应消息。这会将输出更改为由 (Boolean, Dictionary) 组成的元组。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。

例子：

# Usage Example

>>> feature_layer.append(source_table_name= "Building",
                        field_mappings=[{"name" : "CountyID",
                                        "sourceName" : "GEOID10"}],
                        upsert = True,
                        append_fields = ["fieldName1", "fieldName2",...., fieldname22],
                        return_messages = False)
<True>