mqttSession (Type of variable)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Properties specific to the description of mqttSession variables
Authentication mode
Functions that handle the mqttSession variables

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Managing MQTT

mqttSession (Type of variable)

In french: mqttSession

The mqttSession type is used to define the parameters for connecting to the MQTT broker. These connection parameters can be defined and modified by several WLanguage properties.

Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

// Déclaration de la connexion MQTT
gMqttSession is mqttSession

// Récupère les données saisies dans la fenêtre de connexion
gMqttSession.Address = SAI_Adresse_Broker
gMqttSession.Port = SAI_Port
gMqttSession.Option = INT_SSL
gMqttSession.ConnectionTimeout = SAI_Timeout_Connexion
gMqttSession.User = SAI_Login
gMqttSession.UserPassword = SAI_PSW
gMqttSession.PrivateKey = SAI_Clé_Privée
gMqttSession.PrivateKeyPassword = SAI_PSW_Clé_Privée
gMqttSession.ClientID = SAI_IDClient
gMqttSession.CleanSession = INT_Session_Vierge
IF MQTTConnect(gMqttSession) THEN
Message("Connexion OK")
ELSE
Error("Problème de connexion. '" + ErrorInfo() + "')")
END

Remarks

Properties specific to the description of mqttSession variables

The following properties can be used to handle a MQTT session:

Property name	Type used	Effect

Address	Character string	Address of MQTT server (also called "MQTT broker"). This address can be given in the following format: IP address in XXX.XXX.XXX.XXX format (125.5.110.100 for example). IP address containing the server name (MQTTServer for example). This syntax is recommended.
PrivateKey	Character string or Certificate variable	Name of the Certificate variable or path of the pem file (to make a private key connection). If this property is specified, an authentication by key is performed: only the User, PrivateKey and PrivateKeyPassword properties are taken into account.
ClientID	Character string	Client identifier. This property must not be left empty.
PrivateKeyPassword	Character string	Password of key file (for a connection by private key). The PrivateKey property corresponds to the private key to be used.
UserPassword	Character string	User's password used in password authentication (the User property is the user's name).
Option	Integer constant	Connection options. This property can correspond to the optionSSL constant for an SSL connection.
Port	Integer	Port of MQTT server. This port correspondsn to 1883 by default (or 8883 for an SSL connection).
CleanSession	Boolean	True to clean the generic global parameters on the server, False otherwise.
ConnectionTimeout	Integer ou Duration	Connection timeout in seconds. This property can correspond to: an integer corresponding to the number of seconds, a Duration variable, Versions 23 and later the duration in a readable format (e.g., 10 s). New in version 23 the duration in a readable format (e.g., 10 s). the duration in a readable format (e.g., 10 s).
User	Character string	Name of the user.

Authentication mode

The authentication by key has priority over the authentication by password.

Key authentication is used if:

the server supports this authentication mode.
the PrivateKey property is specified.

Password authentication is used if:

the server supports this authentication mode.
the UserPassword is specified.

Functions that handle the mqttSession variables

The following functions are used to handle the mqttSession variables:


Versions 22 and later MQTTConnect New in version 22 MQTTConnect MQTTConnect	Used to connect to a MQTT server (also called "Broker").
Versions 22 and later MQTTDisconnect New in version 22 MQTTDisconnect MQTTDisconnect	Allows you to disconnect from a MQTT server (also called "Broker").
Versions 22 and later MQTTPublish New in version 22 MQTTPublish MQTTPublish	Publishes a message on the MQTT broker.
Versions 22 and later MQTTSubscribe New in version 22 MQTTSubscribe MQTTSubscribe	Used to subscribe to a MQTT notification.
Versions 22 and later MQTTUnsubscribe New in version 22 MQTTUnsubscribe MQTTUnsubscribe	Used to unsubscribe from a MQTT notification.
Versions 22 and later MQTTUnsubscribeAll New in version 22 MQTTUnsubscribeAll MQTTUnsubscribeAll	Allows you to unsubscribe from all the existing subscriptions.