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”