MQTT.PUBLISH¶
Publishes either a message or an arbitrary value using a specified Producer and topic. To reference a message from the outbox use the OUTBOX function and to reference a message from the Inbox use INBOX. You can use the Function Wizard for this function.
Syntax
=MQTT.PUBLISH(Producer, MessageOrValue, Topic [, QoS, User Properties])
Arguments
Name |
Description |
---|---|
Producer |
Producer to use for publishing. |
MessageOrValue |
Either an existing message from the outbox or a value to publish. |
Topic |
Topic that is appended to the base topic defined in the Connector. |
QoS |
Optional. Quality of Service. This option defines the reliability of the publish operation. It depends on the used protocol. |
User Properties |
Optional. Define Metadata. |
Return Value
TRUE, if successful.
Examples
All examples assume a base topic with the value “/cedalo” in the connector.
Function |
Result |
Comment |
---|---|---|
=MQTT.PUBLISH(“MQTT Producer”, “Message”, “test”) |
TRUE |
This publishes the string value “Message” using the “MQTT Producer” under the topic “cedalo/test” |
=MQTT.PUBLISH(“MQTT Producer”, OUTBOX(“Message”), “test”) |
TRUE |
This publishes the outbox message with id “Message” using the “MQTT Producer” and topic “cedalo/test” |
=MQTT.PUBLISH(“MQTT Producer”, JSON(A1:C2), “test”) |
TRUE |
This publishes a JSON object created by the json function using the “MQTT Producer” and topic “cedalo/test” |