| Broker-Name | Der Name des Brokers. Dieser wird vom Aufruf verwendet, um den korrekten Broker auszuwählen. |
| Broker-Hostname | Hostname des Broker IPv4 ODER Hostname! |
| Port | Der Port, auf dem der Broker läuft (1883 ist Standard für TCP und 8883 ist Standard für SSL). |
| TLS | TLS-Verschlüsselung. Noch nicht verfügbar! |
| Keep-Alive | Die Anzahl der Sekunden, die der Client aktiv gehalten werden soll, wenn keine Aktivität stattfindet. |
| Clean-Session | Bestimmt, ob die Sitzung nach einer Wiederverbindung bereinigt wird. |
| Last-will-Thema | Das Thema, für das eine Nachricht gesendet wird, wenn der Client stirbt (Testament). |
| Last-will-Payload | Die Nachricht für das Testament. |
| Last Will Retained | Flag, um zu entscheiden, ob die Nachricht vom Broker gespeichert werden soll. |
| Last Will QoS (Quality of Service) |
Flag, um zu entscheiden, wie oft die Nachricht gesendet wird. |
| Mehrfache Ausführungen bei Umsortierung zulassen | Wenn Sie die “order”-Liste senden, um die gegebenen Operationen neu anzuordnen, können Sie mit diesem Flag entscheiden, ob Operationen mehrmals ausgeführt werden sollen. |
| Continue after an exception | Flag, um zu entscheiden, ob die nächste Operation nach einem Fehler ausgeführt werden soll oder ob die Ausführung vollständig gestoppt wird. |
So verwenden Sie einen MQTT-Konnektor in einem REST-Client
Sie können zwischen 2 Operationen wählen: PUBLISH und SUBSCRIBE.
Erstellen Sie die Payload wie folgt:
| Parameter | Beschreibung |
|---|---|
| operationType | Typ der Operation, PUBLISH oder SUBSCRIBE. |
| brokerName | Der Name des Brokers, wie er in den Konnektor-Details angegeben ist. Wenn kein Name angegeben ist, wird der Standard-Broker ausgewählt. |
| returnSet (für SUBSCRIBE-Operationen) | Option, welche Informationen die eingehenden Nachrichten enthalten. “STANDARD”: Nur die Payload und das Thema werden angezeigt. “WITH_QUALITY_INFORMATION”: Äquivalent zu “STANDARD”, aber zusätzlich mit Informationen, ob die Nachricht dupliziert / zurückgehalten wird und QoS. “VERBOSE”: Wie zuvor, aber auch mit Client-ID sowie Nachrichten-ID. |
|
Parameter für das Objekt “clientInformation” |
|
| clientId | Die ID des Clients. Da sich nicht zwei Clients mit identischer ID auf demselben Broker verbinden können, ist Vorsicht geboten. Wenn dieser Parameter weggelassen wird, wird eine zufällige ID vom Programm generiert. |
| forceReconnection | Einstellung, ob sich der Client wieder verbinden soll. |
|
Parameter für das Objekt “messages” |
|
| qos | Die Quality of Service-Einstellungen: “AT_LEAST_ONCE”, die Nachricht wird mindestens einmal gesendet. “ONCE”, die Nachricht wird genau einmal gesendet. “AT_MOST_ONCE”, die Nachricht wird 0 oder 1 Mal gesendet. |
| topic | Das Thema, für das die Nachricht veröffentlicht wird. |
| retain | Einstellung, ob die Nachricht im Broker gespeichert werden soll. |
| payloadInformation | Meta-Informationen für die Payload. ***Wird momentan nicht verwendet.*** |
| payload | Die Payload als String. |
Veröffentlichen
Wenn Sie 1 Nachricht veröffentlichen möchten:
"operations": [{"operationType":"PUBLISH","brokerName":"testBroker","clientInformation": {"clientId":"client1","forceReconnection":"true"},"messages": [{"qos":"AT_LEAST_ONCE","topic":"myTopic","retain":"true","payloadInformation":"JustMetaInformation","payload":"PayloadA"}]}]
Wenn Sie n Nachrichten veröffentlichen möchten:
"operations": [{"operationType":"PUBLISH","brokerName":"testBroker","clientInformation": {"clientId":"client1","forceReconnection":"true"},"messages": [{"qos":"AT_LEAST_ONCE","topic":"myTopic","retain":"true","payloadInformation":"JustMetaInformation","payload":"PayloadA"},{"qos":"AT_LEAST_ONCE","topic":"myTopic2","retain":"true","payloadInformation":"JustMetaInformation2","payload":"PayloadB"}]},]
Veröffentlichen mit mehreren Operationen (publish + publish)
"operations": [{"operationType":"PUBLISH","brokerName":"testBroker","clientInformation": {"clientId":"client1","forceReconnection":"true"},"messages": [{"qos":" AT_LEAST_ONCE ","topic":"myTopic","retain":"true","payloadInformation":"JustMetaInformation","payload":"PayloadA"}]},{"operationType":"PUBLISH","brokerName":"testBroker","clientInformation": {"clientId":"client1","forceReconnection":"true"},"messages": [{"qos":"AT_LEAST_ONCE","topic":"myTopic","retain":"true","payloadInformation":"JustMetaInformation","payload":"PayloadA"},{"qos":"AT_LEAST_ONCE","topic":"myTopic2","retain":"true","payloadInformation":"JustMetaInformation2","payload":"PayloadB"}]}]
Abonnieren
Wenn Sie n Themen abonnieren möchten:
{"operationType":"SUBSCRIBE","returnSet":"VERBOSE","brokerName":"testBroker","clientInformation": {"clientId":"clientSubscribe","forceReconnection":"true"},"topics": ["test","myFancyTopic"]}












