Chaque carte de données lit une source de données : une requête qui renvoie une valeur, une série, un tableau ou un enregistrement. Les paramètres permettent à un même tableau de bord de servir plusieurs appareils ou sites. Les filtres de clés restreignent un ensemble d’appareils selon leurs valeurs. Cette page répertorie les sources IoT, explique le fonctionnement de la fenêtre temporelle et des agrégats, et montre comment construire un tableau de bord qui suit l’appareil ou le site choisi par l’utilisateur.
Comment une carte obtient ses données
Un widget déclare des emplacements : ce dont il a besoin, jamais d’où cela provient. Une jauge a besoin d’une valeur ; un graphique linéaire a besoin d’une série ; un tableau a besoin de lignes. Dans l’onglet Données de la carte, vous remplissez chaque emplacement :
- Choisissez la source et la requête, par exemple Une valeur d’un appareil (en direct).
- Renseignez ses champs : l’appareil (ou Prendre depuis le tableau de bord, voir ci-dessous) et la valeur.
- Sélectionnez Enregistrer.
L’emplacement de série d’un graphique linéaire, à barres ou en aires accepte jusqu’à 8 sources (+ Ajouter une autre source), afin qu’un même graphique puisse afficher les valeurs de plusieurs appareils.
Inclure aussi les données d’exemple et les sources développeur affiche les sources destinées aux tests. Désactivez-la pour les tableaux de bord de production.
Sources de données IoT
| Requête | Fournit | En direct |
|---|---|---|
| Une valeur d’un appareil (en direct) | Une clé d’un appareil, choisie parmi les valeurs que l’appareil envoie | Oui |
| Relevés d’un appareil dans le temps (en direct) | Jusqu’à 20 clés d’un appareil sur la fenêtre temporelle, agrégées par intervalle. auto suit les premiers nombres envoyés par l’appareil. | Oui |
| Dernières valeurs de plusieurs appareils (une ligne par appareil) | Une ligne par appareil (tous, un profil, ou les appareils d’un paramètre) avec jusqu’à 20 clés ; 500 lignes au maximum | Interrogé |
| Dernières valeurs d’un appareil sous forme d’enregistrement | Jusqu’à 20 clés d’un appareil sous forme d’un seul enregistrement (pour Attributs ou un Formulaire) | Interrogé |
| Toutes les dernières valeurs d’un appareil | Une ligne par clé avec son nom et son unité (500 au maximum) | Interrogé |
| Les valeurs en direct d’un appareil, pour son schéma ou sa vue 3D | Une ligne par élément d’un appareil qui envoie des clés <element>.<field> | Interrogé |
| Un élément du schéma de procédé d’un appareil, Un élément d’un appareil dans le temps (en direct), Les relevés d’un élément, nommés pour une personne | La ligne d’un élément, sa tendance, ou ses relevés par nom | Mixte |
| Appareils (état de connexion en direct) | Vos appareils avec connexion, statut, profil et dernière activité ; filtres par profil, statut et connexion ; 500 lignes au maximum | Oui |
| Un attribut de l’appareil à une position d’un ensemble | Un attribut serveur ou partagé, par exemple l’adresse en direct d’une caméra | Interrogé |
| Alarmes (en direct) | Alarmes par statut (Active, Ouverte, Acquittée, Résolue, Tous les statuts) et par gravité ; 500 lignes au maximum | Oui |
| Nombre d’alarmes par gravité (en direct) | Un compte par gravité | Oui |
| Sites et actifs (l’arborescence en lignes), Actifs d’un alias, Appareils sous un actif | L’arborescence des actifs, les actifs d’un paramètre, les appareils sous un seul actif | Interrogé |
| Statut sous un actif | Une ligne par enfant : pire statut, appareils, alarmes ouvertes | Interrogé |
| Un site pour un en-tête de page | Nom, lieu, statut, appareils, alarmes ouvertes, dernière activité | Interrogé |
Les noms, unités, décimales et plages de valeurs proviennent des clés de télémétrie du profil de l’appareil. Chaque requête vérifie vos autorisations : un appareil que vous ne pouvez pas lire répond comme vide, de la même manière qu’un appareil inexistant.
Fenêtre temporelle et agrégats
Un graphique qui suit la fenêtre du tableau de bord (Utiliser la fenêtre temporelle du tableau de bord) affiche la période choisie par l’utilisateur dans la barre d’outils. Une carte peut aussi fixer sa propre fenêtre (Épingler : les dernières …) ou afficher la période précédente (même durée) pour comparer.
| Réglage | Valeurs |
|---|---|
| Fenêtres relatives | 5, 15 ou 30 dernières minutes ; 1, 6, 12 ou 24 dernières heures ; 3, 7, 14, 30, 90 ou 365 derniers jours ; toute autre valeur « les N dernières minutes, heures ou jours » |
| Périodes calendaires | Cette heure, Aujourd’hui, Cette semaine, Cette semaine (lun.), Ce mois, Ce trimestre, Ce semestre, Cette année, ainsi que la précédente de chacune ; Hier, Avant-hier, Ce jour la semaine dernière |
| Fenêtre la plus longue | 366 jours |
| Intervalle de regroupement | auto, 1, 5, 10, 15 ou 30 minutes, 1, 2, 6 ou 12 heures, 1 ou 7 jours |
| Nombre maximal d’intervalles dans une fenêtre | 500 (un intervalle plus fin est élargi) |
Avec auto, une fenêtre allant jusqu’à 1 heure est regroupée par minute, jusqu’à 1 jour par tranche de 5 minutes, jusqu’à 7 jours par heure, et les fenêtres plus longues par jour.
L’agrégat de Relevés d’un appareil dans le temps est l’un des suivants :
| Agrégat | Par intervalle |
|---|---|
avg, min, max | Moyenne, valeur la plus basse, valeur la plus haute |
last | La dernière valeur |
sum, count | Total, nombre de relevés |
increase | Pour les compteurs (énergie, compteurs d’eau) : la hausse depuis l’intervalle précédent. Une baisse est considérée comme une remise à zéro du compteur et compte à partir de zéro. Le premier intervalle compte ce qui a augmenté à l’intérieur de celui-ci. |
Les fenêtres de plus de 24 heures sont calculées à partir des agrégats stockés, et non des relevés bruts. Les relevés bruts sont conservés de 7 à 90 jours selon la classe de conservation de votre organisation (définie par votre offre) ; les agrégats par minute sont conservés jusqu’à 31 jours ; les agrégats horaires et journaliers sont conservés pour toute la classe (jusqu’à 1 095 jours). Voir Durée de conservation des données et Agrégats et cumuls.
Une fenêtre sans fuseau horaire utilise le fuseau horaire du navigateur de l’utilisateur. Les réglages du tableau de bord peuvent permettre aux utilisateurs de modifier l’Intervalle de regroupement, l’Agrégation (Moyenne, Minimum, Maximum, Somme, Nombre, Aucune (valeurs brutes)) et le Fuseau horaire. Enregistrer par défaut (rédacteurs uniquement) conserve la fenêtre pour tout le monde.
Paramètres
Un paramètre est une valeur ou une entité que lisent les cartes. Ouvrez Gérer les paramètres… pendant la personnalisation. Un tableau de bord peut contenir jusqu’à 16 paramètres de valeur et 48 paramètres au total ; la barre de filtres en affiche 16 au maximum.
| Type | Exemple |
|---|---|
| Valeur : texte, Valeur : nombre, Valeur : date, Valeur : oui ou non, Valeur : liste fixe, Valeur : liste issue d’une adresse | Un seuil, un poste, un produit |
| Entité (un appareil, un actif…) | L’appareil dont traite la page |
Pour un paramètre d’entité, vous choisissez :
| Réglage | Choix |
|---|---|
| Mode de sélection | L’utilisateur choisit ; La page ou un lien le définit ; Fixe : une entité ; Fixe : une liste ; Tous de ce type ; Par nom ; Par sous-type ou profil ; Lié à un autre paramètre ou à une autre entité |
| Un ou plusieurs | Une entité ou Plusieurs entités |
| Dans la barre de filtres | Affiché, l’utilisateur peut le modifier, Affiché, non modifiable, Masqué |
La clé d’un paramètre commence par une lettre minuscule et comporte au maximum 40 lettres, chiffres ou tirets bas. Renommer une clé casse les cartes et les liens qui utilisent l’ancienne. Vous ne pouvez pas supprimer un paramètre encore utilisé par des cartes, des pages, des filtres ou d’autres paramètres ; la fenêtre les nomme.
Lier une carte à un paramètre
Dans le champ de données de la carte, choisissez Prendre depuis le tableau de bord puis sélectionnez le paramètre, ou L’appareil affiché par cette page. Lorsqu’une carte prend un seul appareil et que le paramètre contient un site, la carte prend les appareils sous ce site ; s’il y en a plusieurs, elle indique « ?p.device=…), de sorte qu’un lien copié ouvre la même vue.
Plafonds : un ensemble résolu contient au maximum 500 entités (les 500 premières par nom) ; une liste fixe en contient au maximum 100 ; profondeur de relation de 1 à 10 niveaux.
Filtres de clés
Un filtre de clés restreint un paramètre d’entité par des valeurs, par exemple « appareils dont temperature est supérieure à 30 ». Ouvrez Gérer les filtres de clés….
- Une clé est un champ d’entité, un attribut (portée any, client, shared ou server) ou une télémétrie la plus récente.
- Types de valeurs : Texte, Nombre, Booléen, Date et heure.
- Opérations : égal, différent, supérieur, supérieur ou égal, inférieur, inférieur ou égal, compris entre, dans, non dans, est défini, n’est pas défini, est vrai, est faux, commence par, se termine par, contient, ne contient pas.
- Combinez les conditions avec Et : toutes doivent correspondre ou Ou : au moins une doit correspondre.
- Marquez un filtre comme modifiable pour permettre aux lecteurs de le changer.
Limites : 16 filtres par tableau de bord, 8 filtres de clés par filtre, 4 conditions par filtre de clés.
Données en direct
Les cartes marquées en direct se mettent à jour pendant que le tableau de bord est ouvert. Un tableau de bord utilise une seule connexion pour toutes ses cartes. Les cartes qui ne peuvent pas se mettre à jour en direct s’actualisent selon leur intervalle ; un tableau paginé s’actualise toujours selon son intervalle. Lorsque la connexion en direct est indisponible, le tableau de bord affiche « Mises à jour en direct indisponibles — interrogation ».
Mesures dans les fiches métier
Une clé d’appareil peut aussi alimenter un champ d’une fiche métier, par exemple le compteur d’un actif. Configurez-le sous Mappage des mesures dans le menu ⋯ de Appareils, ou dans l’onglet Flux d’un appareil.