Event Schema Management

Search…
General Information
With the Event Schemas, you define how the data coming from the SF Edge devices should be structured. Meaning that depending on your Event Schemas the representation of the data points sent by the SF Edge devices will be different in the Dataset Builder.
An event schema consists of a schema name, key, and its attributes. Every attribute consists of a name, key, data type, and a unit (and if the data type is double a number of decimals). You can picture the schema as a table and the attributes as columns of this table.
The following picture shows how the definition of the schema affects the structure in the dataset builder.
The data type of the attributes defines how the data should be interpreted and if the data is valid. The unit helps you describe your data and can make widgets more explanatory.
Note that you do not need to represent all data points of a machine in one schema you can use multiple schemas. For example one schema for sensor data and one for alarms. On the other hand, not everything a machine sends must have all attributes. Every column is allowed to have NULL entries. In general, it depends on your data how many schemas are practical for you. 
Note that schemas can not be deleted from the UI and attributes can only be deleted before publishing, meaning that you will have to contact us if you want to delete a schema or an attribute.
After saving your schema you need to publish it if you want an edge client to be able to send data for this schema.
The status displayed next to every attribute tells you if this attribute has been published already. Active means that it was published.
It is not allowed to create attributes with the metadata keys (Id, Inserted, Size, Thing, Timestamp, Type) explicitly. Every schema will have those attributes automatically.
Matching Schema to SF Edge Configurations
If a SF Edge is supposed to send data to the platform (via MQTT) some configurations need to match the defined event schemas, basically, we need to define which data point goes into which attribute. For detail have a look at Edge Data Routing.
Invalid Messages
If you configured an edge that is supposed to send data to the platform but you can not find any entries in the respective schemas in the dataset builder have a look at the invalid messages. The following video shows you how to access them.
FAQ and Troubleshooting
Importing a Event Schema
Last modified 3mo ago
Copy link
Outline
General Information
Matching Schema to SF Edge Configurations