Aller au contenu principal

9 articles tagués avec « Administration »

Voir tous les tags
Jean-François
Release notes
Jean-François
Product Owner
Publié le15 septembre 2026
Versionv4.3

Vos incidents, directement sur le graphique

Analyser une courbe et chercher l'alerte correspondante dans un autre widget, c'était jusqu'ici deux gestes distincts. La v4.3 les réunit : vos incidents se lisent désormais sur le graphique lui-même, au moment exact où la donnée décroche.

Nouveautés​

Les incidents sur le graphique de données​

Une option du widget Historique de données ajoute une rangée de repères sous la courbe. Chaque repère correspond à un dysfonctionnement, positionné sur sa période d'activité.

  • Infobulle au survol : le détail du dysfonctionnement s'affiche sans quitter le graphique, et un lien mène à sa fiche complète.
  • Périodes de déconnexion : les moments où l'équipement n'a pas communiqué sont matérialisés distinctement, ce qui évite de confondre une absence de données avec une valeur nulle.
  • Incidents en cours mis en avant : une zone teintée signale la période toujours active, et le présent est repéré sur l'axe.
  • Incidents déjà ouverts : un dysfonctionnement démarré avant le début de la période affichée reste visible, au lieu de disparaître du graphique.
  • Filtre par sévérité : vous choisissez les niveaux à faire apparaître, pour ne pas surcharger la lecture.
  • Regroupement automatique : lorsque les repères se chevauchent, ils se regroupent en pastilles comptées qui se déplient au survol.
Dysfonctionnements matérialisés sous la courbe du widget Historique de données
Dysfonctionnements matérialisés sous la courbe du widget Historique de données
Cliquer pour ouvrir

La même lecture dans vos rapports​

Les dysfonctionnements et les périodes de déconnexion sont restitués à l'identique dans les rapports PDF. Un rapport mensuel transmis à un client porte donc le même niveau d'explication que la consultation en ligne.

Pour aller plus loin : Suivre et traiter les incidents, Paramétrage des widgets et Widget Rapport.

Administration​

  • Vérification de l'activation : un onglet dédié permet de contrôler l'état d'activation d'un équipement et d'identifier où le processus s'est arrêté.
  • Mise à jour des produits simplifiée : le parcours a été raccourci, et un équipement inchangé n'est plus resynchronisé inutilement.

Corrections de Bugs​

  • Conteneurs à onglets : les tableaux de bord concernés se chargent de nouveau normalement, un slider de pages publiées apparaît bien côté exploitation, et le fil d'Ariane n'affiche plus de libellé parasite lors du passage d'un onglet à l'autre.
  • Widget Liste : les deux blocs de l'onglet Redirection n'interfèrent plus, et les champs de type liste déroulante affichent le libellé de l'option et non son identifiant.
  • Redirection : le périmètre est transmis lors d'une redirection depuis le détail d'un dysfonctionnement, et l'ouverture dans un nouvel onglet n'est plus cochée par défaut.
  • Dysfonctionnements : la suppression d'une variable n'abandonne plus de configuration orpheline, et les libellés de la fenêtre de détails ont été corrigés.
  • Référentiel : le nom des services est conservé à l'export puis à l'import de la liste, et la consultation des services de certains types d'équipement ne provoque plus d'erreur.
  • App Builder : redimensionnement du tableau de bord rétabli, ajout de widget protégé contre les clics répétés, et rafraîchissement des widgets Card au changement d'équipement.

Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Jean-François
Release notes
Jean-François
Product Owner
Publié le17 août 2026
Versionv4.2

Composer vos tableaux de bord autrement

Cette version s'intéresse à la structure de vos tableaux de bord. Plus vos parcs grandissent, plus une page unique devient difficile à lire : la v4.2 vous donne de quoi répartir l'information et naviguer dedans. En arrière-plan, la génération des rapports a été entièrement revue.

Nouveautés​

Le widget Liste​

Un nouveau widget affiche vos équipements et vos nœuds sous forme de liste ou d'arborescence, avec les champs de votre choix.

  • Colonnes configurables : vous choisissez les informations affichées pour chaque ligne.
  • Sélection transmise au tableau de bord : cliquer sur un nœud met à jour le périmètre des autres widgets de la page. La liste devient ainsi un sélecteur, en complément de la hiérarchie.
  • Redirection : comme les widgets Card, KPI et Carte, la liste peut ouvrir un autre tableau de bord au clic.

Organiser vos pages​

  • Conteneur à onglets : regroupez plusieurs vues dans un même emplacement et basculez de l'une à l'autre par onglet, sans changer de page.
  • Groupes modifiables : un groupe de pages peut désormais être édité après sa création, sans le reconstruire.
  • Publication depuis la liste des menus : un tableau de bord se publie directement depuis le menu, sans passer par son écran d'édition.
  • Étiquettes sur les tableaux de bord : un système de tags permet de les classer et de les retrouver plus vite quand ils se comptent par dizaines.
Système d'onglet dans l'affichage de vos tableaux de bord
Système d'onglet dans l'affichage de vos tableaux de bord
Cliquer pour ouvrir

Pour aller plus loin : Paramétrage du dashboard, Regroupement de pages et Librairie de widgets.

Rapports : un moteur repensé​

La génération des rapports a été reprise en profondeur pour traiter des volumes plus importants sans incident.

  • Nouveau moteur de rendu et stockage des fichiers produits sur un espace dédié, avec reprise de l'existant.
  • Planificateurs fiabilisés : l'exécution a été retravaillée pour corriger les décalages d'horaire et les exécutions manquées.
  • Gestion des erreurs explicite : un rapport en échec le signale clairement plutôt que de rester en attente.

Pour aller plus loin : Widget Rapport et Lier un rapport à un tableau de bord.

Référentiel & Administration​

  • Filtres et services redessinés : la mise à jour visuelle entamée en v4.1 s'étend aux écrans de sélection.
  • Formulaires de site et d'équipement : saisie plus fluide, notamment sur la gestion des adresses et du champ Pays.
  • Cohérence des services : la création d'un lien de service incohérent est maintenant bloquée en amont plutôt que détectée après coup.
  • Filtre par sévérité : son effet est explicité directement dans l'interface.

Améliorations Techniques​

  • Widget graphique plus rapide, en particulier sur les séries longues.
  • Découplage du chargement de la hiérarchie et des dysfonctionnements : une page ne reste plus bloquée parce qu'un des deux tarde.
  • Nettoyage des appels d'API et des erreurs de console sur l'ensemble des applications.

Corrections de Bugs​

  • Rapports : nœud sélectionné conservé dans le planificateur, dates en mode Absolu enregistrées, ordre de la liste stable après sauvegarde, cloisonnement des rapports par droits client, et disparition du statut contradictoire « Terminé » et « Échoué ».
  • App Builder : nom et icône conservés lors d'une publication à la création, images préservées à la duplication, fond d'écran de tableau de bord conservé, et correction des rechargements en boucle constatés en Asset Management.
  • Périmètre et navigation : un nœud désélectionné le reste en exploitation, le fil d'Ariane affiche l'arborescence complète en mode hiérarchique, et la granularité automatique ne se recoche plus toute seule.
  • Dysfonctionnements : la durée d'un dysfonctionnement rouvert est de nouveau actualisée, et les journaux de modification des tâches affichent les bonnes icônes.
  • Administration : messages d'erreur présents lors des suppressions impossibles, panneau latéral actualisé après suppression d'une variable, et traductions manquantes sur les listes déroulantes de création d'équipement.

Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Jean-François
Release notes
Jean-François
Product Owner
Publié le23 juillet 2026
Versionv4.1

D'un tableau de bord à l'autre, en un clic

Après le chantier de la v4.0, cette version se concentre sur la navigation au quotidien. Jusqu'ici, passer d'une vue de synthèse au détail d'un site demandait de revenir au menu. Vos widgets peuvent désormais faire ce trajet à votre place.

Nouveautés​

App Builder : la redirection depuis les widgets​

Un nouvel onglet Redirection apparaît dans la configuration des widgets Card, KPI et Carte. Vous y désignez le tableau de bord à ouvrir au clic, et c'est tout.

  • Choix de la cible : la recherche est autocomplétée et vous propose vos tableaux de bord récents. Le tableau de bord courant n'est volontairement pas sélectionnable.
  • Le périmètre suit : l'équipement ou le nœud sur lequel vous avez cliqué est transmis à la page d'arrivée. Depuis une carte, c'est le marqueur cliqué qui détermine le contexte, y compris lorsqu'il regroupe plusieurs équipements.
  • Ouverture dans un nouvel onglet : une case à cocher, à vous de voir selon vos habitudes.
  • Droits respectés : un utilisateur sans accès au tableau de bord cible ne se retrouve pas devant une page vide, et la redirection se désactive d'elle-même si la cible est supprimée.
Ajout des options de redirection sur les widgets
Ajout des options de redirection sur les widgets
Cliquer pour ouvrir

Pour aller plus loin : Paramétrage des widgets et Librairie de widgets.

App Builder : confort de configuration​

  • Agrégations globales sur le widget Card : en mode multi-variables, vous obtenez une valeur consolidée sur l'ensemble des variables sélectionnées, et plus seulement une valeur par variable.
  • Configuration des widgets redessinée : l'écran de sélection des filtres et des services a été repris pour gagner en lisibilité, notamment sur les parcs comportant de nombreux services.

Dysfonctionnements : l'inhibition pendant une intervention​

Les dysfonctionnements système peuvent être inhibés temporairement. Pendant une maintenance planifiée ou un incident connu, vous évitez la cascade d'alertes de déconnexion sans avoir à supprimer vos configurations.

Pour aller plus loin : Configurer vos dysfonctionnements.

Référentiel & Administration​

  • Listes de services refaites : l'affichage a été reconstruit, et une recherche déplie automatiquement les niveaux contenant un résultat.
  • Formulaires et groupes de tâches : la gestion des groupes gagne en cohérence, avec une suppression multiple et des listes triées.
  • Export d'un type d'équipement : l'export fonctionne désormais même lorsque le type embarque des variables calculées sans formule.
  • Utilisateur de support : un accès de support temporaire peut être ouvert pour n'importe quel utilisateur, et plus seulement pour certains profils.

Corrections de Bugs​

  • Rapports : l'annulation d'une modification de planificateur fonctionne, le suffixe de nom de fichier ne dépend plus de la langue du site, la génération manuelle attend le chargement complet des widgets, et l'échec d'un rapport n'entraîne plus les autres.
  • Hiérarchie : le contenu d'une hiérarchie par défaut n'est plus visible sans les droits correspondants, la navigation en mode Services ne se réinitialise plus à la sélection d'une variable, et les nœuds supprimés disparaissent des vues.
  • Dysfonctionnements : le statut Terminé s'affiche en vert lorsque l'acquittement n'est pas obligatoire, l'option d'acquittement obligatoire ne s'applique plus rétroactivement à toutes les occurrences, et les actions menées sur les tâches sont tracées dans l'historique.
  • Widgets : corrections sur la jauge, le camembert, le tooltip du widget Historique, la grille du tableau de bord et l'échelle automatique qui masquait certaines données.
  • Référentiel : recherche et suppression multiple sur les formulaires, tri des listes de tâches, et fiabilisation des imports XLSX de services.
  • Administration : l'ordre des colonnes est mémorisé, la recherche se réinitialise au changement d'onglet, et l'image ajoutée à la création d'un client est bien enregistrée.

Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Jean-François
Release notes
Jean-François
Product Owner
Publié le03 juin 2026
Versionv4.0

Les Dysfonctionnements, une supervision repensée de bout en bout

Cette version v4.0 clôt un cycle entamé avec la v3.23. Elle concentre un chantier de fond : la supervision de vos installations ne repose plus sur des Alarmes, mais sur des Dysfonctionnements, une notion plus riche qui suit un incident de sa détection jusqu'à sa résolution. Autour de ce socle, vous retrouverez également des rapports générables au moment où vous en avez besoin et une interface de Variables calculées entièrement redessinée.

Les Dysfonctionnements​

Jusqu'ici, une alarme signalait un dépassement et s'arrêtait là. Un Dysfonctionnement porte davantage : ce qui l'a déclenché, qui l'a pris en charge, ce qu'il reste à vérifier, et ce qu'il s'est passé avant qu'il n'apparaisse.

Des déclenchements que vous maîtrisez​

  • Trois familles de déclenchement : un seuil sur une variable, une expression de calcul, ou une condition temporelle (absence de données, durée d'état). Chaque configuration se pose sur un service, un type d'Équipement ou un Équipement précis, et suit les règles d'héritage du Référentiel.
  • Durée minimale d'activité et anti-rebond : deux réglages pour ne plus être noyé sous les faux positifs. Le premier exige qu'une condition reste vraie un certain temps avant de déclencher, le second évite qu'un signal instable ne génère une rafale d'événements.
  • Prise en compte immédiate des seuils : modifier la valeur d'un seuil met à jour sans délai les dysfonctionnements qui en dépendent, sans attendre la prochaine synchronisation.
  • Valeurs par défaut à la création : les champs d'un nouveau déclenchement sont pré-remplis avec des valeurs cohérentes, ce qui réduit nettement la saisie.

Le détail de ces réglages est documenté dans Éviter les alertes en rafale et les faux positifs.

Un cycle de vie complet​

  • Acquittement : un dysfonctionnement actif peut être pris en charge par un utilisateur, ce qui le distingue immédiatement de ceux que personne n'a encore regardés.
  • Colonne Source : les listes indiquent l'origine du dysfonctionnement, qu'il vienne d'une configuration produit ou du système, ce qui évite de chercher d'où vient une alerte inattendue.
  • Contexte de l'événement : chaque déclenchement conserve une copie de la configuration qui l'a produit et des valeurs observées au moment des faits. Un dysfonctionnement passé reste donc lisible même si la configuration a changé depuis.
  • Archivage : les événements terminés et acquittés basculent automatiquement en historique, ce qui garde les vues courantes lisibles sur les parcs importants.

Des tâches de résolution pour guider vos équipes​

Vous pouvez désormais associer à une configuration de dysfonctionnement une liste de points à vérifier ou d'actions à mener. Cette liste se paramètre depuis le Référentiel et s'affiche directement dans la fenêtre de détails du dysfonctionnement.

L'intérêt est concret : l'administrateur d'un compte y dépose son savoir-faire métier, et l'intervenant qui ouvre l'alerte sait quoi contrôler sans avoir à appeler qui que ce soit. Les formulaires dynamiques complètent le dispositif en permettant de recueillir des informations structurées au moment de la qualification, y compris via des listes à choix multiples.

Popup d'affichage d'un dysfonctionnement
Popup d'affichage d'un dysfonctionnement
Cliquer pour ouvrir

Régénérer un historique après coup​

Il arrive qu'une donnée soit corrigée ou qu'une variable soit recalculée après coup. Dans ce cas, l'historique des dysfonctionnements associés devient faux. Un bouton de régénération d'historique permet de le reconstruire sur la période voulue, à partir des données désormais justes. La plateforme détecte par ailleurs la fin d'une invalidation de variable et en informe le moteur de dysfonctionnements.

La procédure complète est décrite dans Synchronisation Référentiel → Administration.

Vos tableaux de bord suivent​

Les widgets de supervision ont été repris un à un pour exploiter le nouveau modèle :

  • Dysfonctionnements courants et Historique des dysfonctionnements : nouvelle fenêtre de détails, colonnes réordonnables, filtres par statut et par sévérité, export CSV et XLSX.
  • Carte et Hiérarchie : la représentation des dysfonctionnements y est cohérente avec les listes, y compris sur les niveaux intermédiaires d'une Hiérarchie fonctionnelle.
  • Filtres repensés : vous pouvez isoler les dysfonctionnements produits sans le bruit des dysfonctionnements système, cibler un niveau de sévérité, ou ne garder que certaines catégories. Les combinaisons se sauvegardent avec le widget.

Pour aller plus loin : Paramétrage des widgets et Librairie de widgets.

Et vos alarmes existantes ?​

La reprise est automatique. Vos configurations d'alarmes produits et vos alarmes système ont été migrées vers le nouveau modèle, événements et acquittements compris. Les notifications par e-mail restent branchées sur les mêmes destinataires.

Pour aller plus loin : Les dysfonctionnements, Configurer vos dysfonctionnements, Suivre et traiter les incidents et Référence : cycle de vie et synchronisation.

Nouveautés​

App Builder : des rapports au bon moment​

  • Rapport en exploitation : un rapport peut être rattaché à un tableau de bord et généré à la demande, sans planificateur. Son avancement s'affiche en temps réel, y compris si vous ouvrez un autre onglet.
  • Rapport par nœud : la configuration accepte désormais un nœud de Hiérarchie et plus seulement un Équipement. Un rapport par site ou par zone ne nécessite plus de dupliquer une configuration par appareil.
  • Fiabilisation de la génération : traitement des files d'attente, cohérence du style des graphiques entre les modes de période, nommage des fichiers produits et respect du mode DAG lors de la sélection des équipements.

Pour aller plus loin : Widget Rapport et Lier un rapport à un tableau de bord.

Variables calculées : une interface repensée​

  • Nouvelle UI de création et d'édition, alignée sur le moteur de calcul Monk : les périodes, unités, sources et constantes sont regroupées de façon plus lisible, avec un éditeur de code Python plus confortable.
  • Dernière valeur avec profondeur de recherche : une variable calculée peut remonter la dernière valeur connue d'une source, avec une profondeur de recherche paramétrable, y compris sans limite de période.
  • Recalcul sur modification : changer une constante dans une formule arithmétique déclenche le recalcul, et la mise à jour d'une variable du Référentiel invalide proprement la variable concernée ainsi que toutes celles qui en dépendent.
  • Import d'historiques : les flux d'import de mesures historiques ont été industrialisés pour les reprises de données volumineuses.

Pour aller plus loin : Les variables calculées, Configurer une variable calculée, Source de données des calculs, Les formules Python et Déclarer les variables en masse.

Référentiel & Administration​

  • Synchronisation Référentiel ↔ Administration : les configurations partagées entre les deux applications restent alignées, y compris les noms et sévérités des dysfonctionnements système.
  • Formulaires dynamiques : une interface dédiée permet de composer les formulaires utilisés lors de la qualification d'un dysfonctionnement.
  • Bandeau d'environnement : un bandeau identifie l'environnement sur lequel vous travaillez, pour éviter les manipulations sur la mauvaise plateforme.
  • Confort de saisie : suppression automatique des espaces superflus dans les champs libres, tri alphanumérique des listes déroulantes, et repli sur le nom technique lorsqu'un libellé est absent.

Connectivité & Extensions​

  • Enedis : prise en charge du déchiffrement AES 256 et raccordement aux nouveaux flux du fournisseur.
  • Météo : les services météo sont désormais disponibles comme sources de données à part entière.

Pour aller plus loin : Intégration Enedis et Intégration Météo.

Améliorations Techniques​

  • Calcul temps réel des dysfonctionnements accéléré, et nouveaux index sur les événements pour tenir la charge des parcs les plus importants.
  • Construction du cache produits déportée sur un service dédié, plus résistante aux pics de charge.
  • Résilience réseau des échanges entre l'Administration et la couche de connexion des équipements : une coupure passagère ne laisse plus de traitement en suspens.
  • Nettoyage de l'ancien modèle d'alarmes et du code de migration devenu inutile, au bénéfice de la stabilité générale.

Corrections de Bugs​

  • Dysfonctionnements : rafraîchissement immédiat après création ou acquittement (plus besoin de recharger la page), transition correcte vers l'état Terminé après un acquittement manuel, disparition en temps réel des dysfonctionnements désactivés, cohérence des alertes sur les équipements partagés et fiabilisation des alarmes de déconnexion.
  • Notifications : correction de l'adressage des e-mails envoyés à plusieurs destinataires et fiabilisation de leur émission.
  • App Builder : correction du fuseau horaire affiché sur les horodatages, de la période décalée d'un jour sur les graphiques, des unités sur le widget Jauge et l'agrégation Compte, des statistiques affichées en double sur le widget Tableau, et du rafraîchissement automatique du widget Historique de données.
  • Variables calculées & données : correction des ruptures de courbe lors des changements d'heure (été et hiver), des conversions kW vers kWh, des calculs entre sources de sites différents, et des écarts de statistiques constatés après migration.
  • Administration & Référentiel : correction des erreurs à la création d'un équipement, du sélecteur de couleur des seuils, du filtre par numéro de série sur les grands parcs, de la suppression d'un service calculé et de la création d'un fabricant.

Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Jean-François
Release notes
Jean-François
Product Owner
Publié le10 février 2026
Versionv3.22

Expérience utilisateur enrichie et outils d'analyse simplifiés

Cette nouvelle version v3.22 se concentre sur l'amélioration de votre confort d'utilisation quotidien. Qu'il s'agisse de la gestion de vos Équipements, de la précision de vos graphiques ou de la simplification de vos calculs de performance, nous avons optimisé chaque interaction pour vous faire gagner en efficacité.

Nouveautés​

App Builder : Plus de visibilité et de flexibilité​

  • Indicateur de chargement par widget : Vous disposez désormais d'un retour visuel clair lors de la récupération des données. En cas d'erreur ponctuelle, une pastille informative vous permet d'identifier immédiatement le problème et de rafraîchir le widget concerné.
    Icône visuelle de récupération des données sur widget
    Icône visuelle de récupération des données sur widget
    Cliquer pour ouvrir
    Icône visuelle de récupération des données sur widget
    Icône visuelle de récupération des données sur widget
    Cliquer pour ouvrir
  • Export XLSX pour les alarmes : Le widget "Alarme courante" s'enrichit d'une fonction d'export au format Excel, facilitant le partage et le traitement externe de vos alertes actives.
    Nouvelle option de téléchargement sur Widget Alarmes courantes
    Nouvelle option de téléchargement sur Widget Alarmes courantes
    Cliquer pour ouvrir
  • Gestion avancée des mesures : Dans le widget Historical Data (mode tableau), vous pouvez maintenant ajouter un point de mesure directement depuis l'interface de visualisation, sans repasser par les menus de configuration.
  • Optimisation des graphiques : Le comportement du zoom et le rafraîchissement automatique ont été revus pour offrir une navigation plus fluide au sein de vos données historiques.

Référentiel & Administration : Organisation facilitée​

  • Descriptions étendues Data Act Ready : Un nouveau champ "Description" est disponible pour chaque service et variable, permettant de documenter précisément vos données dès leur création.
    Ajout d'une propriété Description traduisible sur la notion de service
    Ajout d'une propriété Description traduisible sur la notion de service
    Cliquer pour ouvrir
  • Navigation optimisée : Lors de vos recherches dans les services ou les types d'Équipement, les listes se déplient automatiquement pour vous afficher les résultats pertinents instantanément.
  • Gestion des utilisateurs : Le processus d'ajout d'un utilisateur a été simplifié avec de nouvelles suggestions ergonomiques.
  • Support multilingue : L'interface détecte et s'adapte mieux à la langue de votre navigateur, tout en bloquant les traductions automatiques intempestives qui pourraient altérer la précision technique des termes.

Connectivité & Extensions​

  • Interfaçage Ewon : Finalisation des spécifications pour l'intégration native des passerelles Ewon avec dDruid.
  • Données Météo : Déploiement d'une fonction de réinjection pour combler les éventuels historiques manquants sur vos capteurs météo.

Améliorations Techniques​

  • Gestion de session : Un nouveau message de déconnexion invite explicitement l'utilisateur à se reconnecter, évitant toute perte de contexte lors d'une expiration de session.

Corrections de Bugs​

  • App Builder : Correction de l'affichage des unités sur les statistiques moyennes et fiabilisation des périodes temporelles avec granularité par défaut.
  • Administration : Résolution d'un blocage de périmètre lors de la suppression d'une Hiérarchie fonctionnelle et correction d'un défaut de rafraîchissement après l'ajout d'un Tag.
  • Calculs : Correction des erreurs d'import pour les services calculés imbriqués et fiabilisation de la synchronisation Monk pour les parcs d'Équipements volumineux.
  • Interface : Correction d'une erreur de saisie sur le message de confirmation de suppression et ajustements visuels sur l'ajout d'icônes clients.

Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Jean-François
Release notes
Jean-François
Product Owner
Publié le05 mars 2025
Versionv3.11

Nouvelle interface d’invitation : plus rapide, plus simple, plus claire

Nous sommes ravis de vous présenter la nouvelle version de la plateforme IoT magic Builder v3.11.

Présentation de la version v3.11​

La principale amélioration concerne l'interface graphique pour inviter les utilisateurs à votre Compte d'entreprise. Les autres améliorations apportées à cette version n'ont pas d'impact direct sur l'expérience utilisateur.

Nouvelles fonctionnalités​

Inviter des utilisateurs à votre Compte d'entreprise​

Dans la console ADMINISTRATION, il est désormais possible de créer les accès par groupes utilisateurs et d'affecter un ou plusieurs Groupe d'accès aux données à chaque groupe, et non plus contact par contact individuellement comme sur les versions précédentes. On y gagne donc en rapidité et en efficacité !

Sur les versions précédentes

Il fallait affecter à chaque contact individuellement un Groupe d'utilisateurs et un ou plusieurs Groupes d'accès aux données. Lorsque la liste des contacts à inviter était longue, cela pouvait vite devenir fastidieux.

Ancienne interface d'invitation des utilisateurs - affectation individuelle
Ancienne interface d'invitation des utilisateurs - affectation individuelle
Cliquer pour ouvrir
Sur la nouvelle version v3.11

Il est maintenant beaucoup plus simple et plus rapide d'affecter un Groupe d'utilisateurs et un ou plusieurs Groupes d'accès aux données à plusieurs contacts à inviter en même temps.

Nouvelle interface d'invitation des utilisateurs - affectation par groupe
Nouvelle interface d'invitation des utilisateurs - affectation par groupe
Cliquer pour ouvrir

Indiquez simplement les emails de vos contacts à inviter sur votre Compte d'entreprise en précisant le Groupe d'utilisateurs auquel les affecter :

Saisie des emails et sélection du Groupe d'utilisateurs
Saisie des emails et sélection du Groupe d'utilisateurs
Cliquer pour ouvrir

Puis indiquez le ou les groupes d'accès aux données :

Sélection des groupes d'accès aux données
Sélection des groupes d'accès aux données
Cliquer pour ouvrir

Vous pouvez créer plusieurs groupes de contacts à inviter en cliquant sur le bouton + :

Création de plusieurs groupes de contacts
Création de plusieurs groupes de contacts
Cliquer pour ouvrir
info

Il est nécessaire d'avoir les droits dans ADMINISTRATION pour réaliser cette opération.


Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Camille
Release notes
Camille
Responsable Marketing & Communication
Publié le16 septembre 2024
Versionv3.6

Sliders interactifs, liens publics et formulaires dynamiques

Nous sommes ravis de vous présenter la nouvelle version de la plateforme IoT magic Builder. Voici un aperçu des fonctionnalités et des améliorations apportées.

Nouvelles fonctionnalités​

Tableau de bord, mode slider​

Découvrez notre nouvel outil de visualisation de vos données : le slider qui vous permet de créer des présentations fluides et dynamiques de vos dashboards.

Basé sur des dashboards, il vous permet d'afficher et de faire défiler les pages de tableaux de bords, tout en conservant les fonctionnalités de navigation entre les pages, dans le temps ou dans votre hiérarchie.

Menu et pages
Menu et pages
Cliquer pour ouvrir

Pour créer votre slider, rien de plus simple. Vous remarquerez qu'une nouvelle option est disponible au sein du mode édition des paramètres du module App Builder : "Ajouter : Nouveau slider".

Vous n'avez plus qu'à y glisser les dashboards que vous souhaitez inclure dans votre slider, et le tour est joué.

Profitez de nombreuses options de personnalisation :

  • Transitions automatiques ou spécifiques pour chaque page
  • Utilisez ou non les contrôles d'affichage pour une navigation manuelle ou automatique
  • Affichage du temps restant pour chaque page
  • Fonctionnalité de pause et reprise à tout moment
  • Possibilité de passer en mode plein écran pour une visualisation optimisée

Création de liens publics pour une exposition plus large​

Les liens publics vous permettent de partager vos dashboards de manière publique sans nécessiter de connexion. Idéal pour les expositions, démonstrations ou communications ouvertes.

Pour créer un lien public, vous devez commencer par créer un utilisateur technique, de la même manière que vous créeriez un nouvel utilisateur. Les utilisateurs techniques sont dédiés à la gestion des accès publics.

Attribuez à cet utilisateur technique les autorisations spécifiques pour contrôler la visibilité et les droits d'accès aux données que vous souhaitez partager.

Créez ensuite des liens publics à partir du "Menu et page" de l'App Builder en cliquant sur la colonne dédiée aux liens publics.

Création de liens publics
Création de liens publics
Cliquer pour ouvrir
À savoir
  • Le lien public créé deviendra le point d'entrée de l'app builder. La navigation entre les dashboards reste possible selon les autorisations définies à votre utilisateur technique
  • L'utilisateur technique ne se déconnectera pas de la plateforme, sauf si le lien public est supprimé

Formulaires dynamiques pour une personnalisation accrue​

Avec les formulaires dynamiques, générez de nouveaux champs d'informations pour vos devices, sites, et clients. Pour ce faire, rendez-vous dans l'onglet "informations techniques" en bas de la page de configuration de votre CA (Customer account).

Exemple de configuration du formulaire :

Configuration du formulaire
Configuration du formulaire
Cliquer pour ouvrir

Exemple de nouveaux champs créés :

Nouveaux champs créés
Nouveaux champs créés
Cliquer pour ouvrir

Configurez ces champs via un format JSON, en suivant les normes prédéfinies ci-dessous pour une personnalisation sans limites.

Types de champs disponibles​

Field typeCustom FieldDescriptionInput type
text
{
  "type": "text",
  "id": "adresse",
  "title": "Adresse"
}
Champ texte classique. Les validations sont effectuées sur la taille du texte, et un message d'erreur ainsi que ses traductions sont déjà configurés.textbox
text (email)
{
  "input": "email",
  "type": "text",
  "id": "userEmail",
  "title": "User Email"
}
Validation par défaut DevExtreme pour les emails. Les traductions par défaut sont déjà implémentées. La validation n'est effectuée que si le champ est obligatoire.email
text (phone)
{
  "input": "phone_number",
  "type": "text",
  "id": "phoneNumber",
  "title": "Phone Number"
}
Vérification effectuée à l'aide de libphonenumber-js. Le numéro est formaté pour être lisible. La validation n'est effectuée que si le champ est obligatoire.phone_number
text (select)
{
  "type": "text",
  "input": "selectbox",
  "id": "country",
  "title": "Country",
  "selectOptions": [...]
}
Permet de sélectionner une option parmi des valeurs prédéfinies. Ces options sont configurées via le champ selectOptions. L'information enregistrée est l'id.dropdown
selectbox
radio_buttons
text (large)
{
  "input": "large_textbox",
  "type": "text",
  "id": "description",
  "title": "Description"
}
Reprend le principe du texte mais accepte des entrées plus grandes, et la taille du texte acceptée est plus importante.

Champ texte
Champ texte
Cliquer pour ouvrir
large_textbox
number
{
  "type": "number",
  "input": "textbox",
  "id": "postalCode",
  "numberBoxControls": true,
  "title": "Postal code",
  "min": 0,
  "max": 99999
}
Des champs supplémentaires peuvent être utilisés pour définir une plage max et min. Les boutons sur le côté peuvent être utilisés pour incrémenter ou décrémenter la valeur de 1.

Champ numérique
Champ numérique
Cliquer pour ouvrir
number_box
text_list
{
  "input": "selectbox",
  "type": "text_list",
  "id": "country",
  "title": "Country",
  "selectOptions": [...]
}
Même principe que pour le texte, mais permet de sélectionner plusieurs options prédéfinies.dropdown
selectbox
radio_buttons
date
datetime
time
{
  "type": "datetime",
  "input": "datetime_selector",
  "id": "registrationTimestamp",
  "title": "Registration Timestamp",
  "displayFormat": "MMMM dd, yyyy HH:mm:ss"
}
Ces champs fournissent un sélecteur pour sélectionner une date, une heure ou les deux. Un champ displayFormat est utilisé pour définir l'affichage.

Sélecteur de date
Sélecteur de date
Cliquer pour ouvrir

Exemples de format d'affichage (timestamp du 15/06/2021 à 20:45:34) :
• MM/dd/yyyy → 07/15/2021
• MM/dd/yy → 07/15/21
• dd.MM.yyyy → 15.07.2021
• MMMM dd, yyyy → July 15, 2021
• EEEE, MMMM dd → Thursday, July 15
• HH:mm:ss → 20:45:34
• hh:mm a → 08:45 PM
• MMMM dd, yyyy HH:mm:ss → July 15, 2021 20:45:34
date_selector
datetime_selector
time_selector
boolean
{
  "type": "checkbox",
  "id": "activeContact",
  "title": "Active contact",
  "defaultValue": true
}
Le champ est représenté par une case à cocher. L'état par défaut est undefined. Pour cocher ou décocher la case par défaut, utilisez le champ defaultValue.

Case à cocher
Case à cocher
Cliquer pour ouvrir
(checkbox)

Références​

Pour plus d'informations sur les formats et validations, consultez la documentation officielle :


Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Camille
Release notes
Camille
Responsable Marketing & Communication
Publié le06 août 2024
Versionv3.5

Nouvelle interface de variables calculées & automatisation des services calculés

Nous sommes ravis de vous présenter la nouvelle version de la plateforme IoT magic Builder. Dans cette release, la nouveauté majeure est la nouvelle interface de création de variables calculées. Voici un aperçu des fonctionnalités et des améliorations apportées.

Nouvelles fonctionnalités​

Nouvelle interface de création de variables calculées​

Créez vos variables calculées depuis le module Administration​

Pour créer votre nouvelle variable calculée d'un équipement, rendez-vous dans la partie de configuration des variables d'un équipement, dans le module administration.

Interface de création de variables
Interface de création de variables
Cliquer pour ouvrir

C'est ici que vous retrouverez aussi par la suite toutes vos variables, les variables calculées étant signalées par l'icône calculette dans la colonne calculé.

Pour créer votre variable calculée, utilisez le bouton "nouvelle variable calculée". Vous y retrouvez alors un nouvel onglet "calculs", pour paramétrer les calculs à appliquer pour une période donnée.

info

Par défaut, un calcul couvrira l'intégralité de la période temporelle, soit de - l'infini à + l'infini.

Au besoin, vous avez la possibilité de définir des calculs différents en ajoutant de nouvelles périodes temporelles sur lesquelles appliquer ces calculs pour générer la variable calculée. Le cumul des périodes devra toujours couvrir l'intégralité de la période temporelle, soit de - l'infini à + l'infini.

Configuration des périodes de calcul
Configuration des périodes de calcul
Cliquer pour ouvrir

Cliquez sur la période temporelle pour définir la formule de votre variable calculée.

Créez votre formule en utilisant des constantes, des variables et des opérateurs​

Interface de création de formule
Interface de création de formule
Cliquer pour ouvrir

Le "déclencheur" est l'élément qui lancera le calcul de la formule. Il peut être régulier, et sera dans ce cas un déclencheur temporel, défini sur la plage de gauche.

Il peut aussi être conditionné à la réception d'une ou de plusieurs variables contenues dans la formule. Le calcul se lancera alors chaque fois que cette donnée remontera dans la plateforme.

Les opérateurs de base pris en charge par l'interface de création de variables calculées

Pour utiliser une variable dans la formule, écrivez simplement le nom de la variable entre crochets (ex: [Seuil_1]).

Opérateurs arithmétiques :

  • Les opérateurs autorisés sont : +, -, / et *
  • Les parenthèses sont également supportées : ( et )
  • Exemple 1 : [Variable_1] * [Constante_1]
  • Exemple 2 : ( [Variable_1] + [Variable_2] ) / [Variable_1]

Opérateurs de comparaison et logiques :

  • Vous pouvez comparer deux opérandes en utilisant l'un des opérateurs suivants : >, <, <=, >= ou =
  • Vous pouvez ajouter des opérations logiques entre les opérandes conditionnelles en utilisant l'un des opérateurs suivants : || (ou), && (et) ou ! (inverse)
Interface de création de formule
Interface de création de formule
Cliquer pour ouvrir

Pour chaque variable que vous avez définie entre crochets [x] dans votre formule, un panneau de configuration de cette variable mathématique est créé.

De manière générale, votre variable [X] peut faire référence à une constante ou une variable à travers tous les sites, équipements et variables de votre client.

Vous gérez aussi l'agrégation et la granularité des données pour chaque variable.

La période indiquée dans la configuration de la variable représente la période sur laquelle les données seront récupérées pour générer la variable calculée. Par défaut cette période est d'un jour. En fonction de la granularité et de la période définies, la génération de la variable calculée prendra donc un volume de données en compte différent.

Types de formules disponibles​

Formule arithmétique

La formule arithmétique génère un résultat numérique basé sur les opérations mathématiques.

Formule arithmétique
Formule arithmétique
Cliquer pour ouvrir

Formule conditionnelle

Renvoie un résultat binaire, où 'oui' = 1 et 'non' = 0, en fonction de la condition énoncée dans la formule.

  • Si la condition est vérifiée, le résultat sera 1
  • Si la condition n'est pas vérifiée, le résultat sera 0

Ce type de formule sera particulièrement pertinent pour la mise en place de nouvelles alarmes.

Formule conditionnelle
Formule conditionnelle
Cliquer pour ouvrir

Formule de consommation

Suit l'évolution d'une variable sur la période donnée avec un déclencheur temporel obligatoire. Cette formule est dédiée au monitoring de compteurs et ne peut donc pas être négatif.

Ce type de formule ne nécessite donc pas d'opérateurs.

Gestion des retours à zéro : Interpolation automatique des points de données manquants par régression linéaire.

Formule de consommation
Formule de consommation
Cliquer pour ouvrir

Formule de temps de fonctionnement

Indique le temps pendant lequel une condition a été remplie.

Cette condition peut être variable.

Ce type de formule ne nécessite donc pas d'opérateurs.

Formule de temps de fonctionnement
Formule de temps de fonctionnement
Cliquer pour ouvrir

Outils supplémentaires​

  • Téléchargement de formules : Vous pouvez télécharger la formule de calcul au format JSON pour une utilisation ultérieure
  • Fichier R : Possibilité de remplir un fichier R pour des analyses avancées
  • Débogage : Téléchargez un échantillon de données pour déboguer les formules
  • Simulation : Simulez des périodes de données pour vérifier la validité de vos calculs

Créez un modèle pour la création de variables calculées automatique​

Comme pour les services, qui sont des modèles de données à générer selon le type d'équipement provisionné, vous pouvez créer des modèles de variables calculées. Ces modèles seront appelés des services calculés.

La création de services calculés n'est possible que pour les calculs ne prenant en compte que les variables d'un équipement unique.

Pour cela, rendez-vous dans le module Référentiel de la plateforme.

Module Référentiel
Module Référentiel
Cliquer pour ouvrir

Commencez par créer un nouveau service dans la section services.

Rendez-vous ensuite dans l'onglet services calculés au sein de votre type d'équipement, pour y ajouter le service calculé.

Services calculés
Services calculés
Cliquer pour ouvrir

Cliquez sur + Créer, sélectionnez le service que vous souhaitez ajouter en tant que service calculé, puis configurez votre service calculé comme vous le feriez d'une variable calculée.

Création d'un service
Création d'un service
Cliquer pour ouvrir
Rappel

Un service est toujours rattaché à un item, qui est lui-même rattaché à un équipement. Ceci reste vrai pour les services calculés.

Lors de la création d'un équipement comprenant l'item, la variable calculée sera automatiquement générée pour ce produit.

Synchronisation et modification​

Vous pouvez toujours modifier votre service calculé. Dans ce cas, vos modifications seront appliquées sur l'ensemble des variables calculées liées.

À savoir

Toute modification d'une formule remplacera aussi les points de données calculés dans le passé. Cette nouvelle itération de calcul de l'ensemble des points de données peut prendre quelques minutes. Si vous souhaitez conserver votre ancien historique, nous vous recommandons de créer un nouveau calcul sur une nouvelle plage temporelle au sein de la variable ou du service calculé.

Vous pouvez aussi choisir de modifier une formule calculée, liée à un service calculé, pour un équipement uniquement, directement depuis la partie administration. Cela stoppera la synchronisation entre la variable calculée et son service calculé.

L'icône Warning s'affichera alors au niveau de la variable pour indiquer cette désynchronisation.

Vous pourrez à tout moment remettre en place la synchronisation ultérieurement grâce au bouton synchroniser.

Bouton de synchronisation
Bouton de synchronisation
Cliquer pour ouvrir

Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.

Camille
Release notes
Camille
Responsable Marketing & Communication
Publié le19 mars 2024
Versionv3.2

Synthèse intelligente des équipements, gestion des contrats et analytics exportables

Nouvelles fonctionnalités​

Un nouveau widget pour créer une synthèse dynamique des informations de vos équipements​

Créez facilement des synthèses dynamiques de vos équipements, sans avoir à configurer chaque widget manuellement, grâce au nouveau widget Liste de produits intelligente. La liste intelligente affiche automatiquement les widgets et les variables prédéfinies pour chaque équipement sélectionné.

astuce
  • Pensez à autoriser la sélection multiple d'équipement au niveau de la configuration de l'arborescence de votre Dashboard pour permettre de sélectionner les produits à volonté
  • Vous pouvez aussi utiliser les tags au niveau de la configuration du widget liste de produits intelligente pour que la sélection des équipements/variables à afficher s'adapte automatiquement au tag choisi. Ainsi, un nouvel équipement portant ce tag sera automatiquement intégré à la liste.

Gestion simplifiée des contrats client sur les produits​

Une information qui intéressera surtout les tiers de maintenance et les parcs de machines en location, de nouveaux champs pour le numéro et la date du contrat sont désormais disponibles. Configurez facilement les contrats associés à vos produits directement depuis l'interface d'administration. Il est possible d'afficher ces informations lors de la génération de rapport au travers des widgets Information produit ou TextBox.

Numéro de contrat - Vue admin
Visualisation du numéro de contrat au sein d'Administration
Cliquer pour ouvrir
Numéro de contrat - Vue dashboard
Visualisation du numéro de contrat au sein d'AppBuilder
Cliquer pour ouvrir

Récupération des statistiques en format CSV / XLSX par compte entreprise​

Analysez facilement l'utilisation de la plateforme en récupérant vos statistiques au niveau du Corporate Account en format CSV / XLSX.

Nouveau format - Vue admin
Export des statistiques de votre compte
Cliquer pour ouvrir

Améliorations & Corrections​

Récupération des données pour charger les tableaux de bord plus rapidement​

Nous avons optimisé la récupération des données pour accélérer le chargement de vos tableaux de bord, améliorant ainsi votre expérience utilisateur.

Gestion des Providers​

Nous facilitons désormais l'intégration d'autres plateformes grâce à notre système de gestion des Providers. Vous pouvez maintenant connecter votre plateforme à d'autres services de manière plus fluide pour enrichir votre expérience IoT.

Breaking changes​

Modification API​

Suppression des API dépréciées - Connecteur générique

Certaines routes de l'API du connecteur générique, dépréciées depuis la version 3.0, sont supprimées. Les scripts et applications utilisant ces routes doivent être mis à jour avant la livraison de la version 3.2, sans quoi les appels vers les routes actuellement dépréciées ne fonctionneront plus. Les DTOs (body & réponses) sont aussi modifiées, il conviendra d'adapter les appels en fonction.


Changelog

Spécification OpenAPI​

Téléchargement​

Vous pouvez télécharger la spécification complète de l'API au format OpenAPI 3.0 :

📄 Télécharger openapi3_0.json

Visualisation​

Voir un aperçu de la spécification OpenAPI

Cette API utilise OpenAPI 3.0.0 et comprend les contrôleurs suivants :

Endpoints disponibles :

  • Streams - Gestion des flux de données
  • Alarms - Gestion des alarmes
  • Alarm Histories - Historique des alarmes
  • Data Points - Points de données (recommandé)
  • Variables - Statistiques des variables
  • Health Check - Vérification de santé du service

Informations API :

  • Titre : IoT Framework Generic Connector
  • Version : 3.1.2
  • Sécurité : OAuth2 (Authorization Code Flow)

Pour une utilisation complète, importez le fichier JSON dans un outil compatible OpenAPI comme Swagger Editor, Postman, ou Insomnia.

Liens utiles :


IoT Framework Generic Connector API​

Version 3.1.2 - OAS 3.0​

Cette release inclut la documentation complète de l'API IoT Framework Generic Connector.


Streams​

POST /api/streams ⚠️ Deprecated

Recherche les flux de données pour un équipement donné, correspondant aux filtres.

Paramètres:

NomTypeLocalisationDescription
x-iot-corporateaccountuuidstringheaderUUID du compte entreprise (requis)

Corps de la requête:

{
"from": "string",
"to": "string",
"timezone": "string",
"useDeviceLocalTimezone": true,
"granularity": {},
"series": [
{
"deviceUuid": "string",
"itemType": "string",
"itemIndex": "string",
"serviceId": "string",
"aggregation": {}
}
],
"paging": {
"pageNumber": 0,
"itemsPerPage": 0
},
"pagingOrder": "string"
}

Réponses:

  • 201 Created
{
"from": "",
"to": "",
"timezone": "string",
"useDeviceLocalTimezone": true,
"granularity": {},
"series": [
{
"deviceUuid": "string",
"variableUuid": "string",
"itemType": "string",
"itemIndex": "string",
"serviceId": "string",
"aggregation": {},
"dataType": {},
"deviceTimeZone": "string",
"data": [
{
"at": "string",
"value": "number | string"
}
]
}
],
"paging": {
"pageNumber": 0,
"itemsPerPage": 0
},
"pagingOrder": "string"
}
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête
POST /api/streams/publish ⚠️ Deprecated

Publie un tableau de données. Deprecated - Utilisez le contrôleur Data Points.

Paramètres:

NomTypeLocalisationDescription
x-iot-corporateaccountuuidstringheaderUUID du compte entreprise (requis)

Corps de la requête:

{
"at": "string",
"deviceUuid": "string",
"data": [
{
"itemType": "string",
"itemIndex": "string",
"serviceId": "string",
"type": "string",
"at": "string",
"q": 0,
"value": 0,
"oldValue": 0,
"result": 0
}
]
}

Réponses:

  • 201 Created - Données publiées avec succès
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête

Data Points​

POST /api/ca/{corporateAccountUuid}/devices/{deviceUuid}/datapoints

Envoie des données aux variables selon l'UUID donné.

Paramètres:

NomTypeLocalisationDescription
corporateAccountUuidstringpathUUID du compte entreprise (requis)
deviceUuidstringpathUUID de l'équipement (requis)

Corps de la requête:

{
"dataset": [
{
"variableUuid": "string",
"data": [
{
"date": "2023-11-06T10:08:56Z",
"value": "string"
}
]
}
]
}

Réponses:

  • 200 OK
{
"result": "string"
}
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête
POST /api/ca/{corporateAccountUuid}/last-values-request

Recherche les dernières valeurs de plusieurs variables.

Paramètres:

NomTypeLocalisationDescription
corporateAccountUuidstringpathUUID du compte entreprise (requis)

Corps de la requête:

{
"timezone": "UTC",
"granularity": "raw",
"variableUuids": [],
"deviceUuids": [],
"itemType": "Global",
"itemIndex": "0",
"serviceIds": []
}

Réponses:

  • 200 OK
{
"results": [
{
"deviceUuid": "string",
"variableUuid": "string",
"unit": "string",
"serviceId": "string",
"itemType": "string",
"itemIndex": "string",
"aggregation": {},
"dataType": {},
"data": [
{
"at": "string",
"value": "number | string"
}
]
}
]
}
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête
POST /api/ca/{corporateAccountUuid}/datapoints-request

Recherche des points de données avec filtres et pagination.

Paramètres:

NomTypeLocalisationDescription
corporateAccountUuidstringpathUUID du compte entreprise (requis)

Corps de la requête:

{
"from": 0,
"to": 0,
"timezone": "UTC",
"granularity": "raw",
"paging": {
"pageNumber": 0,
"itemsPerPage": 0
},
"pagingOrder": "string",
"aggregations": ["sum"],
"variableUuids": [],
"deviceUuids": [],
"itemType": "Global",
"itemIndex": "0",
"serviceIds": []
}

Réponses:

  • 200 OK - Résultats de la recherche
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête
GET /api/ca/{corporateAccountUuid}/devices/{deviceUuid}/last-values ⚠️ Deprecated

Recherche les dernières valeurs pour un équipement donné.

Paramètres:

NomTypeLocalisationDescription
corporateAccountUuidstringpathUUID du compte entreprise (requis)
deviceUuidstringpathUUID de l'équipement (requis)
serviceIdsstringqueryListe des identifiants de service (ex: 140000,141000)
itemTypestringqueryType d'élément (ex: Global)
itemIndexstringqueryIndex d'élément (ex: 0)
languagestringqueryLangue pour les traductions de variables

Réponses:

  • 200 OK
{
"devices": [
{
"deviceUuid": "string",
"deviceTimeZone": "string",
"values": [
{
"serviceGroup": "string",
"serviceType": "string",
"value": "string",
"unit": "string",
"date": "2025-11-27T16:17:57.042Z",
"serviceId": "string",
"title": "string",
"itemType": "string",
"itemIndex": "string",
"itemName": "string",
"deviceUuid": "string",
"deviceName": "string",
"variableUuid": "string"
}
]
}
]
}
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête
PUT /api/ca/{corporateAccountUuid}/last-values ⚠️ Deprecated

Recherche les dernières valeurs pour plusieurs équipements.

Paramètres:

NomTypeLocalisationDescription
corporateAccountUuidstringpathUUID du compte entreprise (requis)

Corps de la requête:

{
"devices": [
{
"deviceUuid": "string",
"itemType": "string",
"itemIndex": "string",
"serviceIds": ["string"]
}
],
"language": "string"
}

Réponses:

  • 200 OK - Dernières valeurs récupérées
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête
PUT /api/ca/{corporateAccountUuid}/datapoints ⚠️ Deprecated

Recherche les flux de données pour un équipement donné.

Paramètres:

NomTypeLocalisationDescription
corporateAccountUuidstringpathUUID du compte entreprise (requis)

Corps de la requête:

{
"from": "string",
"to": "string",
"timezone": "string",
"useDeviceLocalTimezone": true,
"granularity": {},
"series": [
{
"deviceUuid": "string",
"itemType": "string",
"itemIndex": "string",
"serviceId": "string",
"aggregation": {}
}
],
"paging": {
"pageNumber": 0,
"itemsPerPage": 0
},
"pagingOrder": "string"
}

Réponses:

  • 200 OK - Flux de données récupérés
  • 400 Bad Request - Paramètres invalides
  • 404 Not Found - Ressources non trouvées
  • 409 Conflict - Erreur lors de la requête

Tableau de correspondance des routes API​

Ancienne routeNouvelle route à utiliser
POST /api/streamsPOST /api/ca/{corporateAccountUuid}/datapoints-request
POST /api/streams/publishPOST /api/ca/{corporateAccountUuid}/devices/{deviceUuid}/datapoints
GET /api/ca/{corporateAccountUuid}/devices/{deviceUuid}/last-valuesPOST /api/ca/{corporateAccountUuid}/last-values-request
PUT /api/ca/{corporateAccountUuid}/lastvaluesPOST /api/ca/{corporateAccountUuid}/last-values-request
PUT /api/ca/{corporateAccountUuid}/datapointsPOST /api/ca/{corporateAccountUuid}/datapoints-request

Notes importantes​

Endpoints dépréciés

Plusieurs endpoints sont marqués comme deprecated. Il est recommandé d'utiliser les nouveaux endpoints du contrôleur Data Points pour les nouvelles intégrations.

Format des dates

Les dates peuvent être au format ISO 8601 (2023-11-06T10:08:56Z) ou timestamp Unix (1699265336).


Illustration IoT magic Builder

Merci d'utiliser IoT magic Builder. Pour toute question ou assistance, veuillez contacter notre support technique.