The Poll an ArcGIS Server for Features input connector can be used to poll an ArcGIS Enterprise or ArcGIS Online map or feature service layer for feature records to process them as event records.
Usage notes
Keep the following in mind when using the Poll an ArcGIS Server for Features input connector:
- Use this input connector to retrieve features from a map or feature service layer.
- This input connector pairs the Feature JSON inbound adapter with the Feature Service inbound transport. The Feature JSON inbound adapter specifically interprets feature JSON. For more information, see Geometry objects.
- ArcGIS Enterprise, ArcGIS Online, and ArcGIS Server(stand-alone) map and feature services are supported.
- Service layers can be referenced using the Browse to Layer option or by specifying a URL with the Service Layer URL option. Both methods require that a registered data store connection first be established.
- Like all input connectors, a GeoEvent Definition is required. A GeoEvent Definition identifies the schema of event records being received. For more information, see GeoEvent Definitions.
- Data values from event attribute fields not included in a GeoEvent Definition are ignored.
- This input connector periodically polls a specified map or feature layer at a specified interval. As with any web server or web service, excessive polling intervals—for example, every second—are not recommended.
- A simple WHERE clause is used to identify the feature record set returned with each poll of the map or feature service. The default is to include all records in the polled feature record set, for example, WHERE 1=1. The default WHERE clause can be modified to include specific attribute values and logic conditions.
- This input connector supports spatial filters that use a specified geometry and spatial relationship, for example, polygon intersects.
- This input connector supports the optional deletion of polled records from the map or feature layer being polled.
- This input connector supports a unique capability, Get Incremental Updates, to poll for newly added or updated feature records using ObjectID or Timestamp values retrieved from feature records, or derived from the polling interval, and cached by the input connector.
- Cached values are incorporated into a WHERE clause to query for records that are greater than the cached value or within a polling interval relative to now.
- There are three methods available to identify incremental updates: ObjectID, Timestamp, and Timestamp until now.
- For more information, see the Esri Community blog Polling Feature Services for Incremental Updates.
Parameters
The following are the parameters for the Poll an ArcGIS Server for Features input connector:
Parameter | Description |
---|---|
Name | A descriptive name for the input connector used for reference in GeoEvent Manager. |
Registered server connection | An ArcGIS Server, ArcGIS Enterprise, or ArcGIS Online connection registered with ArcGIS GeoEvent Server as a data store. Registered server connections cache information about map/feature services, their layers, and layer properties. |
Reference to Layer Type | Defines the options for referencing a layer.
|
Folder (Conditional) | An ArcGIS Server services folder, ArcGIS Enterprise portal, or ArcGIS Online content item folder. The parameter is shown when the Reference to Layer Type parameter is set to Browse to Layer and is hidden when set to Service Layer URL. |
Service Name (Conditional) | The name of the map/feature service from which you want to poll feature records. The parameter is shown when the Reference to Layer Type parameter is set to Browse to Layer and is hidden when set to Service Layer URL. |
Layer (Conditional) |
The map/feature service feature layer through which feature records are accessed. The parameter is shown when the Reference to Layer Type parameter is set to Browse to Layer and is hidden when set to Service Layer URL. |
Service Layer URL (Conditional) | The URL to a service layer. Remarque :A data store connection must be established when referencing a service layer by URL. The service layer must either be publicly accessible or shared with the user whose credentials establish the data store connection.The parameter is shown when the Reference to Layer Type parameter is set to Service Layer URL and is hidden when set to Browse to Layer. |
Create GeoEvent Definition | Specifies whether a new or existing GeoEvent Definition should be used for the inbound event data. A GeoEvent Definition is required for GeoEvent Server to understand the inbound event data attribute fields and data types.
|
GeoEvent Definition Name (New) (Conditional) | The name assigned to a new GeoEvent Definition. If a GeoEvent Definition with the specified name already exists, the existing GeoEvent Definition will be used. The first data record received will be used to determine the expected schema of subsequent data records, a new GeoEvent Definition will be created based on that first data record's schema. The parameter is shown when Create GeoEvent Definition is set to Yes and is hidden when set to No. |
GeoEvent Definition Name (Existing) (Conditional) | The name of an existing GeoEvent Definition to use when adapting received data to create event data for processing by a GeoEvent Service. The parameter is shown when Create GeoEvent Definition is set to No and is hidden when set to Yes. |
Refresh Interval | The period (in seconds) in which a map/feature service feature layer will be polled for feature records. The default is 10 (one poll request will be sent every 10 seconds). |
Get Incremental Updates | Specifies whether to request only new or updated feature records using a cached ObjectID or Timestamp value. The default value is No.
Remarque :If an input connector is deleted and recreated, the ArcGIS GeoEvent Server service is stopped or restarted, or the server machine is restarted, the cached key value will be lost. A new key value will be cached once available feature records are polled and the feature record set returned from the map/feature service is examined. |
Method to Identify Incremental Updates (Conditional) | Specifies the attribute type GeoEvent Server will use to identify new or updated feature records when polling for incremental updates. Available options include the following:
The parameter is shown when Get Incremental Updates is set to Yes and is hidden when Get Incremental Updates is set to No. |
Time Field to Identify Incremental Updates (Conditional) | The timestamp field, from the GeoEvent Definition, whose values will be used to identify timestamp-based incremental updates. Only attributes whose data type is Date can be selected. The parameter is shown when Method to Identify Incremental Updates is set to either Timestamp or Timestamp until now. |
Query Definition | Specifies a logical expression used to restrict the feature records returned when polling a map/feature service feature layer. The expression is used as the predicate in a Structured Query Language (SQL) WHERE clause. Examples include the following:
|
Use Geometry Filter | Specifies whether a geometry object should be used as a spatial filter to restrict the feature records returned when polling a map/feature service feature layer. A geometry filter, if specified, will be combined with a specified query definition to further restrict feature records returned from the feature layer query. For more information, see Geometry objects.
|
Filter Geometry (Conditional) | The geometry object, expressed using feature JSON, used as a spatial filter. For more information on proper geometry object syntax, see Geometry objects. The parameter is shown when Use Geometry Filter is set to Yes. |
Geometry Type (Conditional) | Specifies the type of geometry described by the feature JSON for the geometry filter. Supported geometry types include envelope, point, polyline, polygon, and multipoint. The parameter is shown when Use Geometry Filter is set to Yes. |
Spatial Reference (Conditional) | Specifies the well-known ID (WKID) of the spatial reference for the geometry filter. The parameter is shown when Use Geometry Filter is set to Yes. |
Spatial Relationship (Conditional) | Specifies the spatial relationship to use when evaluating feature records, polled from a map/feature service feature layer, to determine if they satisfy the conditions of the geometry filter. The parameter is shown when Use Geometry Filter is set to Yes. |
Delete Polled Features | Specifies whether the feature records in the record set returned from a feature service should be deleted from the feature service feature layer. The default is No. |
Vous avez un commentaire à formuler concernant cette rubrique ?