Déclarer les variables en masse
Lorsque vous devez créer de nombreuses variables sur un ou plusieurs équipements, la création manuelle une par une peut s'avérer fastidieuse. La plateforme propose plusieurs méthodes pour créer des variables en masse.
Méthode 1 : Création automatique par API
Lorsque vous poussez un datapoint via l'API sur une variable qui n'existe pas encore, celle-ci est créée automatiquement.
Cette méthode est pratique pour un déploiement rapide, mais présente des limites :
- Les variables créées n'ont pas de configuration complète (unité, groupe, cycle...)
- Aucune standardisation entre équipements similaires
- Configuration manuelle nécessaire a posteriori
Cette approche convient pour des tests ou des déploiements ponctuels. Pour une gestion structurée, privilégiez la méthode via les services.
Méthode 2 : Via les services et types d'équipement (recommandée)
Cette méthode permet de créer des variables de manière standardisée et réutilisable en s'appuyant sur le Référentiel.
Principe général
- Créer des services dans le Référentiel (manuellement ou par import de fichier)
- Créer un type d'équipement et y associer ces services
- Synchroniser les équipements dans Administration pour récupérer automatiquement toutes les variables
Étape 1 : Créer les services
Rendez-vous dans le module Référentiel pour créer vos services. Vous pouvez :
- Les créer manuellement un par un
- Importer un fichier Dictionnaire (
.xlsx) contenant la définition de tous vos services
Le fichier Excel contient une ligne par service avec les informations : fabricant, famille, ID produit, ID service, nom, type, unité, groupe, etc. Consultez la page Types d'équipement pour le détail du format.
Étape 2 : Associer les services à un type d'équipement
Une fois vos services créés, associez-les à un type d'équipement dans le Référentiel. Cela définit le modèle de données pour tous les équipements de ce type.
Chaque service peut être configuré avec l'option "Profil par défaut" :
- OUI : le service sera créé automatiquement lors de la synchronisation
- NON : le service ne sera pas importé automatiquement
Étape 3 : Synchroniser les équipements
Depuis le module Administration, sélectionnez les équipements concernés et cliquez sur "Synchroniser".
La synchronisation :
- Récupère la définition du type depuis le Référentiel
- Crée automatiquement toutes les variables correspondant aux services
- Met à jour les équipements existants avec les nouvelles définitions
Les services calculés surchargés (modifiés localement) conservent leur formule personnalisée lors de la synchronisation.
Avantages de la méthode par services
| Avantage | Description |
|---|---|
| Standardisation | Tous les équipements d'un même type partagent la même structure |
| Réutilisabilité | Un type d'équipement peut être appliqué à des centaines d'équipements |
| Maintenance simplifiée | Modifiez le Référentiel, synchronisez, et tous les équipements sont mis à jour |
| Import en masse | Le fichier Dictionnaire permet d'importer des dizaines de services en une fois |
Pour aller plus loin
- Types d'équipement : créer et gérer les types d'équipement et leurs services
- Créer un modèle de donnée : les services : comprendre les services calculés
- Valoriser les données, déclarer une variable : créer des variables manuellement
