Publish Data

Publish Data The Publish Data tab opens the Data panel which is used to:

Channel Panel

The channel panel displays the list of all the channels used by the device to publish data. Channels are displayed in a hierarchical way for easier navigation.

Channels that have sub-channels are preceded by an arrow head. Clicking on a channel will display its data on the data panel and its sub-channels in the channel panel.

Channels may be Deleted along with all their data and sub-channels by clicking on the (Delete) delete icon.

To reload the channel list, click on the Reload (Reload) button.

Back to Top

Data Published

The Data Published panel displays all the data published by the device on the channel selected.

The panel displays the:

  • Channel name containing the data.
  • Timestamp, which indicates when the data was published.
  • Expiration date, which indicates when the data will be permanently erased from the CloudPlugs platform, and
  • Data in JSON format.

The panel’s top ribbon allows the following operations:

  • Publish (Publish Data) new data.
  • Open and edit (Open) published data.
  • Delete (Delete) the published data.
  • Export (Export)the published data.

The bottom ribbon allows navigation of pages of published data. The reload button(Reload) reloads the published data panel.

Back to Top

Publishing Data

This functionality allows to publish data impersonating a device (Prototype, Thing, Controller). It is used to test specific device or application behavior when certain data is received by the platform.

Data may be:

  1. Numeric positive or negative.
  2. Alphanumeric.
  3. Structured JSON.
  4. Location coordinates in a JSON structure.

To publish data:

  1. Open the Publish Data window with the New Data (New) button in the Data Panel.

  2. Select the Publisher which can be one of:

    • Company - a universal publisher that is not associated with any device and whose data published is visible to all devices.
    • Prototype - a Prototype device.
    • Thing - a Production Thing device.
    • Controller - a Controller device.
    • Plug-ID - the Plug-ID of the device that will publish data.

    An additional selection dropdown menu allows to choose an existing Prototype, Thing or Controller. If the Publisher is Company or Plug-ID, the Plug-ID of the device publishing data is automatically filled in.

  3. Enter the target channel name. If an existing channel name matches the channel as it is entered, it will be suggested to you.

  4. Enter the data which can be:

    • Positive or negative number or numbers. If more than one number is entered then:
      1. Only the last number is accepted if they are separated by commas (e.g., enter 1,2 and only 2 is accepted). Same happens if you enter 1, in one line and 2 in the line below.
      2. Numbers entered in separate lines without a comma separator are accepted (e.g., entering 1 in one line and 2 in another results in data “1 2”.
      3. Decimal numbers are accepted.  For example, 1.2 is accepted as 1.2.  1.2, 1.3 results in 1.3 being published.
  • Alphanumeric data. You can publish data such as "abc", "1 23 ab c", "1;3;x;y;z" etc.
  • Structured JSON objects. JSON objects have the syntax:
    {
    	"internal": 70,
    	"external": 90
    	}
  • Location coordinates, which have the syntax:
    {
    	"x": 70.1234578676,
    	"y": -65.098080890
    	}

    where x is the longitude and y is the latitude relative to Greenwich.

  1. Select the date and time of publishing. Back dates are allowed.
  2. Select the expiration date and time of the data. Only future times are allowed. Data can live as little as one (1) minute and it can live 10 years or more.
  3. Save and Close (Save and Close) to see the data displayed on the Data panel and on the chart.

The following images display the publish action of Prototype “Test1” of temperature value 80 on channel test1/temp, and the result of multiple publish actions on the same channel.

Generate Test Data

Back to Top

Edit Published Data

Data that has been published can be edited as follows:

  1. Select and Open the published data of interest by double clicking on it or using the Open (Open) button.
  2. Modify the expiration date to a past or future time period.
  3. Modify the data itself with any valid JSON.
  4. Save (Save) or Save and Close (Save & Close).

The images below show a published data before and after its expiration data and value have been modfied.

Data 1 Data 1

Back to Top

Export Published Data

The data published in a channel can be exported into .CSV files. JSON structures will be exported as such.

IMPORTANT!

The export action will export all the data existing in the selected channel.

To export the data of a particular channel:

  1. Select the channel or sub-channel from the Channels Panel.
  2. Click on the Export (export) button.
  3. Open the .CSV file downloaded to confirm that the data has been properly received.

Back to Top

Create Data Views

The Views/Charts panel allows the creation and saving of custom data views that are updated in real time as data is published in the platform. By default, the platform creates and updates line charts when numeric data is published.

To create or save a data view:

  1. Double click on the row containing the channel for which you want to create a data view.
  2. Enter a Name for the Data View.
  3. Select a layout. Multipanel layouts allow you to create multiple views of the data from one or multiple channels.
  4. Click on the panel you want to configure and enter the required data:
    • Publisher - a Prototype, Thing, Controller, a device identified by a Plug-ID, any device or Company. The data published by Company is visible to all devices.
    • Channel - from which the data will be read.
    • Data Field - if the data is a JSON with data fields
    • Title - gives a title to your chart
    • Select the type of chart which can be a Line, Bar, Gauge or Map chart.
    • Enter the starting date for the chart and the period that you want to display. These parameters do not apply to Gauges.

Line charts allow color and fill selection.
Bar charts allow color selection and Map charts only start date and period. Gauges have their own set up.

In addition, the following actions can be made on Data Views:

  1. The Data View panels can be edited by clicking on the panel’s gear icon.
  2. Time based charts allow:
    • Scrolling over time periods with the forward (>) and backwards (<) arrows.
    • Zoom into a period. Simply position your pointer on the desired date and drag a rectangle over the period you want to zoom into. To unzoom click on the (Unzoom) button.

Here are two examples for creating numeric and location based data views.

Back to Top

Numeric Data Views example

Here is an example that shows how to create a data view from numeric data for a Prototype device. The process is similar for Things and Controllers.

  1. Open the device and then open the Data tab ( data ).
Published data
  1. Open the unsaved Data View to edit it. You can open it by double clicking on it, or selecting and clicking on the Open button ( open )
Published data
  1. Enter a Name for the view and select a Layout type. For this example, we choose to have two panels.
Edit view 2
  1. Click on the line chart to bring up the configuration gear icon, and press on the icon.

  2. Configure the line chart as desired. Here we selected to have a filled chart with orange color.

Edit view 3
  1. Save and Close ( save and close ) the configuration window.

  2. Click on the Configure gear on the second panel.

Edit view 4
  1. Let’s configure a gauge as follows and save the configuration.
Edit view 5
  1. The result is as follows.
Edit view 6

Note that due to space limitations, the device view will only show the line chart, as shown below. However, the View created can be accessed from the Published Data ( Published Data ) -> Data Views application.

Edit view 6

Back to Top

Location Data Views Example

This example shows how to create a data view based on location data of a mobile device.

  1. Publish location data in a channel that we call location as shown below. As the data gets published the trace of movements is shown on the Views / Charts panel.

Note that clicking on a point indicates the number of the data point and the timestamp. See the image below. We clicked on the 3rd data value and its number and timestamp are displayed on the chart.

Location 1
  1. Double click on the unsaved Data View to open it and set its properties.

  2. Enter a Name and select a Layout. For this example, the Layout will be 1.

  3. Click on the configuration gear, give the map a Title and set up the time period that will be charted.

  4. Save (Save) or Save and Close (Save & Close) the new Data View. The result is shown below.

Location 2

Back to Top

Still need help? Get in touch!
Last updated on 15th Feb 2019