Configurer l'export MQTT dans votre Workspace

✓ EnergieID pour les entreprises

Avec la fonctionnalite Export MQTT de Workspace, vous pouvez transmettre des donnees de compteur et des donnees d'appareil vers un broker MQTT externe. Vous pouvez ainsi combiner les donnees EnergieID avec vos propres automatisations ou integrations au sein de votre organisation. Vous decouvrez MQTT ? Commencez par la courte introduction sur mqtt.org.

Vous construisez une integration technique ? Vous cherchez la structure exacte du payload et les definitions de l'API ? Consultez directement Modele de donnees et format de payload MQTT.

Ou trouver l'export MQTT ?

  • Dans votre Workspace, allez dans Configuration.
  • Ouvrez la fonctionnalite Export MQTT.
  • Ajoutez au moins un broker et renseignez les parametres.
  • Cliquez sur Enregistrer.

Seuls les administrateurs du Workspace peuvent enregistrer cette configuration.

Explication de tous les parametres

Broker

Vous pouvez ajouter un ou plusieurs brokers. Chaque broker possede ses propres identifiants, modeles de topic et modes de transfert.

  • URL du broker : l'endpoint de votre broker, par exemple mqtt://broker.example.com:1883 ou mqtts://broker.example.com:8883.
  • Nom d'utilisateur : le nom d'utilisateur qu'EnergieID utilise pour se connecter au broker.
  • Mot de passe : le mot de passe de ce nom d'utilisateur.
    • Pour un broker existant, vous pouvez laisser ce champ vide afin de conserver le mot de passe enregistre.
    • Pour un nouveau broker, ce champ est obligatoire.

Modes de transfert

  • Transmettre les donnees de compteur traitees : transfère les données de compteur pour chaque dossier du workspace. Les données sont envoyées dès qu’elles ont été traitées dans EnergieID. Pour les intégrations qui se synchronisent pendant la nuit, le transfert a donc également lieu pendant la nuit. Les intégrations qui envoient des mises à jour en continu sont transférées presque immédiatement.
  • Transmettre les donnees d'appareil en temps reel : transfère les données en temps réel au niveau des appareils. Attention : cela s’applique uniquement aux intégrations qui fournissent elles-mêmes des données en temps réel à EnergieID.

Remarque : Vous devez activer au moins un mode de transfert. Si les deux sont desactives, la configuration ne peut pas etre enregistree comme valide.

Modeles de topic

Pour chaque mode, vous choisissez vers quel topic MQTT les messages sont envoyes.

  • Modele de topic pour les donnees de compteur (par defaut) : energyid/workspace/{{workspaceId}}/record/{{recordNumber}}/meter/{{meterId}}
  • Modele de topic pour les donnees d'appareil (par defaut) : energyid/workspace/{{workspaceId}}/record/{{recordNumber}}/device/{{twinId}}

Les placeholders sont remplaces automatiquement lors de la publication. Tous les placeholders disponibles sont repris dans le modele d'exemple. Vous n'etes pas oblige d'utiliser des placeholders.

Confirmation RGPD / base juridique

Pour chaque broker, vous devez confirmer qu'une base juridique valable existe pour le partage des donnees energetiques avec cet abonne MQTT. Sans cette confirmation, vous ne pouvez pas enregistrer la configuration.

En pratique, cela signifie au minimum que votre traitement est conforme au RGPD (Reglement (UE) 2016/679), notamment avec :

  • une base juridique valable pour le traitement (RGPD, article 6),
  • un accord de sous-traitance lorsque l'exploitant du broker agit comme sous-traitant (RGPD, article 28),
  • une information transparente des personnes concernees concernant la transmission a des tiers (RGPD, articles 13 et 14).

Selon votre configuration, des regles supplementaires peuvent s'appliquer, par exemple des obligations sectorielles ou des regles nationales d'execution au sein de l'UE/EEE.

Quels messages d'erreur pouvez-vous voir ?

Validation lors de l'enregistrement

Si la configuration est incomplete, vous pouvez voir des problemes de validation lors de l'enregistrement, par exemple :

  • Aucun broker ajoute.
  • Un champ obligatoire manque (URL du broker, nom d'utilisateur, ou mot de passe pour un nouveau broker).
  • Aucun mode de transfert active.
  • La confirmation de la base juridique (RGPD) manque.

Echec de livraison pendant la publication

Si la publication vers un broker echoue, un badge Echec de livraison apparait sur ce broker. Vous pouvez cliquer dessus pour obtenir plus d'informations. Dans la vue detaillee, vous pouvez voir :

  • l'heure de l'erreur la plus recente,
  • le message d'erreur technique provenant de la connexion ou de la publication vers le broker.

Lors de la premiere erreur sur un broker, les administrateurs du Workspace recoivent egalement un message dans le centre de messages.

Remarque : Lorsque vous enregistrez a nouveau les parametres MQTT, la derniere erreur de livraison connue est effacee. Pensez donc a verifier les details de l'erreur avant de reenregistrer. Si une nouvelle erreur se produit apres une mise a jour des parametres, vous recevrez une nouvelle notification.

Formats de donnees complets par mode

Cette page decrit les parametres et les messages d'erreur. La structure exacte du payload pour chaque mode de transfert (donnees de compteur et donnees d'appareil), y compris les messages d'exemple et la description des champs, est documentee sur une page technique separee :

Modele de donnees et format de payload MQTT

Questions frequentes

Puis-je configurer plusieurs brokers en meme temps ?

Oui. Chaque broker est enregistre et utilise independamment. Vous pouvez definir des modeles de topic et des modes de transfert differents pour chaque broker.

Dois-je reencoder mon mot de passe a chaque modification ?

Non. Pour les brokers existants, vous pouvez laisser le champ du mot de passe vide afin de conserver le mot de passe actuel.

Pourquoi ai-je une configuration active mais toujours aucun message ?

Verifiez l'echec de livraison pour chaque broker, l'URL du broker, les droits d'acces de l'utilisateur MQTT, ainsi que le fait qu'au moins un mode de transfert soit actif.