DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions MQTT
  • Propriétés spécifiques à la description des variables de type mqttSession
  • Mode d'authentification
  • Fonctions manipulant les variables de type mqttSession
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
mqttSession (Type de variable)
En anglais : mqttSession
Le type mqttSession permet de définir tous les paramètres de connexion au Broker MQTT. Ces paramètres de connexion peuvent être définis et modifiés à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
// Déclaration de la connexion MQTT
gMqttSession est un mqttSession

// Récupère les données saisies dans la fenêtre de connexion
gMqttSession.Adresse = SAI_Adresse_Broker
gMqttSession.Port = SAI_Port
gMqttSession.Option = INT_SSL
gMqttSession.TimeoutConnexion = SAI_Timeout_Connexion
gMqttSession.Utilisateur = SAI_Login
gMqttSession.MotDePasseUtilisateur = SAI_PSW
gMqttSession.CléPrivée = SAI_Clé_Privée
gMqttSession.MotDePasseCléPrivée = SAI_PSW_Clé_Privée
gMqttSession.IDClient = SAI_IDClient
gMqttSession.SessionVide = INT_Session_Vierge
SI MQTTConnecte(gMqttSession) ALORS
Message("Connexion OK")
SINON
Erreur("Problème de connexion. '" + ErreurInfo() + "')")
FIN
Remarques

Propriétés spécifiques à la description des variables de type mqttSession

Les propriétés suivantes peuvent être utilisées pour manipuler une session MQTT :
Nom de la propriétéType manipuléEffet
AdresseChaîne de caractèresAdresse du serveur MQTT (également appelé "Broker MQTT"). Cette adresse peut être donnée sous la forme :
  • Adresse IP au format XXX.XXX.XXX.XXX ( par exemple, 125.5.110.100).
  • Adresse IP contenant le nom du serveur (par exemple, ServeurMQTT). Cette syntaxe est conseillée.
CléPrivéeChaîne de caractères ou variable de type CertificatNom de la variable de type Certificat ou chemin du fichier de clés pem (pour réaliser une connexion par clé privée).
Si cette propriété est renseignée, une authentification par clé est réalisée : seules les propriétés Utilisateur, CléPrivée et MotDePasseCléPrivée sont prises en compte.
IDClientChaîne de caractèresIdentifiant du client. Cette propriété ne doit pas être vide.
Nouveauté 2024
IgnoreErreur
Constante de type EntierSpécifie les erreurs ignorées. Correspond à une constante ou une combinaison de constantes :
  • mqttIgnoreCertificatExpiré : La date du certificat est ignorée.
  • mqttIgnoreCertificatInvalide : Le certificat est ignoré.
  • mqttIgnoreNomCertificatInvalide : Le nom du site figurant dans le certificat est ignoré.
  • mqttIgnoreRévocation : La révocation du certificat est ignorée.
MotDePasseCléPrivéeChaîne de caractèresMot de passe du fichier de clés (dans le cas d'une connexion par clé privée). La propriété CléPrivée correspond à la clé privée à utiliser.
MotDePasseUtilisateurChaîne de caractèresMot de passe de l'utilisateur utilisé dans le cadre d'une authentification par mot de passe (la propriété Utilisateur correspond au nom de l'utilisateur).
OptionConstante de type EntierOptions de connexion. Cette propriété peut correspondre à la constante optionSSL pour une connexion de type SSL.
PortEntierPort du serveur MQTT. Par défaut, ce port correspond à 1883 (ou 8883 dans le cas d'une connexion SSL).
SessionVideBooléen
  • Vrai si il est nécessaire de vider les paramètres globaux génériques sur le serveur,
  • Faux dans le cas contraire.
TimeoutConnexionEntier ou DuréeDélai de connexion en secondes. Cette propriété peut correspondre à :
  • un entier correspondant au nombre de secondes,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 10 s).
UtilisateurChaîne de caractèresNom de l'utilisateur.

Mode d'authentification

L'authentification par clé est prioritaire sur l'authentification par mot de passe.
L'authentification par clé est tentée si :
  • le serveur supporte ce mode d'authentification.
  • la propriété CléPrivée est renseignée.
L'authentification par mot de passe est tentée si :
  • le serveur supporte ce mode d'authentification.
  • la propriété MotDePasseUtilisateur est renseignée.

Fonctions manipulant les variables de type mqttSession

Les fonctions manipulant les variables de type mqttSession sont les suivantes :
MQTTAbonnePermet de s'abonner à une notification MQTT.
MQTTConnectePermet de se connecter à un serveur MQTT (également appelé "Broker").
MQTTDéconnectePermet de se déconnecter d'un serveur MQTT (également appelé "Broker").
MQTTDésabonnePermet de se désabonner d'une notification MQTT.
MQTTDésabonneToutPermet de se désabonner de tous les abonnements préalablement souscrits.
MQTTPubliePublie un message sur le broker MQTT.
Voir Aussi
Version minimum requise
  • Version 22
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 26/02/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale