Managing GeoEvent Definitions
What is a GeoEvent Definition?
Every GeoEvent within GeoEvent has an associated schema that identifies the attribute fields and data types (date, string, integer, and so forth) for the event's data. This schema is referred to as a GeoEvent Definition. View GeoEvent Definitions by browsing to Site > GeoEvent Processor > GeoEvent Definitions in GeoEvent Processor Manager.
Note:A GeoEvent Definition named incident is included with GeoEvent Processor. Do not delete or modify this GeoEvent Definition; the Incident Detector Processor uses it to support incident detection and feature service updates.
A GeoEvent Definition consistent with the data in an event stream must exist in order for an Input Connector to construct a GeoEvent from the events coming in. Similarly, a GeoEvent Definition consistent with the schema of a designated output must exist in order for an Output Connector to construct a GeoEvent and send the event data.
GeoEvent Definitions can be created and edited by users. Some Input Connectors are able to create event definitions based on data they discover in the events received. Administrators import event definitions to support operations such as updating published feature services. This means the list of known GeoEvent Definitions frequently changes.
The Introduction to GeoEvent tutorial contains exercises illustrating how to create a GeoEvent Definition, how an Input Connector builds a GeoEvent Definition from data it receives, and how to import a GeoEvent Definition from a published feature service. Access the Introduction to GeoEvent tutorial from GeoEvent Processor tutorials.
GeoEvent Definition field data types
Each field contained in a GeoEvent Definition has an associated data type. This data type is used when Input Connectors construct a GeoEvent from streaming data or GeoEvents are deconstructed prior to sending a GeoEvent through an Output Connector.
The available data field types are as follows:
- Boolean
- Date
- Double
- Float
- Geometry
- Group *
- Integer
- Long
- Short
- String
* See the Field groups section below for more information.
Field cardinality
Some event-based data streams define schemas in which a single field has multiple entries, like an array. These fields are represented in GeoEvent Definitions as fields with a cardinality greater than one. Field cardinality is an advanced feature meant to support data streams in which this condition is found.
Administrators can configure a GeoEvent Definition's cardinality in GeoEvent Processor Manager by changing the cardinality of a field from One to Many.
Field groups
Some data streams define schemas in which a single field is not a discrete data type (for example, date, string, and integer) but is instead a group containing multiple types of data values. These fields are represented in GeoEvent Definitions as Groups. The discrete data types of each field within a group will be found indented beneath the field group's name.
Support for field groups is another advanced feature meant to support data streams in which this condition is found. A group field type can contain nested groups, enabling complex structures to be created.
Configure a GeoEvent Definition's field to be a group field in GeoEvent Processor Manager by changing the type of field to Group.