Les cartes de commande permettent à un opérateur d’agir depuis un tableau de bord : démarrer une pompe, allumer une lumière, modifier une consigne, enregistrer un groupe de seuils. Une commande envoie une commande issue du catalogue de commandes du profil de l’appareil. Cette page explique comment en configurer une, quelles commandes un tableau de bord peut envoyer et ce que voit l’opérateur.
Ce qu’un tableau de bord peut envoyer
Un tableau de bord envoie des commandes via Envoyer une commande à un appareil. Les règles sont volontairement strictes :
| Règle | Détail |
|---|---|
| Commandes du catalogue uniquement | La commande doit figurer dans le catalogue Commandes du profil de l’appareil. Une méthode brute est refusée : « Cette commande ne figure pas dans le catalogue du profil de l’appareil, elle ne peut donc pas être envoyée depuis un tableau de bord. » |
| Niveau de base uniquement | Une commande Privilégiée ou Critique, ainsi que toute commande à fort impact, est refusée : « Cette commande ne peut pas être envoyée depuis un tableau de bord : envoyez-la depuis la console de l’appareil. » |
| Autorisations | L’opérateur a besoin de Exécuter les commandes de widget et de l’autorisation d’envoyer des commandes de base, et doit être autorisé à lire la télémétrie de l’appareil. Sinon : « Vous n’êtes pas autorisé à utiliser ce contrôle. » |
| Limite de débit | 30 commandes par minute au maximum et par personne. Au-delà : « Trop de commandes ; réessayez dans une minute. » |
| Écrans d’affichage | Les contrôles sont inactifs sur une liaison d’affichage. |
Pour ajouter une commande à un profil et choisir son niveau, voir Envoyer des commandes aux appareils.
Configurer un contrôle
- Personnalisez le tableau de bord et ajoutez un Bouton, un Interrupteur, un Curseur, une Consigne ou un Formulaire.
- Dans le tiroir des paramètres, ouvrez les actions (Quand ce contrôle est utilisé, ou Quand Appliquer est pressé pour une consigne et un formulaire) et ajoutez Exécuter une commande.
- Pick the Device (or take it from a board parameter), the Command from that device’s catalogue, and the Control and Value the command takes.
- Choisissez l’origine de chaque paramètre de commande : Une valeur fixe, Un paramètre du tableau de bord, La valeur du contrôle, La valeur du contrôle, mise à l’échelle, Une table de correspondance, Un champ du formulaire ou La colonne de la ligne cliquée.
- Pour un interrupteur, un curseur ou une consigne, reliez l’emplacement Valeur actuelle (ou État actuel) à la valeur de l’appareil que la commande modifie, afin que la carte affiche ce que l’appareil a actuellement.
- Sélectionnez Enregistrer.
Tant qu’aucune commande n’est choisie, la carte affiche « Choisissez une commande dans les paramètres de ce widget (Quand cette carte est cliquée → Exécuter une commande). »
Les contrôles
| Contrôle | Fonction | Paramètres principaux |
|---|---|---|
| Bouton | Exécute ses actions à l’appui : une commande, ou toute autre action comme l’ouverture d’une page. | Disposition Bouton, Tuile avec icône, Icône ronde, Pastille flottante ; Texte du bouton ; Icône ; Description (une ligne décrivant son action) ; style Plein, Contour, Simple, Souligné ; taille S, M, L |
| Interrupteur | Lit une valeur marche/arrêt et envoie une commande à chaque bascule. | Disposition ; Afficher l’état sous forme de Texte en grand, Pastille d’état ou Rien ; Texte Marche, Texte Arrêt, Texte Inconnu ; une icône par état |
| Curseur | Lit un nombre et envoie la nouvelle valeur une seule fois, au relâchement. | Minimum 0, Maximum 100, Pas 1 ; horizontal ou vertical ; graduations ; position de la valeur |
| Consigne | Un champ numérique avec Appliquer, un compteur pas à pas ou un cadran. Les saisies hors plage génèrent une erreur de champ et n’envoient rien. | Saisir et appliquer, Boutons moins et plus, Cadran avec moins et plus ; plage et pas ; Afficher la valeur actuelle ; Texte du bouton Appliquer |
| Formulaire | Plusieurs champs enregistrés ensemble avec une seule commande. | Champs (jusqu’à 40) : Clé, Libellé, Type (Nombre, Marche / arrêt, Texte, Un élément d’une liste), plage, unité, Seulement si активé, Obligatoire, Afficher seulement, Section ; Prendre les champs depuis la source ; Texte du bouton Enregistrer ; Afficher un bouton de réinitialisation |
La commande d’un formulaire lit les valeurs enregistrées par clé : {"$field": "lowThreshold"} dans les paramètres de la commande. Prendre les champs depuis la source modifie chaque champ décrit par l’enregistrement lié lorsque vous ne listez aucun champ.
Boutons à bascule
Un Bouton peut apparaître enfoncé tant qu’une condition est vraie (Enfoncé quand le paramètre, Enfoncé quand la colonne…), par exemple un bouton « Mode manuel » qui reste enfoncé tant que le paramètre de mode du tableau est manual. Pas une bascule est la valeur par défaut. Un bouton peut aussi être Activé uniquement quand un paramètre correspond.
Désactivation sur données anciennes
Désactiver le contrôle quand (interrupteur, curseur, consigne, formulaire) La lecture est ancienne par défaut, et peut aussi être L’état est inconnu. La raison s’affiche dans une info-bulle. Le serveur vérifie tout de même l’ensemble au moment de l’exécution de la commande.
Confirmation
Une commande d’appareil envoyée depuis un tableau de bord demande d’abord confirmation, par défaut. Chaque entrée Exécuter une commande a Demander avant d’exécuter, activé par défaut. L’opérateur voit alors une boîte de dialogue « Exécuter
Une commande peut aussi exiger une confirmation saisie : la boîte de dialogue ajoute alors « Saisissez «
Formulation : Question de confirmation et Bouton de confirmation dans les paramètres du contrôle modifient les mots de la boîte de dialogue, et non le texte à saisir.
Retour d’information et relecture
| La carte affiche | Signification |
|---|---|
| « Envoi… » | La commande est en route. |
| « Terminé. » ou « Terminé : | L’appareil a répondu ; sa réponse est affichée en texte. |
| « Envoyée ; en attente de l’appareil. » | La commande est en file d’attente, par exemple pour un appareil hors ligne avec une commande persistante. |
| « Pas de réponse après 30 secondes. La commande peut quand même s’exécuter ; vérifiez sa cible avant de réessayer. » | Aucune réponse dans les 30 secondes. |
| « La commande a échoué. » / « La commande a été refusée. » | L’appareil ou le serveur a refusé ; la raison suit lorsqu’elle existe. |
| « Actuel : | Ce que l’appareil signale maintenant, d’après la valeur actuelle liée. |
Relisez la valeur actuelle depuis l’appareil plutôt que de faire confiance au contrôle : un interrupteur qui affiche Marche après une bascule affiche l’état signalé par l’appareil dès son arrivée. Chaque exécution est inscrite dans le journal d’audit ; la commande apparaît aussi dans l’Historique des commandes de l’appareil, envoyée par Un contrôle de tableau de bord.
Commandes depuis les tableaux et les schémas
- Les Boutons de ligne d’un tableau peuvent exécuter une commande utilisant une colonne de la ligne cliquée. Voir Tableaux et listes.
- Les symboles d’un schéma de process peuvent exécuter des commandes. Voir Commandes sur les symboles.
- Un clic sur une carte n’exécute jamais une commande. Les commandes ne s’exécutent que depuis les contrôles, les boutons de ligne et les symboles, derrière leur confirmation.
Dépannage
| Ce que vous voyez | Solution |
|---|---|
| La commande n’est pas dans la liste | Elle ne figure pas dans le catalogue du profil de l’appareil, ou elle n’est pas de niveau Base. |
| « Ce contrôle n’est pas encore relié à l’appareil. » | L’emplacement de la valeur actuelle est vide. Reliez-le. |
| Le contrôle est grisé | La mesure est ancienne ou l’état est inconnu (Désactivez la commande lorsque), ou vous n’avez pas la permission. |
| L’appareil ne réagit jamais | Voir Les commandes n’atteignent pas l’appareil. |