MQTT-Subscribe (Trigger)
MQTT-Subscribe ist der MQTT-Trigger zum Überwachen konfigurierter Topics. Bei eingehenden MQTT-Nachrichten löst er den nachfolgenden Transfer aus. Der empfangene Nachrichteninhalt steht der Verbindung anschließend zur Weiterverarbeitung zur Verfügung.
In der Eigenschaftsmaske legen Sie fest, über welche Brokeranbindung die Subscription erfolgt und wie empfangene Nachrichten interpretiert werden:
Werden Topics über MQTT-Subscribe mehrfach in verschiedenen Verbindungen angebunden, kann es zu doppelten Auslösungen der einzelnen Verbindungen kommen.
Dies gilt auch für die Verwendung von Wildcards.
Die einzelnen Eigenschaften sind:
| Eigenschaft | Beschreibung |
|---|---|
| Brokeranbindung | Wählen Sie die konfigurierte MQTT-Brokeranbindung aus, über die das Topic abonniert werden soll. |
| Topic | Name des zu überwachenden Topics. Je nach Broker können auch Topic-Muster mit Wildcards verwendet werden. Ü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 Subscription fest. 0 verarbeitet Nachrichten ohne zusätzliche Bestätigung, 1 mit einfacher Empfangsbestätigung und 2 mit vollständiger Zustellabsicherung. Mit Plug-in-Einstellung verwenden wird der im MQTT-Plug-in hinterlegte Standardwert übernommen. |
| Warte auf Transfer | Legt fest, ob der Trigger auf die Ausführung des nachfolgenden Transfers wartet, bevor die Nachricht intern als verarbeitet gilt. |
| Payload-Datentyp | Legt fest, ob der empfangene Payload als Byte Array oder als String an die Verbindung übergeben wird. |
| Payload-Kodierung | Legt die Zeichencodierung fest, mit der String-Payloads interpretiert werden. |
| Nullwerte | Legt fest, wie empfangene Nullwerte behandelt werden. Im Screenshot ist beispielhaft Nullwerte verbieten ausgewählt. |
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.
| Eigenschaft | Beschreibung |
|---|---|
| Antwort-Topic- und Korrelationsdaten-Ausgabe aktivieren | Aktiviert zusätzliche MQTT-5-Angaben für Antwort-Topic und Korrelationsdaten in der Triggerausgabe. Diese Option ist relevant, wenn eingehende Nachrichten nach dem Request-Response-Muster verarbeitet und die zugehörigen MQTT-5-Informationen in der Verbindung weiterverwendet werden sollen. |
MQTT 5 Benutzer-Eigenschaften
Der Reiter MQTT 5 Benutzer-Eigenschaften dient dazu, MQTT-5-Benutzer-Eigenschaften aus empfangenen Nachrichten in der Verbindung verfügbar zu machen.
MQTT-5-Benutzer-Eigenschaften sind frei definierbare Schlüssel-Wert-Paare, die zusätzlich zum eigentlichen Payload übertragen werden. Sie enthalten also keine Nutzdaten im engeren Sinn, sondern ergänzende Metadaten zur Nachricht.
Typische Einsatzfälle sind:
- Kennzeichnung der Herkunft einer Nachricht, zum Beispiel
Quelle=Anlage 3 - Übergabe fachlicher Zusatzinformationen, zum Beispiel
Nachrichtentyp=AlarmoderBereich=Abfüllung - Weitergabe technischer Zusatzangaben, zum Beispiel
SchemaVersion=1.0 - Auswertung in nachfolgenden Transfers oder Zielsystemen, die MQTT-5-Benutzer-Eigenschaften gezielt berücksichtigen
Verwenden Sie diesen Reiter nur, wenn das empfangende oder nachfolgend verarbeitende System MQTT-5-Benutzer-Eigenschaften tatsächlich benötigt. Wenn diese Metadaten in Ihrem Ablauf keine Rolle spielen, kann der Reiter ungenutzt bleiben.
Wie beim MQTT-Transferobjekt ersetzen MQTT-5-Benutzer-Eigenschaften nicht den eigentlichen Nachrichteninhalt. Inhalte, die fachlich verarbeitet werden müssen, sollten weiterhin im Payload oder in einer klaren Topic-Struktur übertragen werden.