What is a GeoEvent Definition?

Event data in the Extension 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 > GeoEvent Definitions in GeoEvent Manager.

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 Extension 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 tutorial from GeoEvent Extension 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 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 Manager by changing the type of field to Group.