Data Dictionary Specification

This space details the Data Dictionary deliverable required for integrating new IoT devices into Powerhouse Dynamics’ (PhD) Open Kitchen platform using ConnectWare.  

All data that is processed by ConnectWare is transmitted through HTTP requests from a ConnectWare Module (Can be Physical or Virtual) to the Open Kitchen Cloud (OKC).  The data is all described in JSON format.  JSON or JavaScript Object Notation is the standard language used by most SaaS applications.  JSON consists of what are known as “key pairs”.  E.g.

In the above example, a parameter “oil_temp” is being transmitted to the cloud. “oil_temp” is the key and 3601 is the value.

Open Kitchen can handle any kind of data that can be represented by key pairs.  The data can be simple like the above example, or it can be complex, such as arrays or nested groups of key pairs.  Except for some mandatory data dictionary items, the Open Kitchen software application does not know how to interpret the data being sent to it.  It simply will store the data in one of its databases for later interpretation.

The Data Dictionary document teaches Open Kitchen how to interpret and present the data. In the example above, “oil_temp” refers to a fryer vat cooking oil temperature.  The data dictionary would tell Open Kitchen to interpret the value (3601) as an integer representing temperature in tenths of degrees Fahrenheit. It would also indicate the standard precision to display the data, in this case 0 positions to the right of the decimal point. Open Kitchen would present the data like the following example:

Open

The Data Dictionary Template:

Open

Sections: