Dal template di un dispositivo al template di una dashboard

Per poter creare un template di una dashboard è necessario inserire nei widget almeno un template di un segnale, è quindi fondamentale la creazione di un template di un dispositivo.

 


 

1. Creazione del template di un dispositivo

Per la creazione del template di un dispositivo:

    • Selezionare il tipo di dispositivo Template Device;
    • Impostare a piacere gli altri campi del riquadro Informazioni;
    • Nel riquadro Template Device selezionare il Tipo dispositivo MQTT;
    • Aggiungere dei segnali al template, nell'esempio sono stati aggiunti tre segnali template_signal_1template_signal_2template_signal_3;
    • Impostare un progetto, nell'esempio viene utilizzato Tutorial;
    • Impostare i topic di pubblicazione dati e ricezione informazioni, nell'esempio Data e Info;
    • Dopo aver compilato tutti i campi la situazione dovrebbe rispecchiare quella dell'immagine seguente:

 


 

2. Configurazione del client MQTT

Per poter trasmettere dati al template dispositivo utilizziamo un client MQTT (MQTT.fx). Aggiungere un nuovo profilo di connessione DATABOOM e configurarlo come nell'immagine:

  • Selezionare il Profile Type MQTT Broker;
  • Impostare come Broker Address mqtt.databoom.com;
  • Impostare come Broker Port 1883;
  • Come Client ID utilizzare il campo ClientId visualizzato nel template creato. Il <valore unico arbitraro> può essere impostato a piacere dall'utente, verrà utilizzato per formare il token del dispositivo generato. Nell'esempio utilizziamo device_from_template, il Client ID totale sarà quindi V9Gg-device_from_template (V9Gg rappresenta l'ambito utente);
  • Nella sezione User Credentials inserire il proprio username e un OAuth token con permessi di Creazione e Pubblicazione, generato nella sezione Credenziali accessibile dal menù laterale Impostazioni in Databoom.

 


 

3. Trasmettere ad un template/Generazione dispositivo

Una volta creato il template e configurato il client MQTT, è possibile trasmettere dati al template, generando quindi un dispositivo vero e proprio. Il dispositvo potrà essere utilizzato successivamente per popolare il template della dashboard con i suoi segnali.

  • Nella finestra di pubblicazione inserire il topic visualizzato nel template del dispositivo, andando a sostituire il <valore unico arbitrario>, Tutorial/device_from_template/Data;
  • Dalla visualizzazione del template del dispositivo, copiare i token dei tre segnali template_signal_1template_signal_2template_signal_3 cliccando sull'icona di copia nelle etichette corrispondenti;
  • E' quindi possibile inserire il payload da pubblicare sul topic:
    {
        "type": "data",
        "message":  [
          {
            "template": "0jlr635hvf",
            "date": "2018-06-19T09:10:00.000Z",
            "signals": [
              {
                "name": "0zvugh9ssb",
                "value": 1
              },
              {
                "name": "0xq3x1r9ld",
                "value": 2
              },
              {
                "name": "0wyc5yxscn",
                "value": 3
              }
            ]
          }
        ]
    }
    Assicurarsi di impostare il token del template al campo template, nell'esempio 0jlr635hvf, e i token dei segnali nei rispettivi campi name (nell'esempio 0zvugh9ssb, 0xq3x1r9ld e 0wyc5yxscn).

  • Dopo la pubblicazione, il dispositivo sarà visualizzabile in Databoom. Come descrizione viene utilizzato il token del template seguito dal <valore unico arbitrario> impostato, nell'esempio 0jlr635hvf-device_from_template.

 


 

4. Trasmettere valori dei segnali

Una volta generato il dispositivo è possibile trasmettere i valori dei segnali:

  • continuando a pubblicare il payload del passaggio precedente, passando quindi per il template;
  • comunicare direttamente con il dispositivo generato, in tal caso è necessario cambiare la configurazione del client MQTT, aggiornando il Client ID al valore  V9Gg-0jlr635hvf-device_from_template, così come il topic per la pubblicazione sarà Tutorial/0jlr635hvf-device_from_template/Data. Il payload sarà invece
    {
        "type": "data",
        "message": 
          {
            "device": "0jlr635hvf-device_from_template",
            "date": "2018-06-19T09:11:00.000Z",
            "signals": [
              {
                "name": "0zvugh9ssb",
                "value": 1
              },
              {
                "name": "0xq3x1r9ld",
                "value": 2
              },
              {
                "name": "0wyc5yxscn",
                "value": 3
              }
            ]
          }    
    }

 


 

5. Creazione di una dashboard come modello per il template

Per poter creare un template di una dashboard è necessario creare una dashboard che contenga i segnali di un dispositivo generato da un template, che potranno quindi essere sostituiti con segnali di altri dispositivi generati dallo stesso template.

Nella dashboard di esempio template_signals sono stati inseriti dei widget rappresentanti i segnali template_signal_1template_signal_2template_signal_3 del dispositivo generato da template 0jlr635hvf-device_from_template.

 


 

6. Creazione del template di una dashboard

Per generare il template è sufficiente cliccare il pulsante + all'interno del Dashboard Manager in corrispondenza della dashboard creata nel passaggio precedente. Confermando la modale, il template verrà visualizzato nell'elenco apposito.

 


 

7. Associare il template dashboard ad un template dispositivo

Il template di dashboard appena creato può essere associato direttamente al template dispositivo. In questo caso è sufficiente accedere alla pagina di modifica del template dispositivo e selezionare il template della dashboard nel campo Template dashboard.

In questo modo alla successiva generazione di altri dispositivi, le dashboard verranno generate automaticamente senza intervento da parte dell'utente.

 


 

8. Generazione altri dispositivi

Generiamo altri due dispositivi, al fine di avere più corrispondenze nella sostituzione dei segnali da applicare al template nella generazione manuale del punto seguente.

Si ripetino i passaggi 2 e 3 per creare i due dispositivi aggiuntivi 0jlr635hvf-device_from_template_bis e 0jlr635hvf-device_from_template_tris, prestando quindi attenzione a:

  • utilizzare rispettivamente V9Gg-device_from_template_bis e V9Gg-device_from_template_tris nella configurazione dei client MQTT;
  • utilizzare i topic dati con i token dei nuovi dispositivi, rispettivamente Tutorial/device_from_template_bis/Data Tutorial/device_from_template_tris/Data.

Nel caso sia stata specificata il Template dashboard nel template di dispositivo, la dashboard viene generata automaticamente senza intervento da parte dell'utente. E' altrimenti possibile attualizzare il template della dashboard con la procedura manuale del capitolo seguente.

 


 

9. Generazione manuale dashboard da template

Per creare una dashboard a partire da un template, cliccare il pulsante + nella riga corrispondente. Si aprirà una modale contenente una tabella:

  • la prima colonna contiene le descrizioni dei widget con le dashboard di appartenenza (per distinguere i widget nel caso il template avesse anche dashboard figlie);
  • la seconda colonna elenca i template di segnali (segnali di un dispositivo generato da un template, vedi quarto step del paragrafo 1) presenti nei widget, con dei selettori per scegliere con quali segnali sostituirli. I segnali possono essere sostituiti con segnali di altri dispositivi generati dallo stesso template.

Per poter procedere è necessario effettuare la selezione per tutti i segnali e aggiungere un suffisso nell'intestazione della modale, che andrà a costituire il nome della dashboard generata in aggiunta al nome del template.

La dashboard generata avrà la stessa struttura del template con i segnali sostituiti da quelli selezionati, nell'immagine si possono notare i segnali del dispositivo device_from_template_bis.

Altre domande? Invia una richiesta

0 Commenti

Accedi per aggiungere un commento.