With a Flow you configure the way your IoT data should flow through KPN Things. You link one or more Devices to one or more Destinations through the Flow, and you determine the Data Processing in between. So, if data is received from a Device that is linked to a Flow, it's data will be processed as configured and then forwarded to the Destinations that are linked to the same Flow.
A Flow has the following attributes:
- UUID - the technical identifier of your Flow.
- Name - the name you give to your Flow.
- Description (optional) - further explanation of your Flow.
Data Processing configuration is the most important part of a Flow. It expresses how data from and to your Devices should be processed by KPN Things. This processing is useful, because your Destination does not always understand what your Device is saying, and vise versa. This data should be transformed or interpreted between your Device and Destination.
We distinguish two type of actors that process data:
- Decoders process data coming from your device (uplink data).
- Encoders process data going to your device (downlink data).
Uplink data is processed by Decoders, Downlink data is processed by Encoders.
Uplink data configuration has to do with to the data send from your Device and possible metadata coming along when data is send by your Device. An example of the latter is LoRa Geolocation data, location data that the LoRa network can determine when receiving the message from your Device.
We distinguish three types of data that can be enabled to forward to your Destination. Each type has its own symbol that is used in the name of the Decoder.
Downlink data configuration has to do with the data send to your Device. Often you want to send a clear instruction to your Device, which is transformed under water into a technical data message to your Device. This is where Encoders come into play. Next to that, also raw data can be send to your Device.
We distinguish two different ways of sending data to your Device, identified by a symbol in the name of the Encoder.
This page gives you an overview of the configuration of a Flow.
It shows you:
- 1.The name and description of your Flow.
- 5.Removed. The configuration of Device Twin values has been removed in favor of showing all possibles values by default.
- 6.The number of Destinations in your Flow and a smart link to the Destinations in your Flow.
If there is an issue with the configuration of your Flow, a warning icon is shown in the description of the concerning part of the configuration. Click on the warning label to find out more about the issue.
The smart link allows you to quickly get to the Devices and Destinations in your Flow from the overview page. Depending on the number of Devices or Destinations you have in your Flow, the card will link you to a different view:
0 objects: links you to the page to add a Device or Destination.
1 object: links you directly to the details of the one linked Device.
2 or more objects: links you to the Devices or Destinations in Flow page.
The Flow detail page shows the details of your Flow (#1 in the screenshot) and it allows you to edit the name and description of your Flow by clicking Edit (#2 in the screenshot).
This page shows you the Devices that are linked to the current Flow.
Elements on this page are:
- 1.The number of Devices in the current Flow.
- 2.The list of devices, showing their name, device type and last message time.
- 3.A button to add another Device to this Flow.
- 4.Checkboxes that allow you to start bulk actions.
After selecting one or more Devices you enter the bulk editing mode. This allows you to select several Devices (#1 in the screenshot below) or all Devices at once (#2 in the screenshot below). After you completed your selection, click on the desired action in the bulk action bar in the bottom of your screen. In this case, you can Unlink all selected Devices from the current Flow.
When adding another Device to a Flow, you have two choices:
- 1.Add a new Device - register a complete new device to KPN Things and directly add it to the Flow.
- 2.Link an existing Device - link a device that is already registered to KPN Things. You can add one Device to multiple Flows.
At this step you can select the decoders you want to enable for this device type in the current Flow by checking the corresponding decoder (like #1 in the screenshot above). If you have previously activated decoders on this Flow for this Device type, they will be already checked (like #2 in the screenshot above). Learn more about Decoders.
This page will show you an overview of all Devices already linked to your Flow and other available Devices. There are two methods to link existing Devices to a Flow:
- 1.By clicking Link on the row of a Device, you link that single Device to the Flow.
- 2.By selecting a checkbox in a row of a Device, you start with linking multiple Devices to the Flow.
After selecting one Device you can select more using the checkboxes (#1 in the screenshot below), or even select all Devices you have using the checkbox in the top row (#2 in the screenshot below). When you finalized your selection you can commit the linkage with the button Link selected (#3 in the screenshot below).
The Data Processing in Flow page shows you the configuration of the data processing for Devices in that Flow.
When you visit the page, it first shows you the Device types that are present in the Flow. For each Device type it shows the number of devices linked to the Flow (#1 in the screenshot below), and the number of Decoders and Encoders enabled for that Device type (#2 in the screenshot below.
After you clicked on one of the Device types, all available Decoders (#1 in the screenshot below) and Encoders (#2 in the screenshot below) are shown for that Device type. The toggles to the right of the list (#3 in the screenshot below) indicate whether a Decoder or Encoder is enabled for that Flow. Learn more about Data Processing configuration.
If there is a possible issue with your data processing configuration, a warning icon is shown for the concerning Device type (#1 in the screenshot below) and a warning message is shown explaining the issue (#2 in the screenshot below). We offer three possible solutions for the issue:
- Show you where to fix the issue (#3 in the screenshot below)
- Fix it for you (#4 in the screenshot below)
- Let you ignore the warning (#5 in the screenshot below)
This page shows you the Destinations linked to the current Flow.
On this page you can see:
- 1.The number of Destinations in the current Flow.
- 3.A button to add another Destination to your Flow. If you have reached the maximum number of Destination links in your Project, this button will be disabled.
When adding a Destination to a Flow, you have two options, as illustrated in the screenshot above:
- 1.Create a new Destination
- 2.Select an existing Destination to link to your Flow
After selecting the desired Destination in the drop down menu, click Add Destination to link the selected Destination to your Flow.