Esri ArcGIS Online (AGOL) Feature Service Reader/Writer

Licensing optionsfor this format begin with FME Professional Edition.

The Esri ArcGIS Online Feature Service Reader/Writer plug-in enables FME to read and write features from a Feature Service hosted on the ArcGIS Online cloud service.

Note:A valid ArcGIS Online account is required to access ArcGIS Online.

A free trial can be obtained athttp://www.esri.com/software/arcgis/arcicishine/evaluate..

For more information, seeEsri GeoServices REST Specification.

概述

ArcGIS Online is a platform for sharing and publishing geospatial data to the public, or privately within an organization. Data uploaded to ArcGIS Online can then be visualized on the web.

ArcGIS Online supports many different kinds of data. FME’s ArcGIS Online Feature Service Reader/Writer only exposes Feature Services available under an ArcGIS Online user’s account.

In FME, an ArcGIS Online Feature Service is a required format parameter, and a layer or table within a Feature Service is a feature type.

ArcGIS Online requires HTTPS access. If you are connecting via a proxy server, ensure that it supports HTTPS.

Duplicate Layer Names

ArcGIS Online允许在功能服务中进行重复的图层名称。

ArcGIS Online Feature Service Reader通过将图层ID附加到要素类型的末尾,如果多个图层共享相同名称,则解析模糊性。如果在要素类型中存在图层ID,则ID优先于名称。

Authentication

The ArcGIS Online Feature Service Reader/Writer uses the supplied username and password to obtain an access token. The access token is used to authenticate all subsequent requests during a translation.

To read directly from To read directly from a Feature Service without authentication, or with a manually-supplied token, use the Esri ArcGIS Feature Service Reader.

读者概述

ArcGIS在线功能服务读取器读取功能服务中的图层的功能。ArcGIS Online返回JSON格式的功能,该功能被转换为FME功能。

Each ArcGIS Online Feature Service layer corresponds to a single FME feature type. Each layer contains features of a single geometry type.

Layers may be defined before they are read. A definition that specifies a subset of attributes will reduce data transfer and processing time. If a definition is not present for a layer (such as when using theFeatureReader.transformer), all fields and records will be retrieved.

Although ArcGIS Online Feature Services may support Z-values and measures, the ArcGIS Online Feature Service Reader cannot read such values at this time.

Writer Overview

ArcGIS在线功能服务编写器使用ArcGIS REST API来创建功能服务和写入功能。

写入现有功能服务时,强烈建议您选择Writer> Import Feature类型,以便获取要素服务中的所有图层的架构。

In particular, publishing a Feature Service can result in changes to the schema of feature types. See the故障排除部分详情。

INSERT, UPDATE, DELETE operations are all combined into a single request per feature type, issued in batches of requests based on a configurable number of features. If the operation for any single feature fails within a batch, then all other write operations in that batch are automatically rolled back by the server, and the translation aborts. If ArcGIS Online returns an error for any write operation, the ArcGIS Online Feature Service Writer will pass the error messages to the log.

If the destination Feature Service layer supports Z or M values, the ArcGIS Online Feature Service Writer can write them. However, it is currently not possible to create Feature Service layers with Z or M support.

特色服务创建

If the Feature Service directive refers to a Feature Service that does not exist, and the writer mode for all feature types is INSERT, then the ArcGIS Online Feature Service Writer will create the Feature Service.

The mechanics of this operation differ significantly from writing to an existing Feature Service:

  • 所有功能都被写入文件地理数据库。
  • 文件地理数据库被压缩到zip文件中,并将其上载为文件地理数据库项目。
  • The Item is published as a Feature Service.

The uploaded File Geodatabase Item remains after the Feature Service is published from it. The Feature Service has no dependency on the File Geodatabase Item, so it is safe to delete it.

Object (Feature) IDs

创建要素服务时,ArcGIS Online将为所有图层添加为作为主键的新字段。这称为对象ID字段。通常,ArcGIS Online将名称此字段“FID”,但图层可以为其对象ID字段具有不同的名称。请注意,此字段的值始终由ArcGIS联机分配:服务器忽略INSERT期间为此属性提供的值。

When in UPDATE or DELETE mode, a value must be provided for the attribute that corresponds to the Object ID field. If the attribute is not present, the writer will output an error message that specifies the name of the required attribute.

Layer Creation

只能创建图层作为创建要素服务的一部分。此时不支持在现有功能服务中创建新图层。不对应于现有功能服务中的图层的特征类型将导致错误。