Aide à la définition des handles, spécification par famille

  • Tutoriel

Tutorial

Ce tutoriel décrit la mise en place d’un schéma de données commun pour des équipements appartenant à une même famille, ainsi que les mécanismes permettant de créer facilement plusieurs instances à partir de ce schéma, à l’aide d’un script Office.

Bien qu’il soit possible de définir des handles différents pour des équipements au sein d’une même famille, il n’est pas rare de souhaiter formaliser un schéma de données identique pour des équipements appartenant à cette famille.

Dans ce tutoriel, nous allons voir comment, à l’aide d’un script Office (prérequis : accès à un abonnement Office), il est possible de simplifier la définition des familles d’équipements ainsi que la création de différentes instances d’équipements d’une même famille, tout en pouvant spécifier les particularités de chacune.

Prérequis : Importer dans Excel le script d’automatisation d’instanciation

Afin de pouvoir utiliser les fonctionnalités présentées dans la suite de ce tutoriel, il faut télécharger :

  • Le fichier de déclaration Excel Immersive de base : Immersive-FichierExemple.xlsx
  • Le script Excel d’automatisation à cette adresse : XXX

Une fois téléchargés, ouvrez le fichier Excel Immersive de base puis importez le script d’automatisation en cliquant sur Automatiser > Tous les scripts > Afficher plus de Scripts > Immersive – Instanciation.osts > Ouvrir.

Import du script d’automatisation Office dans Excel.

Le script est maintenant ajouté à votre classeur et pourra être exécuté plus tard.

Déclaration d’une nouvelle famille d’équipement

Une famille d’équipement représente un groupe d’équipements qui partagent une même structure ou comportement.

Par exemple, tous les capteurs de température d’un bâtiment avoir une variable de température et une autre d’hygrométrie tant que les portes ont une variable représentant si elles sont ouvertes ou fermées.

Exemple : Définition d’une nouvelle famille d’équipement

Dans notre exemple nous allons donc déclarer une nouvelle famille « Capteur de température », pour cela il suffit de dupliquer la feuille « New Family » de notre Excel Immersive de base et la renommer en « Capteur de température ».

Duplication de la feuille New Family pour créer une nouvelle famille.

Une fois dupliquée et renommée, notre feuille Excel expose les différentes colonnes permettant de déclarer de nouvelles variables associées aux différents capteurs.

Colonnes de déclaration des variables dans une famille d’équipement.

Ajout de variables à une famille

Chaque ligne dans la feuille d’une famille représente une variable et chaque colonne représente une donnée associée à cette variable. (Les valeurs en rouge représentent les données obligatoires à déclarer pour une variable, les autres en noir restent tout à fait optionnelles).

  • Propriété : Le nom de la variable
  • Référence propriété : Un code métier
  • Identifiant d’interopérabilité
  • Path / Chemin
  • Type
  • Grandeur Physique
  • Unité
  • Etat automatique
  • Options
  • Badge / Criticité
  • Priorité
Exemple de définition de variables dans une famille.

Exemple : Définition de 2 variables

Exemple de définition des variables Température et Hygrométrie.

Création d’instances d’équipements

Une instance d’équipement représente un équipement d’une famille, par exemple le capteur de température de la chambre ou le capteur de température du salon.

Pour spécifier de nouvelle instance, il suffit de se rendre dans la feuille Excel « Instances ».

Feuille Excel Instances pour la création des équipements.

Chaque ligne dans la feuille d’instances représente une nouvelle instance d’équipement et chaque colonne représente une donnée associée à cet équipement.

Colonnes de définition des instances d’équipements.

Exemple : Création de 2 instances d’équipements

Création de deux instances d’équipements dans Excel.

Exécution du script

Une fois les familles et les instances définies, il suffit d’exécuter le script d’automatisation, qui va merger les définitions d’instances avec les définitions des familles.

Pour exécuter le script, assurez vous d’être dans l’onglet Automatiser et cliquer sur Executer.

Exécution du script d’automatisation Excel.

Le résultat de la génération se trouve dans l’onglet Data.

Résultat de la génération dans l’onglet Data.

Une fois cette étape effectuée, il est maintenance possible d’importer les équipements depuis le back office immersive comme expliqué dans ce tutoriel : lien vers import excel

Spécification de colonne supplémentaires

Il est assez fréquent de devoir paramétrer des valeurs spécifiques des instances. Afin de répondre à ce besoin, il suffit de rajouter une colonne dans la feuille d’instances.

Ajout de colonnes supplémentaires pour la personnalisation des instances.

Développeur