Skip To Content

Poll an ArcGIS Server for Features

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:

ParameterDescription

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.

  • Browse to Layer—Reference a service layer by browsing the folders of a registered data store.
  • Service Layer URL—Reference a service layer by specifying the URL of the shared service 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.

  • Yes—A new GeoEvent Definition will be created based on the schema of the first event record received.
  • No—A new GeoEvent Definition will not be created. Select an existing GeoEvent Definition that matches the schema of the inbound event data.

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.

  • YesGeoEvent Server will poll for incremental updates using either a cached ObjectID or Timestamp.
  • NoGeoEvent Server will not incorporate a cached ObjectID or Timestamp in its feature record polls.
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:

  • ObjectIDGeoEvent Server will cache the greatest object identifier from the feature record set returned from a map/feature service poll. Only features whose object identifier is greater than the value cached from the last poll will be included in the next poll.
  • TimestampGeoEvent Server will cache the greatest timestamp from the feature record set returned from a map/feature service poll. Only features whose timestamp is greater than the value cached from the last poll will be included in the next poll.
  • Timestamp until now—Intended for use specifically when editor tracking is enabled, this option will use the last poll time rather than the greatest timestamp from the polled feature record set. If polling is set to 300 seconds, for example, queries will request feature records whose specified timestamp is within a polling interval relative to now.

    For example, the polling interval may be last_edited_date >= timestamp '2021-09-23 00:38:04.075' and last_edited_date < timestamp '2021-09-23 00:43:04.583' where 00:38:04 was the last poll and 00:43:04 is five minutes (300 seconds) later. Any feature records edited within the polling interval would be returned by the query.

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:

  • 1=1—Default, used to construct the clause WHERE 1=1 to poll all available feature records.
  • track_id LIKE '%AJP'—Matches feature records with the literal string AJP anywhere in the TRACK_ID string.
  • reported_dt > timestamp '2019-04-05 22:30:00'—Matches feature records whose date/time attribute value is greater than the specified timestamp.

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.

  • Yes—A spatial filter will be used for querying features from the feature layer.
  • No—A spatial filter will not be used for querying features from the feature layer.

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.


Dans cette rubrique
  1. Usage notes
  2. Parameters