Actions de carte et drill-down

Une carte peut réagir lorsqu’on clique dessus : restreindre le tableau de bord à l’appareil cliqué, ouvrir une page de détail à son sujet, ouvrir un autre tableau de bord, aller à une page de l’application ou exécuter une commande. Cette page énumère les éléments sur lesquels on peut cliquer, les actions, et explique comment construire un parcours de détail (drill-down) depuis une vue d’ensemble jusqu’à un appareil.

Où définir les actions

Personnalisez le tableau de bord, ouvrez les paramètres de la carte et ouvrez Ce qui se passe au clic (actions). Chaque source contient une liste d’actions exécutées dans l’ordre. Ajoutez-en autant que nécessaire, par exemple Définir les paramètres du tableau de bord puis Afficher une page de ce tableau de bord.

Ce qui peut être cliqué

Source	Cartes
Quand cette carte est cliquée, double-cliquée, cliquée droit	Toute carte
Boutons d’en-tête	Toute carte : boutons de l’en-tête de la carte, chacun avec un libellé et une icône
Quand ce contrôle est utilisé, Quand Appliquer est pressé	Contrôles
Quand une ligne est cliquée, Quand une ligne est double-cliquée, Quand une cellule est cliquée, Boutons de ligne	Tableaux, tableaux d’appareils et d’alarmes
Quand un marqueur de carte est cliqué, Quand un marqueur est déposé	Cartes géographiques
Quand une part du camembert est cliquée, Quand une plage est sélectionnée sur le graphique	Graphiques en camembert et en séries
Quand un lien du texte est cliqué	Cartes de texte, pour les liens `[mots](action:id)`
Quand un symbole est cliqué, double-cliqué, cliqué droit	Schémas de procédé (voir Commandes sur les symboles)
Quand un marqueur ou un élément du modèle est cliqué, Clic sur un élément	Cartes 3D

Les actions

Action	Effet
Aller à une page	Ouvre une page de l’application, éventuellement dans un nouvel onglet. Exemple : `/admin/iot/devices/{{row_id}}`.
Ouvrir une URL	Ouvre une adresse externe dans un nouvel onglet.
Définir les paramètres du tableau de bord	Modifie les paramètres du tableau de bord sur place, par exemple l’appareil que suivent les autres cartes.
Afficher une page de ce tableau de bord	Ouvre une page du même tableau de bord sous forme de page, de panneau latéral, de boîte de dialogue ou de fenêtre contextuelle.
Ouvrir un tableau de bord	Ouvre un autre tableau de bord avec ses paramètres préremplis (drill-down).
Retour	Revient en arrière dans le parcours de détail, de quelques niveaux ou jusqu’au premier tableau de bord.
Définir la fenêtre temporelle	Modifie la fenêtre du tableau de bord : un préréglage, la valeur par défaut du tableau de bord, ou une plage sélectionnée sur un graphique.
Actualiser ce widget, Actualiser le tableau de bord	Recharge les données.
Copier dans le presse-papiers	Copie une valeur.
Afficher un message	Affiche un bref message à l’utilisateur.
Exécuter une commande	Envoie une commande à l’appareil, après sa confirmation. Uniquement depuis les contrôles, les boutons de ligne et les symboles. Voir Cartes de contrôle.

Un clic sur une carte n’exécute jamais de commande ; l’éditeur la refuse à cet endroit.

Valeurs issues du clic

Le texte d’une action peut contenir des jetons :

Jeton	Est remplacé par
`{{param_<key>}}`	La valeur d’un paramètre du tableau de bord, par exemple `{{param_device}}`
`{{row_<column>}}`	Une colonne de la ligne cliquée (sources ligne, cellule et marqueur), par exemple `{{row_id}}`

Dans Définir les paramètres du tableau de bord et Ouvrir un tableau de bord, un paramètre peut prendre une valeur fixe, un autre paramètre, ou la colonne de la Ligne cliquée.

Conditions et confirmation

Toute action, sauf celle du clic sur la carte, peut avoir une condition d’affichage : elle ne s’exécute (ou un bouton ne s’affiche) que tant qu’un paramètre correspond. Sur le clic propre d’un contrôle, la condition désactive plutôt le contrôle.
Demander avant d’exécuter demande « Exécuter « » ? » avant Définir les paramètres du tableau de bord, Afficher une page de ce tableau de bord, Ouvrir un tableau de bord et Retour. Les commandes demandent par défaut.

Pages de détail

Un tableau de bord peut avoir jusqu’à 20 pages après sa page principale. Une page absente du menu des pages est une page de détail, ouverte uniquement depuis une carte.

Personnalisez le tableau de bord et ouvrez Gérer les pages….
Ajouter une page. Donnez-lui un titre, par exemple Appareil {{param_device}} : « Appareil {{example}} » affiche « Appareil P-201 » une fois un appareil choisi.
Sous Paramètres, ajoutez les paramètres utilisés par la page. Un paramètre marqué d’une étoile est requis : « la page ne s’ouvre que depuis une action de carte qui fournit ce paramètre. »
Décochez Dans le menu pour en faire une page de détail.
Choisissez Affiché comme : Page, Panneau latéral, Boîte de dialogue ou Fenêtre contextuelle, puis une taille (Petite, Moyenne, Grande).
Sélectionnez Enregistrer les pages. Ensuite, déplacez les cartes sur la page pendant qu’elle est ouverte.

Une page ouverte par une action s’affiche par-dessus la page où se trouve la carte. Jusqu’à 8 peuvent se superposer ; chacune conserve les valeurs avec lesquelles elle a été ouverte, et Retour à la page précédente ferme la plus haute. Un panneau latéral ou une boîte de dialogue propose Ouvrir en page entière. Une page ouverte sans valeur requise affiche « Choisir pour voir cette page ».

Parcours de détail vers un autre tableau de bord

Ouvrir un tableau de bord ouvre un autre tableau de bord dont les paramètres sont définis à partir du clic. Les tableaux de bord parcourus apparaissent en fil d’Ariane en haut, conservés dans l’adresse (?trail=…), de sorte que Retour et le bouton Précédent du navigateur remontent ce parcours.

Exemple : de tous les sites à une seule pompe.

Tableau Sites : un Tableau lié à Statut sous un actif pour le site principal. Sur Quand une ligne est cliquée : Ouvrir un tableau de bord > Détail du site, avec site défini à partir de la ligne cliquée.
Tableau Détail du site : un paramètre d’entité site (La page ou un lien le définit), un tableau d’appareils rattachés à ce site. Sur Quand une ligne est cliquée : Afficher une page de ce tableau de bord > la page de détail Appareil, avec device défini à partir de la ligne cliquée, affichée comme Panneau latéral.
La page Appareil : une Jauge, un Graphique linéaire et un Bouton dont le champ d’appareil prend L’appareil affiché par cette page (le paramètre device).

Le modèle de tableau de bord Sites construit l’essentiel de cela pour vous. Voir Modèles de tableaux de bord et fichiers de tableau de bord.

Dépannage

Problème	Cause
Une page ne peut pas être supprimée	« Contient des cartes ou est ouverte par une action : déplacez d’abord les cartes et modifiez les actions. »
Une action est refusée à l’enregistrement	Afficher une page de ce tableau de bord laisserait un paramètre requis sans valeur. Donnez-lui ce paramètre.
« Non enregistré : N action(s) non terminée(s). »	Chaque action non terminée indique ce qui lui manque.
Le fil d’Ariane a disparu	Le parcours fait partie de l’adresse ; un favori sans lui démarre un nouveau parcours.