PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 fichiers 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.
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,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 10 s).
    Nouveauté 23
    l'indication directe de la durée (par exemple 10 s).
    l'indication directe de la durée (par exemple 10 s).
UtilisateurChaîne de caractèresNom de l’utilisateur.


Remarque : Ces propriétés peuvent être utilisées en utilisant une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

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 :
Versions 22 et supérieures
MQTTAbonne
Nouveauté 22
MQTTAbonne
MQTTAbonne
Permet de s'abonner à une notification MQTT.
Versions 22 et supérieures
MQTTConnecte
Nouveauté 22
MQTTConnecte
MQTTConnecte
Permet de se connecter à un serveur MQTT (également appelé "Broker").
Versions 22 et supérieures
MQTTDéconnecte
Nouveauté 22
MQTTDéconnecte
MQTTDéconnecte
Permet de se déconnecter d'un serveur MQTT (également appelé "Broker").
Versions 22 et supérieures
MQTTDésabonne
Nouveauté 22
MQTTDésabonne
MQTTDésabonne
Permet de se désabonner d'une notification MQTT.
Versions 22 et supérieures
MQTTDésabonneTout
Nouveauté 22
MQTTDésabonneTout
MQTTDésabonneTout
Permet de se désabonner de tous les abonnements préalablement souscrits.
Versions 22 et supérieures
MQTTPublie
Nouveauté 22
MQTTPublie
MQTTPublie
Publie 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