MQTT Advanced Listener

Allows a user to receive data from a device or other source by listening to a specific MQTT topic as the device publishes the data to that same MQTT channel or topic.

Configuration

To add the MQTT Advanced Listener to a stream, follow the steps below:

1. Ensure you have a use case open in the stream designer, this can be a new use case or an existing use case
2. From the toolbox on the left expand the Listener option and scroll down until you can see “MQTT Advanced”
   • You can also use the search in the header to find the stream object quickly
3. Click and drag the MQTT Advanced Listener from the toolbox onto the canvas
4. Rename the Listener by clicking into the text button un the action bar
5. Save the Stream by clicking the save button in the action bar
6. Hover over the icon for the stream object until it turns orange and then double click to open the configuration page
   • You can optionally use the configure option on the action bar once you have selected the specific stream object and then clicking this option
7. Configuration options
   • The drop down allows you to associate this stream object with a specific collection. The default option is derived from the default specified against the specific use case and is generated left as the same option. If you do need to change it to another collection make the change by selecting the new collection in the drop down.
   • Enter a value for the Polling Interval (the interval at which new records are accessed/checked for, in seconds)
8. Enter Broker Settings
   • Specify the Address
   • Specify the Channel
   • Specify the Port
   • Specify the Client ID
   • Specify the QoS (Quality of Service).
   • Select the Clean Session. Tick if non- persistent session required
9. Select Channel Settings
   • Secure Channel. Default blank
10. Enter Authentication Settings
    • Specify Username
    • Specify Password
11. Enter Payload Details
    • Select Payload format – JSON
      • Specify the JSON path for payload. This is only required if the payload has a nested structure
      • Select Include Source Message in Payload
      • Add Names in Payload Table
    • Select Payload format –   For each column
      • Enter Column Name
      • Enter Index
12. Click Apply on the action bar, and save the stream using the Save button.

Limitations

None at this time.