Aller au contenu principal

5 articles tagués avec « Administration »

Voir tous les tags
Jean-François
Release notes
Jean-François
Proxy-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
Proxy-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.