Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Sources de données et paramètres

Liez les cartes aux données des appareils, aux alarmes et aux sites, choisissez les agrégats et les fenêtres temporelles, et utilisez les paramètres et les filtres de clé pour qu'un seul tableau de bord serve de nombreux appareils.

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 seul tableau de bord de fonctionner pour de nombreux appareils ou sites. Les filtres de clés restreignent un ensemble d’appareils selon leurs valeurs. Cette page énumère 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 nécessite une valeur ; un graphique en courbes nécessite une série ; un tableau nécessite des lignes. Dans l’onglet Données de la carte, vous remplissez chaque emplacement :

  1. Choisissez la source et la requête, par exemple Une valeur d’un appareil (en direct).
  2. Renseignez ses champs : l’appareil (ou Prendre depuis le tableau de bord, voir ci-dessous) et la valeur.
  3. Sélectionnez Enregistrer.

L’emplacement de série d’un graphique en courbes, en 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-le pour les tableaux de bord de production.

Sources de données IoT

RequêteFournitEn direct
Une valeur d’un appareil (en direct)Une clé d’un appareil, choisie parmi les valeurs que l’appareil envoieOui
Mesures 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 nombreux 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 maximumInterrogé
Dernières valeurs d’un appareil sous forme d’enregistrementJusqu’à 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 appareilUne 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 3DUne 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 mesures d’un élément, nommées pour une personneLa ligne d’un élément, sa tendance, ou ses mesures par nomMixte
Appareils (état de connexion en direct)Vos appareils avec connexion, état, profil et dernière activité ; filtres par profil, état et connexion ; 500 lignes au maximumOui
Un attribut de l’appareil à une position d’un ensembleUn attribut serveur ou partagé, par exemple l’adresse en direct d’une caméraInterrogé
Alarmes (en direct)Alarmes par état (Active, Ouverte, Acquittée, Résolue, Tous les états) et par gravité ; 500 lignes au maximumOui
Nombre d’alarmes par gravité (en direct)Un compte par gravitéOui
Sites et actifs (l’arborescence sous forme de lignes), Actifs d’un alias, Appareils sous un actifL’arborescence des actifs, les actifs d’un paramètre, les appareils sous un actifInterrogé
État sous un actifUne ligne par enfant : pire état, appareils, alarmes ouvertesInterrogé
Un site pour l’en-tête de pageNom, lieu, état, appareils, alarmes ouvertes, dernière activitéInterrogé

Les noms, unités, décimales et plages de valeurs proviennent des clés de télémesure du profil de l’appareil. Chaque requête vérifie vos autorisations : un appareil que vous ne pouvez pas lire renvoie un résultat vide, comme un appareil inexistant.

Fenêtre temporelle et agrégats

Une carte 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 (Fixer : les dernières …) ou afficher la période précédente (même durée) pour comparer.

RéglageValeurs
Fenêtres relativesLes 5, 15 ou 30 dernières minutes ; les 1, 6, 12 ou 24 dernières heures ; les 3, 7, 14, 30, 90 ou 365 derniers jours ; toute autre durée « les N dernières minutes, heures ou jours »
Périodes calendairesCette 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 longue366 jours
Intervalle de regroupementauto, 1, 5, 10, 15 ou 30 minutes, 1, 2, 6 ou 12 heures, 1 ou 7 jours
Nombre maximal d’intervalles dans une fenêtre500 (un intervalle plus fin est élargi)

Avec auto, une fenêtre allant jusqu’à 1 heure est regroupée par minute, jusqu’à 1 jour par tranches de 5 minutes, jusqu’à 7 jours par heure, et les fenêtres plus longues par jour.

L’agrégat de Mesures d’un appareil dans le temps est l’un des suivants :

AgrégatPar intervalle
avg, min, maxMoyenne, valeur la plus basse, valeur la plus haute
lastLa dernière valeur
sum, countTotal, nombre de mesures
increasePour 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 servies à 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 rétention de votre organisation (définie par votre forfait) ; agrégats par minute jusqu’à 31 jours ; agrégats horaires et journaliers pendant 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 les cartes lisent. Ouvrez Gérer les paramètres… pendant la personnalisation. Un tableau de bord contient jusqu’à 16 paramètres de valeur et 48 paramètres au total ; la barre de filtres en affiche 16 au maximum.

TypeExemple
Valeur : texte, Valeur : nombre, Valeur : date, Valeur : oui ou non, Valeur : liste fixe, Valeur : liste issue d’une adresseUn seuil, une équipe, un produit
Entité (un appareil, un actif…)L’appareil dont traite la page

Pour un paramètre d’entité, vous choisissez :

RéglageChoix
Mode de sélectionL’utilisateur choisit ; La page ou un lien le définit ; Fixe : une entité ; Fixe : une liste ; Tous du type ; Par nom ; Par sous-type ou profil ; Lié à un autre paramètre ou à une entité
Un ou plusieursUne entité ou Plusieurs entités
Dans la barre de filtresAffiché, l’utilisateur peut le modifier, Affiché, non modifiable, Masqué

La clé d’un paramètre commence par une minuscule et comporte au plus 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 appareil et que le paramètre contient un site, la carte prend les appareils sous ce site ; s’il y en a plusieurs, elle affiche « North plant contient 4 appareils ; en choisir un ». Les choix de l’utilisateur sont conservés dans l’adresse de la page (?p.device=…), afin qu’un lien copié ouvre la même vue.

Limites : un ensemble résolu contient au plus 500 entités (les 500 premières par nom) ; une liste fixe contient au plus 100 éléments ; profondeur de relation de 1 à 10 niveaux.

Filtres de clés

Un filtre de clé 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é….

  • 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 valeur : Texte, Nombre, Booléen, Date et heure.
  • Opérations : égal à, différent de, 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 visualiseurs de le changer.

Limites : 16 filtres par tableau de bord, 8 filtres de clé par filtre, 4 conditions par filtre de clé.

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 Correspondance des mesures dans le menu ⋯ de Appareils, ou dans l’onglet Flux d’un appareil.