Importazione di attrezzature in blocco usando Office 365 ed Excel

• Tutorial

Training

Questo capitolo descrive come preparare un file Excel per creare dispositivi in massa in Immersive. L'obiettivo è accelerare l'onboarding di un sito (o di un perimetro) descrivendo famiglie, variabili e istanze in un foglio di calcolo, poi generando automaticamente i file attesi dal Back Office (Enhancer). Segui l'ordine: Prerequisiti→ Preparazione dei dati → Dichiarazione delle istanze → esecuzione dello script → colonne personalizzate.

Promemoria: principio del manico o variabile

Una maniglia (o variabile) rappresenta una proprietà di un equipaggiamento. È il collegamento tra i dati provenienti da un sensore o dati statici e il loro display nell'interfaccia.

Per definire un handle, è essenziale compilare almeno quattro informazioni:

• Il suo nome : Il testo visualizzato nell'interfaccia per fare riferimento alla variabile.
• Il suo tipo : ad esempio un Booleano per un contatto secco, un Singolo per un dato numerico come un sensore di temperatura, o una Stringa per uno stato.
• Il suo percorso : la stringa di connessione usata per definire come la variabile recupera il suo valore dall'applicazione (esempio: BuildingSensor://temp/Temperature).
• La sua categoria (Informazioni predefinite):
  • Informazioni —È la visualizzazione predefinita di una variabile. Non attiva alcun comportamento specifico se non la visualizzazione del suo valore nel blocco dedicato Informazioni.
  • Predefinito : Visualizzata nel blocco dedicato dell'attrezzatura. Quando la variabile è impostata su vero, 1 o kb, viene visualizzata in rosso e il dispositivo è considerato responsabile nell'applicazione.
  • Manutenzione : Visualizzata nel blocco dedicato dell'attrezzatura. Quando la variabile è impostata su vero, 1 o kb, viene visualizzata in arancione e il dispositivo è considerato in manutenzione nell'applicazione.
  • Connettività : Visualizzata nel blocco dedicato dell'attrezzatura. Quando la variabile viene impostata su true, 1 o KB, il dispositivo viene completamente disconnesso dall'applicazione.

Specifica per famiglia tramite script Office e Excel 365

Sebbene sia possibile definire mani diversi per le apparecchiature della stessa famiglia, non è raro voler formalizzare uno schema dati identico per le apparecchiature appartenenti a questa famiglia.

In questo tutorial, vedremo come, usando uno script Office (prerequisito: accesso a un abbonamento Office), sia possibile semplificare la definizione delle famiglie di apparecchiature così come la creazione di diverse istanze di apparecchiature nella stessa famiglia, specificando al contempo le particolarità di ciascuna.

Prerequisiti: Importare lo script di automazione dell'istanziazione in Excel

Per poter utilizzare le funzionalità presentate nel resto di questo tutorial, devi scaricare:

• Il file base di dichiarazione Excel Immersive: Immersive-FichierExemple.xlsx
• Lo script di automazione Excel

Una volta scaricato, apri il file Excel base di Immersive e poi importa lo script di automazione cliccando Automatiser > Tous les scripts > Afficher plus de Scripts > Immersive – Instanciation > Ouvrir.

Ora lo script viene aggiunto al tuo quaderno e può essere eseguito successivamente.

Dichiarazione di una nuova famiglia di attrezzature

Una famiglia di beni rappresenta un gruppo di beni che condividono una struttura o un comportamento comune.

Ad esempio, tutti i sensori di temperatura in un edificio hanno una variabile di temperatura e una di umidità, purché le porte abbiano una variabile che indica se sono aperte o chiuse.

Esempio: Definizione di una nuova famiglia di apparecchiature

Nel nostro esempio dichiareremo quindi una nuova famiglia "Sensore di temperatura"; per farlo basta duplicare il foglio New Family del nostro Excel Immersive di base e rinominarlo in "Sensor di Temperatura".

Una volta duplicato e rinominato, il nostro foglio Excel espone le diverse colonne per dichiarare nuove variabili associate ai diversi sensori.

Aggiunta di variabili a una famiglia

Ogni riga nel foglio di una famiglia rappresenta una variabile, e ogni colonna rappresenta i dati associati a quella variabile. (I valori suffissi da * rappresentano i dati obbligatori da riportare per una variabile, mentre gli altri restano opzionali).

• Proprietà * : Il nome della variabile (esempio: Temperatura)
• Riferimento della proprietà : Un codice aziendale per fare riferimento alla variabile negli script (esempio: TEMP)
• ID di interoperabilità : Un identificatore aziendale associato alla variabile dichiarata in un altro ambiente.
• Path / Chemin * : La stringa di connessione per definire come la variabile recupera il suo valore dall'applicazione (esempio: BuildingSensor://temp/Temperature). Consulta il tutorial associato all'hub per maggiori informazioni. Per impostare un valore di una variabile codificata in modo rigido senza essere collegata all'hub, basta prefissarla con "Value://" (esempio: Value://35)
• Tipo * : Il tipo della variabile, (ad esempio Single per una variabile numerica, String per una stringa, o Boolean per una variabile a 2 stati).
• Grandezza fisica : La grandezza fisica riportata da questa variabile. (Esempio: Temperatura)
• Unità : L'unità di misura. (Esempio: C°)
• Stato automatico : La categoria della variabile. Consulta il tutorial associato alle categorie variabili per maggiori informazioni.
• Opzioni : Varie opzioni per regolare finemente il comportamento di questa variabile nell'interfaccia. In particolare per nascondere la variabile agli utenti.
• Distintivo / Criticità : Un nome per il distintivo. Consulta il tutorial associato ai badge di criticità per maggiori informazioni.
• Priorità : Una priorità per evidenziare una variabile rispetto alle altre.

Definizione di 2 variabili

Nel nostro esempio, creeremo 2 variabili: Temperatura e Umidità. Per farlo, aggiungeremo semplicemente 2 righe al nostro foglio Excel "Temperature Sensor" e riempiremo le colonne obbligatorie "Proprietà", "Percorso" e "Tipo", e inseriremo "Property Reference" per semplificare l'accesso alle variabili più avanti nello Scripting:

• Impostare una variabile per recuperare la temperatura di un Sensore di Temperatura
  • Proprietà : Temperatura
  • Proprietà di riferimento : TEMP
  • Percorso : BuildingSensor://{REFERENCE}/Temperatura
  • Tipo : Singolo
• Definizione di una variabile per recuperare l'umidità di un sensore di temperatura
  • Proprietà : Umidità relativa
  • Proprietà di riferimento : HYGRO
  • Percorso : BuildingSensor://{REFERENCE}/Umidità
  • Tipo : Singolo

Creazione di istanze di dispositivo

Un'istanza di asset rappresenta un dispositivo in famiglia, come il sensore di temperatura della camera da letto o il sensore di temperatura del soggiorno. Abbiamo quindi 2 istanze della famiglia dei Sensori di Temperatura.

Per specificare una nuova istanza, basta andare nel foglio Excel "Istanze"

Ogni riga nel file di istanza rappresenta una nuova istanza del dispositivo, e ogni colonna rappresenta i dati associati a quel dispositivo. (I valori suffissi da * rappresentano i dati obbligatori da dichiarare per un apparecchiatura, gli altri restano opzionali).

• Ambito * : L'ambito corrisponde nella maggior parte dei casi all'edificio o al pannello in cui si trova la nostra attrezzatura (esempio: Il mio edificio). Nel caso in cui il tuo ambiente abbia più edifici, definiremo un ambito per ogni edificio. Generalmente, un file Excel viene creato da Scope per separare correttamente l'apparecchiatura. È possibile organizzare l'attrezzatura sotto forma di gerarchia separando i sottoscopi con il carattere >. Questa organizzazione è particolarmente utile se l'edificio dispone di molte attrezzature e si vuole organizzare meglio la lista delle attrezzature nella sua applicazione. (Esempio: Il mio edificio > sala principale).
• Famiglia * : La famiglia di equipaggiamenti rappresenta il tipo. Corrisponde a un cognome precedentemente creato come foglio Excel. (Esempio: Sensore di temperatura).
• Nome dell'attrezzatura * : Il nome dell'apparecchiatura che sarà visualizzata nell'interfaccia. (Esempio: Sensore di Stanza).
• Riferimento dell'equipaggiamento * : L'identificativo unico dell'azienda delle nostre attrezzature. Fai attenzione, questo sarà usato come chiave per qualsiasi futura modifica nel nostro ambiente. Non è possibile modificare questo riferimento nel file Excel; se un riferimento viene modificato, sarà considerato come nuovo apparecchiatura. La corda {REFERENCE} nella definizione di una variabile di una famiglia sarà automaticamente sostituita dal valore di quella colonna.
• Descrizione : Una descrizione opzionale che apparirà nella scheda dell'equipaggiamento dell'app.
• Posizione : Informazioni opzionali sulla posizione dell'attrezzatura. Apparirà nella scheda dell'equipaggiamento e viene solitamente usata per aiutare a posizionare l'attrezzatura durante la creazione della carta.
• ID di interoperabilità : Un identificatore aziendale associato all'apparecchiatura dichiarata in un altro ambiente.
• XXX : È possibile aggiungere quante più colonne possibile per descrivere le istanze. Queste colonne possono essere usate per sostituire stringhe {XXX} nella definizione di variabile.

Esempio: Creare 2 istanze di asset

Nel nostro esempio, creeremo 2 istanze di sensori di temperatura. Per farlo, aggiungeremo semplicemente 2 righe al nostro foglio Excel Istanze e riempire le colonne richieste Scope, Famille, Nom équipement e Reference équipement.

• Impostare un'istanza di un sensore di temperatura per la camera
  • Scopo: MyBuilding
  • Famiglia: Sensore di temperatura
  • Nome dell'apparecchiatura: Temperatura ambiente
  • Riferimento dell'equipaggiamento: TEMP_01
• Definizione di un'istanza di sensore di temperatura per soggiorno
  • Scopo: MyBuilding
  • Famiglia: Sensore di temperatura
  • Nome dell'attrezzatura: Temperatura del soggiorno
  • Riferimento dell'equipaggiamento: TEMP_02

Esecuzione dello script

Una volta definite le famiglie e le istanze, tutto ciò che devi fare è eseguire lo script di automazione, che unirà le definizioni delle istanze con quelle della famiglia e creerà una lista di "handle" che potranno essere importati nel back office di Immersive: Enhancer.

Il risultato della generazione si trova nella scheda "Data". Lo script ha automaticamente passato attraverso l'elenco delle istanze, ha trovato la famiglia associata. Per ogni istanza, ha esaminato la lista delle variabili definite nel foglio familiare e ha creato le variabili corrispondenti sostituendo le stringhe {REFERENCE} dal valore corrispondente.

Così finiamo con 4 maniglie in totale.

Una volta completato questo passaggio, è possibile importare l'attrezzatura dal back office immersivo come spiegato in questo tutorial: link all'importazione Excel

Specifica Aggiuntiva della Colonna

È abbastanza comune dover impostare valori specifici per le istanze. Per soddisfare questa esigenza, basta aggiungere una colonna nel file di istanza.

Immaginiamo di voler associare un numero di serie a ogni istanza, e che questo numero di serie sia visibile come una variabile di un dispositivo.

Aggiungiamo la colonna SERIAL nel foglio di istanza, e compilare i valori.

Nel foglio della famiglia Temperature Sensor, aggiungiamo una riga per definire una nuova variabile. Nella colonna Path, specifichiamo la stringa Value://{SERIAL}.

Una volta eseguito lo script, l'esportazione aggiungeva 2 variabili (1 per istanza) e sostituiva la stringa {SERIAL} dal valore corrispondente a ciascuna istanza.