Commandes

Définissez des commandes personnalisées pour l'appareil et le logiciel d'un appareil GPS dans Navixy et envoyez-les à la demande depuis le widget Traceur.

Le Commandes bloc vous permet de définir des commandes personnalisées pour un traceur dans Navixy et de les envoyer à la demande depuis le widget Traceur ou l’ X-GPS Mobile application. Utilisez-le pour envoyer directement à un traceur une instruction de niveau micrologiciel, par exemple pour envoyer une commande CAN ou activer une sortie, ou pour appeler tout système externe acceptant des requêtes HTTP, comme un canal Slack, un service de notification, un CRM ou un point de terminaison d’API personnalisé. Une fois configurées, les commandes peuvent être envoyées d’un simple clic.

Le bloc Commandes prend en charge deux types de commandes :

• Commande du traceur envoie directement au traceur une chaîne d’instructions au niveau protocolaire, par exemple pour envoyer une commande CAN ou activer une sortie.

• Commande logicielle envoie une requête HTTP POST avec un corps JSON vers n’importe quelle URL, en incluant facultativement dans la charge utile les données actuelles du traceur, comme la position, la vitesse ou l’ID du traceur.

Les commandes sont enregistrées par traceur et restent disponibles pour une utilisation répétée.

Quand utiliser Commandes plutôt qu’IoT Logic

Commandes est conçu pour des actions manuelles ponctuelles visant un seul traceur. Utilisez-le lorsque vous devez envoyer une commande unique sans configurer de flux d’automatisation.

Pour l’envoi automatisé de commandes basé sur des règles, par exemple le déclenchement d’une action du traceur ou d’un Webhook lorsqu’un seuil de capteur est franchi, ou l’envoi de la même commande à plusieurs traceurs, utilisez IoT Logic. Les Action du traceur et Webhook nœuds dans IoT Logic offrent les mêmes capacités sous-jacentes avec une automatisation complète du flux et un ciblage multi-traceurs.

Configuration

Pour configurer Commandes pour un traceur, suivez ces étapes :

1. Accédez à Paramétrage des traceurs dans la barre latérale gauche.

2. Sélectionnez le traceur que vous souhaitez configurer.

3. Repérez et développez le Commandes bloc.

Vous pouvez ajouter plusieurs commandes de chaque type. Chaque commande est enregistrée individuellement.

Commandes du traceur

Une commande du traceur envoie directement au traceur une chaîne d’instructions au niveau protocolaire via son canal de communication.

Pour ajouter une commande du traceur, cliquez sur Ajouter une commande du traceur au bas du bloc. Configurez les champs suivants :

1. Nom de la commande : un libellé pour la commande tel qu’il apparaît dans le widget Traceur, par exemple redémarrage du traceur. Choisissez un nom qui décrit clairement l’action de la commande.

2. Chaîne de commande : la chaîne d’instructions exacte envoyée au traceur, par exemple cpureset.

Les chaînes de commande valides dépendent du traceur et sont définies par le fabricant du traceur. Consultez toujours la documentation officielle de votre modèle de traceur pour trouver les chaînes de commande correctes. La saisie de valeurs incorrectes peut avoir des effets inattendus sur le traceur.

Cliquez sur Enregistrer pour enregistrer la commande. Cliquez sur Supprimer pour la supprimer.

Commandes logicielles

Une commande logicielle envoie une requête HTTP POST avec un corps JSON vers l’URL que vous spécifiez. Il peut s’agir d’un point de terminaison de service externe, comme Slack, d’un récepteur de Webhook personnalisé ou de toute API REST, ou encore d’un point de terminaison d’API Navixy.

Le corps de la requête est au format JSON et doit être structuré selon ce qu’attend le point de terminaison de destination. Vous pouvez inclure des attributs de données du traceur dans le corps à l’aide de la {{attribute_name}} syntaxe.

Les commandes logicielles se configurent dans deux onglets : Général et Corps.

Pour ajouter une commande logicielle, cliquez sur Ajouter une commande logicielle au bas du bloc.

Onglet Général

Configurez les éléments suivants :

1. Titre : un libellé pour la commande tel qu’il apparaît dans le widget Traceur.

2. URL : l’URL complète du point de terminaison vers lequel la requête POST est envoyée, par exemple https://hooks.slack.com/services/... ou https://api.eu.navixy.com/v2/....

3. En-têtes : paires clé-valeur envoyées en tant qu’en-têtes de requête HTTP. Ajoutez des en-têtes selon les besoins du point de terminaison de destination. Cliquez sur Ajouter un en-tête pour insérer une nouvelle ligne.

   • Utilisez l’ Authorization en-tête pour l’authentification par jeton, par exemple Authorization défini sur Bearer your_token.

   • D’autres méthodes d’authentification prises en charge par la destination, telles que des Clés API transmises en tant que paramètres de requête dans l’URL, peuvent également être utilisées.

Onglet Corps

Le Corps est l’endroit où vous composez la charge utile JSON. Rédigez un JSON valide correspondant au format attendu par le point de terminaison de destination.

Pour inclure des données en temps réel du traceur dans la charge utile, utilisez la {{attribute_name}} syntaxe. Cliquez sur le bouton de sélection des attributs en haut à droite du champ pour ouvrir une liste consultable des attributs disponibles pour le traceur. La sélection d’un attribut insère le {{attribute_name}} espace réservé correspondant dans le corps à la position du curseur.

Les attributs disponibles dépendent du traceur concerné et des données qu’il transmet à la plateforme Navixy. Seuls les attributs réellement envoyés par le traceur apparaissent dans la liste. Utilisez le sélecteur pour éviter les fautes de frappe ou les noms d’attributs incorrects.

Cliquez sur Enregistrer pour enregistrer la commande. Cliquez sur Supprimer pour la supprimer.

Exemple : envoi d’une notification Slack

Slack prend en charge la réception de messages provenant de services externes via des Webhooks entrants. Une fois que vous avez configuré un Webhook dans votre espace de travail Slack et obtenu l’URL du Webhook (voir le guide des Webhooks entrants de Slack), créez une commande logicielle avec la configuration suivante.

Onglet Général :

• Titre: Notifier Slack

• URL : votre URL de Webhook entrant Slack, par exemple https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX

• En-têtes : aucun en-tête requis

Onglet Corps :

{
  "text": "Traceur {{device_id}} : vitesse {{speed}} km/h à {{latitude}}, {{longitude}}"
}

Slack attend un objet JSON avec un text champ. Les {{device_id}}, {{speed}}, {{latitude}} et {{longitude}} espaces réservés sont remplacés par les valeurs actuelles du traceur au moment où la commande est envoyée. Lorsqu’elle est déclenchée depuis le widget Traceur, le message apparaît dans le canal Slack configuré pour votre Webhook.

Valeurs dynamiques de commande

Une chaîne de commande ou le corps d’une commande logicielle peut inclure un seul <> espace réservé pour demander une valeur à chaque envoi de la commande, au lieu de coder en dur une valeur fixe.

• Dans une commande du traceur, ajoutez <> à l’intérieur du Chaîne de commande champ, par exemple relay,<> pour envoyer un état de relais différent à chaque envoi.

• Dans une commande logicielle, ajoutez <> à l’intérieur du Corps champ, par exemple {"value": "<>"}.

Un seul <> espace réservé est autorisé par commande. L’enregistrement d’une commande comportant plus d’un espace réservé renvoie l’erreur « Une seule valeur est autorisée par commande. Supprimez le < > supplémentaire. »

Lorsque vous envoyez une commande qui contient <> depuis le widget Traceur, une boîte de dialogue vous demande la valeur avant l’envoi. Consultez Envoi de commandes depuis le widget Traceur pour le flux complet.

Cliquez sur l’icône d’aide dans le bloc Commandes pour ouvrir Comment fonctionnent les valeurs de commande, un résumé de <> syntaxe.

Envoi de commandes depuis le widget Traceur

Une fois les commandes enregistrées, elles apparaissent dans le Commandes bloc du traceur widget Traceur dans le module Suivi.

Cliquez sur le bouton Envoyer à côté d’un nom de commande pour l’envoyer. Le bloc Commandes affiche toutes les commandes du traceur et les commandes logicielles configurées pour ce traceur.

• Si la commande ne contient pas d’ espace réservé de valeur dynamique, Navixy l’envoie immédiatement. Il n’y a aucune boîte de dialogue de confirmation.

• Si la commande contient <>, une boîte de dialogue s’ouvre pour vous demander de saisir une valeur. Saisissez une valeur pouvant aller jusqu’à 500 caractères, puis cliquez sur Envoyer pour envoyer la commande avec la valeur remplacée par <>. Les Envoyer le bouton reste désactivé jusqu’à ce que vous saisissiez une valeur, et les valeurs vides ou composées uniquement d’espaces ne sont pas acceptées.

Après l’exécution de la commande, Navixy affiche une notification avec le résultat :

• Commandes du traceur indiquent seulement si la commande a réussi, sous la forme { "success": true } ou { "success": false }.

• Commandes logicielles affichent le nom de la commande et la réponse brute du point de terminaison de destination, sous la forme {status, body}. Les réponses longues défilent dans la notification.

Les commandes envoyées apparaissent également dans le Événements récents bloc du widget Traceur, avec leur résultat disponible dans une vue dépliable. Si la commande incluait un espace réservé de valeur dynamique, le titre de l’entrée affiche également la valeur envoyée, par exemple Mettre à jour le statut <en ligne>.

Les commandes sont propres à chaque traceur. Les commandes configurées pour un traceur n’apparaissent pas dans les widgets Traceur des autres traceurs. Pour envoyer des commandes à plusieurs traceurs selon des règles ou des conditions, utilisez IoT Logic.