Configure a Subscription

Overview

Fig. 1 – Create a new subscription
Symbol
Description
Details

[A]

Topic preview

In this section, you see a preview of the incoming data

[A1]

Input for the topic preview

Enter an MQTT topic here. Its data appears in the preview. Important: In this field, you do NOT enter the topic to which you want to create a subscription – this is done in [C]

[B]

Name

Give the subscription a name. The subscription is displayed in the subscription list (in the broker details) under this name

[C]

Topic

Enter the MQTT topic here to which you want to create a subscription.

[D]

QoS (Quality of Service)

Select a value. The QoS indicates the level of message delivery between the MQTT broker and the connected clients

[E]

One or more formats

Choose whether a single format or multiple formats should be applied to the incoming data. -> One or more formats

[F]

Create format

If you want to define a new format, click here. The window ↗ Configure Format opens

[G]

Select existing format

Alternatively to [F], you can also select an existing format

[H]

Save

Click to save the subscription

One or more formats

Choose whether a single format or multiple formats should be applied to the incoming data.

◈ If you select Single, the same format is used for all incoming data.

◈ If you select Multiple, you can differentiate the processing of the data – depending on the topic. This means: Within a subscription, different topics can be processed with different formats. For this, you use patterns to determine which data belongs to which format.

Example:

You subscribe to the topic levels/+. There are two actual topics:

  • levels/level1 → this data should be processed with Decoder A

  • levels/level2 → this data should be processed with Decoder B

Then in multiple mode, you enter two pairs:

Pattern
Format

levels/level1

Decoder A

levels/level2

Decoder B

▷ This way, the data is automatically decoded with the correct format depending on the topic.

Last updated