MQTT

Catalogue des nœuds Actions

Sur cette page

Publier un message avec MQTT

Utilisation et spécificités

Sélectionnez l’identifiant du broker et la destination : topic Kafka ou MQTT, file RabbitMQ ou sujet NATS. Configurez groupId pour Kafka, exchange et routingKey pour RabbitMQ, qos et retain pour MQTT. Publiez les déclencheurs pour ouvrir la souscription ; un test simulé ne vérifie pas le broker. Prévoyez un traitement idempotent des messages.

Type technique : mqtt. Runtime : nodulz.

Identifiants et prérequis

MQTT (integration / mqtt). Connexion chiffrée au broker MQTT

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`credentialId`	`string`	`""`	-
`destination`	`string`	`""`	-
`message`	`string`	`"{\"hello\":\"world\"}"`	-
`key`	`string`	`""`	-
`groupId`	`string`	`""`	-
`fromBeginning`	`boolean`	`false`	-
`exchange`	`string`	`""`	-
`routingKey`	`string`	`""`	-
`qos`	`number`	`1`	-; ≥ 0, ≤ 2
`retain`	`boolean`	`false`	-
`testPayload`	`string`	`""`	-

Aide de configuration

credentialId Identifiant: Sélectionnez la connexion du même fournisseur. Elle est chiffrée et vérifiée avec les droits du propriétaire du workflow.
fromBeginning Lire depuis le début: Kafka uniquement : point de départ si ce groupe n’a aucun offset enregistré. Les offsets existants restent prioritaires.
qos Qualité de service (QoS): MQTT : 0 au plus une fois, 1 au moins une fois, 2 exactement une fois au niveau du protocole. Ne garantit pas l’exécution unique du workflow.
retain Conserver le dernier message: Le broker MQTT conserve le message pour les nouveaux abonnés. Un message vide efface cette valeur.
testPayload Événement de test (JSON): Facultatif. Remplace les champs de l’événement simulé pendant un test manuel, sans connexion au broker.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "credentialId": "",
  "destination": "",
  "message": "{\"hello\":\"world\"}",
  "key": "",
  "groupId": "",
  "fromBeginning": false,
  "exchange": "",
  "routingKey": "",
  "qos": 1,
  "retain": false,
  "testPayload": ""
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.