| Name des Brokers | Der Name des Brokers. Dies wird vom Aufruf verwendet, um den richtigen Broker auszuwählen. |
| Broker Hostname | Hostname des Brokers 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 (Englisch) | TLS-Verschlüsselung. Noch nicht verfügbar! |
| Keep-Alive | Die Anzahl der Sekunden, die der Client am Leben gehalten werden soll, wenn keine Aktivität stattfindet. |
| Clean-Session | Legt fest, ob die Sitzung nach einer erneuten Verbindung bereinigt wird. |
| Last will | topic 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 retain Flag | um zu entscheiden, ob die Nachricht vom Broker aufbewahrt werden soll. |
| Last will QoS (Quality of Service) | Flag, um zu entscheiden, wie oft die Nachricht gesendet wird. |
| Mehrfachausführungen in der Neuanordnung zulassen | Wenn Sie die “order”-Liste senden, um die gegebenen Operationen neu anzuordnen, können Sie mit dem Flag entscheiden, ob Operationen mehrmals ausgeführt werden sollen. |
| Nach einer Ausnahme fortfahren | Flag, um zu entscheiden, ob der nächste Vorgang nach einem Fehler ausgeführt werden soll oder ob die Ausführung vollständig gestoppt wird. |
So verwenden Sie einen MQTT Connector in einem REST-Client
Sie können zwischen 2 Vorgängen wählen: PUBLISH und SUBSCRIBE.
Erstellen Sie die Nutzlast wie folgt:
| Parameter | Beschreibung |
|---|---|
| operationType | Typ des Vorgangs, PUBLISH oder SUBSCRIBE. |
| BrokerName | Der Name des Brokers, wie er in den Connector-Details angegeben ist. Wenn kein Name angegeben wird, wird der Standardbroker ausgewählt. |
| returnSet (für SUBSCRIBE-Operationen) | Option, welche Informationen die eingehenden Nachrichten enthalten. “STANDARD”: Es werden nur die Payload und das Thema angezeigt. “WITH_QUALITY_INFORMATION”: Entspricht dem “STANDARD”, aber zusätzlich mit der Information, ob die Nachricht dupliziert / zurückgehalten wird und QoS. “VERBOSE”: Wie bisher, aber sowohl mit Client-ID als auch mit Message-ID. |
| Parameter für das Objekt “clientInformation” | |
| clientId (englisch) | Die ID des Clients. Da sich keine zwei Clients mit identischer ID auf demselben Broker verbinden können, ist Vorsicht geboten. Das Löschen dieses Parameters bewirkt, dass das Programm eine zufällige ID generiert. |
| forceReconnection | Einstellung, ob der Client die Verbindung wiederherstellen 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” wird die Nachricht 0 oder 1 Mal gesendet. |
| topic | Das Thema, für das die Nachricht veröffentlicht wird. |
| retain | Einstellung, ob die Nachricht im Broker verbleiben soll. |
| payloadInformation | Meta-Informationen für die Nutzlast. ***Wird zur Zeit nicht verwendet.*** |
| payload | Die Nutzlast als Zeichenfolge. |
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 Vorgängen (Veröffentlichen + Veröffentlichen)
"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 sich für n Themen anmelden möchten:
{"operationType":"SUBSCRIBE","returnSet":"VERBOSE","brokerName":"testBroker","clientInformation": {"clientId":"clientSubscribe","forceReconnection":"true"},"topics": ["test","myFancyTopic"]}
