Skip to main content

Feature Layer (existing)

The Feature Layer (existing) output in ArcGIS Velocity allows you to write output features to an existing hosted feature layer (spatiotemporal), an existing hosted feature layer in your ArcGIS Enterprise organization, an existing ArcGIS Online organization hosted feature layer, or an existing ArcGIS Server site hosted feature layer. Velocity writes features to an existing feature layer, as opposed to creating one.

Examples

The following are example use cases for the output:

  • After ingesting real-time features from IoT sensors through a feed and a real-time analytic, an asset manager wants to add those observations to an existing feature layer.

  • A business analyst configures a real-time analytic that ingests historical observations from an external cloud store, processes events as they occur, and captures the new observations in an existing feature layer.

Usage notes

Note the following when working with the output:

  • The selected feature layer must be a hosted feature layer (spatiotemporal), a hosted feature layer in your ArcGIS Enterprise organization, an ArcGIS Online organization hosted feature layer, or an ArcGIS Server site hosted feature layer.

  • The schema of the incoming data and the destination feature layer must generally match. Each must have the same geometry type and spatial reference, and the fields present in the incoming data must exist in the destination feature layer. Differences can include the following:

    • The destination feature layer can have more fields not present in the incoming data that you can use for data enrichment.

    • The TRACK_ID and START_TIME fields in the incoming data schema do not have to match those in the destination feature layer when using ArcGIS Online or ArcGIS Server feature layers.

  • Use the Map Fields tool to transform the schema of the incoming data in an analytic workflow to align with the schema of the output feature layer.

  • When the incoming data schema does not include a value for the TRACK_ID field, you can write to a feature layer (existing) output that does not have a track ID. Keep the following behavior in mind:

    • When writing with the Keep only latest feature for each Track ID value data storage method option, Velocity writes all incoming features to the target dataset.
  • Reference ArcGIS Server feature layers by using an ArcGIS organization item ID. To do this, go to your ArcGIS organization content page and add an item that references the layer by URL. If applicable, store credentials with this ArcGIS organization item. You can then configure the hosted feature layer (spatiotemporal) existing output to point to this ArcGIS organization item ID.

  • A hosted feature layer (spatiotemporal) requires a data retention policy for all outputs because data grows over time. When writing to an existing feature layer and using the Add all new features option in the Data storage method parameter, the selected feature layer must have a data retention policy configured.

    Learn more about data retention

  • If the Data storage method parameter is set to Keep only latest feature for each Track ID value, Velocity updates the editor name, date, and time after the first observation.

  • When the Data storage method parameter is set to Keep only latest feature for each Track ID value, choose the Keep the newer feature for a Track ID based on Start Time option in the Advanced options section. Velocity then compares the time specified in the Start Time option of each incoming feature to the stored feature for that track ID and skips the write if the incoming feature is older. This preserves the latest observation when events arrive out of order (for example, from multiple feeds or analytics writing to the same layer).

    This parameter requires a START_TIME field. If no START_TIME field is defined, each feature is treated as new. This applies only to spatiotemporal feature layers.

  • The Simplify feature geometry parameter only applies to Velocity-hosted spatiotemporal feature layers. If your feature geometries are already simple, you can leave this parameter off to improve write performance.

Parameters

The following table describes the parameters for the output:

Parameter

Description

Data type

Feature Service Portal Item ID

The portal item ID of the corresponding feature layer item created in ArcGIS Enterprise.

You must create the feature layer when you create the analytic.

String

Data storage method

If checked (true), a spatiotemporal feature layer supports high-velocity ingestion, high-volume storage over time, dynamic aggregation, and automated data retention. This is the default.

  • Add all new features—Velocity adds all new features to the feature layer.

  • Keep only latest feature for each Track ID value—Velocity keeps only the latest feature for each unique track ID. The output data schema must have Track ID and Start Time options identified as key fields.

Boolean

Simplify feature geometry

Simplifies feature geometries to ensure that Velocity writes them to the database correctly. If you know the feature geometries are already simple, you can leave this parameter turned off to improve write performance.

This parameter is available in the Geometry options section under Advanced options.

Boolean

Keep the newer feature for a Track ID based on Start Time

This parameter is available in the Advanced options section when the Data storage method parameter is set to Keep only latest feature for each Track ID value.

When this parameter is set to Yes with the Track ID and Start Time options specified, Velocity keeps the newer feature per track ID and skips writes for older incoming features.

When this parameter is set to No (default), incoming features overwrite the stored feature for a track ID as they arrive.

This parameter requires a START_TIME field. If none is defined, a validation warning appears and each feature is treated as new.

Boolean

Creator and editor username

Specifies the creator or editor username for processed data. The username can be derived from a field of the incoming data or set as the analytic owner.

The Creator and editor username parameter is available only when the existing feature layer has editor tracking turned on.

Learn more about usage notes

String

Additional logging (optional)

Specifies whether Velocity enables logging for raw requests. The default is False.

Note:

Turn on this parameter only for troubleshooting, then turn it off when complete. Contact Esri Technical Support for help with troubleshooting.

Boolean