Python ArcGIS Table.edit_features用法及代碼示例

本文簡要介紹 python 語言中 arcgis.features.Table.edit_features 的用法。

用法:

edit_features(adds=None, updates=None, deletes=None, gdb_version=None, use_global_ids=False, rollback_on_failure=True, return_edit_moment=False, attachments=None, true_curve_client=False, session_id=None, use_previous_moment=False, datum_transformation=None, future=False)

返回：

默認情況下是字典，或者如果 future = True ，則結果是 Future 對象。調用result() 獲取響應。

在一次調用中向關聯的 FeatureLayer 或 Table 添加、更新和刪除函數。

注意：

當進行大量(一次250+條記錄)編輯時，應使用append而不是edit_features，以提高性能並確保服務穩定性。

Inputs	Description
adds	可選FeatureSet /列表。要添加的函數數組。
updates	可選FeatureSet /列表。要更新的函數數組。
deletes	可選FeatureSet /列表。要從服務中刪除的 OID 字符串
use_global_ids	可選布爾值。該服務將查看 GUID 字段來跟蹤更改，而不是引用默認的對象 ID 字段。這意味著將傳遞 GUID 而不是 OID 來刪除、更新或添加函數。
gdb_version	可選布爾值。 Geodatabase 版本來應用編輯。
rollback_on_failure	可選的布爾值。可選參數，用於指定是否僅當所有提交的編輯都成功時才應用編輯。如果為 false，即使某些提交的編輯失敗，服務器也會應用成功的編輯。如果為 true，則僅當所有編輯都成功時，服務器才會應用編輯。默認值是true。
return_edit_moment	可選布爾值。在 10.5 中引入，僅適用於 ArcGIS 服務器服務。指定響應是否報告應用編輯的時間。如果設置為 true，服務器將在響應的 editMoment 鍵中返回時間。默認值為 false。
attachments	可選字典。此參數添加、更新或刪除附件。僅當 use_global_ids 參數設置為 true 時才適用。對於添加，將保留客戶端提供的附件的全局 ID。當 useGlobalIds 為 true 時，更新和刪除由每個函數或附件 globalId 標識，而不是其 objectId 或 AttachmentId。此參數要求圖層的supportsApplyEditsWithGlobalIds屬性為true。 要添加或更新的附件可以使用預上傳的數據或 Base 64 編碼的數據。 輸入 Inputs Description adds List of attachments to add. updates List of attachements to update deletes List of attachments to delete 有關更多信息，請參閱ArcGIS REST API 中的Apply Edits to a Feature Service layer。
true_curve_client	可選布爾值。於 10.5 引入。向服務器指示客戶端是否具有真正的曲線能力。當設置為 true 時，這向服務器指示應下載真實曲線幾何圖形，並且Map服務應使用包含真實曲線的幾何圖形而不對其進行致密化。當設置為 false 時，這向服務器表明客戶端不具備真正的曲線函數。默認值為 false。
session_id	可選字符串。於 10.6 引入。 session_id 是客戶端在開始時建立並在整個編輯會話中使用的 GUID 值。 sessonID 確保編輯會話期間的隔離。 session_id 參數由客戶端在分支版本上進行長事務編輯期間設置。
use_previous_moment	可選布爾值。於 10.6 引入。 use_previous_moment 參數用於應用與前一組編輯具有相同編輯時刻的編輯。這允許編輯者部分應用單個編輯塊，完成另一項任務，然後完成該編輯塊。該參數由客戶端在分支版本上進行長事務編輯時設置。 設置為 true 時，將在與前一組編輯相同的編輯時刻應用編輯。當設置為 false 或未設置(默認)時，編輯將在新的編輯時刻應用。
datum_transformation	可選的整數/字典。當 out_sr 與圖層的空間參考不同時，此參數會在投影結果中的幾何圖形時應用基準變換。指定變換時，您需要考慮哪種基準變換能夠最好地將圖層(而不是要素服務)投影到圖層屬性中的 outSR 和 sourceSpatialReference 屬性。有關有效基準轉換 ID 值和眾所周知的文本字符串的列表，請參閱 Using spatial references 。有關基準轉換的更多信息，請參閱Project operation 文檔中的轉換參數。 例子 Inputs Description WKID Integer. Ex: datum_transformation=4326 WKT Dict. Ex: datum_transformation={“wkt”: “<WKT>”} Composite Dict. Ex: datum_transformation=```{‘geoTransforms’:[{‘wkid’:<id>,’forward’:<true|false>},{‘wkt’:’<WKT>’,’forward’:<True|False>}]}```
future	可選布爾值。如果 FeatureLayer 將 supportsAsyncApplyEdits 設置為 True ，則可以異步應用編輯。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。

示例 1：

# Usage Example 1:

feature = [
{
    'attributes': {
        'ObjectId': 1,
        'UpdateDate': datetime.datetime.now(),
    }
}]
lyr.edit_features(updates=feature)

示例 2：

# Usage Example 2:

adds = {"geometry": {"x": 500, "y": 500, "spatialReference":
                    {"wkid": 102100, "latestWkid": 3857}},
        "attributes": {"ADMIN_NAME": "Fake Location"}
        }
lyr.edit_features(adds=[adds])

示例 3：

# Usage Example 3:

lyr.edit_features(deletes=[2542])