MQTT-Transferobjekt

Mit dem MQTT-Transferobjekt veröffentlichen Sie Nachrichten auf einem MQTT-Topic. Voraussetzung ist, dass die gewünschte Brokeranbindung bereits im MQTT Plug-in konfiguriert wurde.

Die folgende Abbildung zeigt den Reiter Allgemein des MQTT-Transferobjekts.

Stellen Sie nach Doppelklick auf das Transferobjekt folgende Eigenschaften ein:

Eigenschaft	Beschreibung
Brokeranbindung	Wählen Sie die konfigurierte MQTT-Brokeranbindung aus, über die die Nachricht veröffentlicht werden soll.
Dynamisches Topic	Aktivieren Sie diese Option, wenn das Ziel-Topic nicht fest vorgegeben ist, sondern zur Laufzeit über einen Eingabewert gesetzt werden soll.
Topic	Name des Ziel-Topics, auf dem die Nachricht veröffentlicht wird. Über Start Browsing kann zusätzlich eine Topic-Auswahl ausgehend von der aktuellen Brokerverbindung angestoßen werden.
Servicequalität	Legt den Quality-of-Service-Wert für die Veröffentlichung fest. 0 sendet ohne Bestätigung, 1 mit einfacher Empfangsbestätigung und 2 mit vollständiger Zustellabsicherung. Mit Plug-in-Einstellung übernehmen wird der im MQTT-Plug-in hinterlegte Standardwert verwendet.
Payload-Datentyp	Legt fest, ob der Nachrichteninhalt als Byte Array oder als String an den Broker gesendet wird.
Payload-Kodierung	Legt die Zeichencodierung für String-Payloads fest. Diese Einstellung ist relevant, wenn der Payload-Datentyp String verwendet wird.
Retain	Veranlasst den Broker, die veröffentlichte Nachricht als letzte bekannte Nachricht für dieses Topic zu speichern. Neue Subscriber erhalten diese retained Nachricht unmittelbar nach der Subscription.

hinweis

Im Reiter Allgemein sind nicht immer alle Eigenschaften verfügbar. Welche zusätzlichen Optionen angezeigt werden, hängt vom gewählten MQTT-Profil der ausgewählten Brokeranbindung ab.

| Antwort-Topic und/oder Korrelationsdaten verwenden | Aktiviert zusätzliche MQTT-5-Angaben für Antwort-Topic und Korrelationsdaten. Diese Optionen sind relevant, wenn Nachrichten nach dem Request-Response-Muster verarbeitet werden sollen. | | An Topic veröffentlichen | Veröffentlicht die Nachricht auf dem unter Topic angegebenen Ziel-Topic. | | An Antwort-Topic senden | Veröffentlicht die Nachricht stattdessen an ein definiertes Antwort-Topic. Diese Option ist für Antwortnachrichten in MQTT-5-Szenarien vorgesehen. |

Bestätigen Sie Ihre Eingaben mit „OK“.

---

MQTT 5 Benutzer-Eigenschaften

Der Reiter MQTT 5 Benutzer-Eigenschaften dient dazu, zusätzliche Metadaten zur veröffentlichten Nachricht zu übertragen.

MQTT-5-Benutzer-Eigenschaften sind frei definierbare Informationen, die als zusätzliche Schlüssel-Wert-Paare mit einer Nachricht gesendet werden. Sie gehören nicht zum eigentlichen Payload, sondern ergänzen ihn um beschreibende Metadaten.

Typische Einsatzfälle sind:

• Kennzeichnung der Herkunft einer Nachricht, zum Beispiel Quelle=OPC Router
• Ergänzung fachlicher Metadaten, zum Beispiel Anlage=Linie 3 oder Nachrichtentyp=Alarm
• Übergabe von Versions- oder Formatangaben, zum Beispiel SchemaVersion=1.0
• zusätzliche Auswertungen in empfangenden Anwendungen, Bridges oder Integrationsdiensten

Über die Plus-Schaltfläche fügen Sie neue Benutzer-Eigenschaften hinzu. Verwenden Sie diese Funktion nur, wenn das empfangende System MQTT-5-Benutzer-Eigenschaften auch tatsächlich auswertet. Wenn der Empfänger diese Metadaten nicht benötigt, können Sie den Reiter leer lassen.

hinweis

MQTT-5-Benutzer-Eigenschaften sind nicht dafür gedacht, den eigentlichen Nachrichteninhalt zu ersetzen. Fachdaten, die immer verarbeitet werden müssen, gehören weiterhin in den Payload oder in eine klare Topic-Struktur.