In questo articolo imparerai come funziona il gateway CSV multicolonna, disponibile sulla piattaforma EMS.
Contenuti di questo articolo:
- Che cos'è un gateway multicolonna?
- Registrare un gateway CSV multicolonna nella piattaforma EMS
- Preparazione di un file CSV multicolonna
- Esempio
Che cos'è un gateway CSV multicolonna?
Il gateway CSV multicolonna consente di inserire i dati nella piattaforma utilizzando file in formato CSV multicolonna, organizzando i dati di ogni giorno in colonne. Questo gateway consente di adattare e mappare i file di dati multicolonna in modo personalizzato, come spiegato qui. Questi file possono essere inseriti tramite il gateway CSV multicolonna via e-mail, FTP o SFTP.
Registrare un gateway CSV multicolonna in EMS
Per registrare questo gateway, segui questi passaggi e seleziona il gateway CSV multicolonna (FTP o e-mail).
Nelle impostazioni del gateway, scegli un nome e seleziona il fuso orario. I gateway multicolonna FTP e e-mail mostreranno al loro interno i dettagli di connessione, che funzionano esattamente come i rispettivi gateway generici FTP e e-mail. Utilizza i dettagli di connessione elencati per inviare i tuoi dati.
Nella Configurazione del gateway, compila i seguenti campi:
- Nome: scegli il nome del gateway.
- Fuso orario: seleziona il fuso orario corrispondente.
- Modalità di inserimento: Discreta o Cumulata. Maggiori informazioni in questa sezione.
- Formato della data: Locale o UTC.
- Colonna della data: indica il carattere della colonna del file CSV in cui è indicata la data, ovvero il giorno.
- Colonna del contatore: indica il carattere della colonna del file CSV in cui è indicato il nome del contatore.
-
Colonna delle unità o del parametro: indica il carattere della colonna del file CSV in cui è indicato l'ID del parametro. Se non disponi di una colonna con i parametri, seleziona "Nessuno" e in Parametro predefinito seleziona il parametro desiderato, ad esempio Energia attiva (402), Energia gas (420) o Acqua (901), e altri ancora! Maggiori informazioni sugli ID dei parametri qui.
- Tieni presente che selezionando Gas la piattaforma utilizzerà il parametro Energia gas (420).
- Prima colonna dei dati: indica il carattere della colonna del file CSV in cui iniziano i dati.
- Prima riga dei dati: indica il numero della riga della colonna del file CSV in cui iniziano i dati.
Nota: se selezioni "Nessuno" nel campo Parametro predefinito, la nostra piattaforma selezionerà Energia attiva (402) per impostazione predefinita. Assicurati quindi di selezionare il parametro desiderato.
Scopri come configurare il file CSV in questa sezione con un esempio.
Inserimento dei dati tramite un gateway CSV multicolonna
Modalità di inserimento
Sono disponibili 3 modalità:
- Valori di tipo intervallo temporale (dati discreti): in questa modalità, il gateway inserirà il consumo per ogni periodo così come elencato nel file CSV inviato.*
- Valori di tipo intervallo temporale: in questa modalità, il gateway accumulerà i dati di consumo per ogni giorno e inserirà nella piattaforma la lettura accumulata, assumendo che venga reimpostata su 0 ogni giorno alle 00:00. (es.: consumo elettrico ogni 15 minuti, consumo idrico ogni 30 minuti).
-
Valori istantanei/cumulati: per i dati importati con valori cumulati (es.: consumo elettrico ogni 15 minuti aggiunto nel tempo e inserito in questo modo).
I parametri con tipo di natura "istantaneo" (come temperatura, potenza, ecc.) verranno inseriti solo nella modalità di inserimento "valori istantanei/cumulati, inserisci così come sono"
* Nota:
Se invii dati orari con la modalità di inserimento Discreta, il gateway calcolerà e inserirà i valori con una frequenza di 30 minuti, dividendo per 2 il valore orario.
Esempio: immagina di avere un valore orario di 10 kWh alle 01:00, il che significa che il tuo consumo tra le 01:00 e le 02:00 è di 10 kWh. Il parser CSV multicolonna dividerà questo valore per 2 (interpolandolo) e lo inserirà in DEXMA:
- 5 kWh alle 01:30
- 5 kWh alle 02:00
Questo processo viene eseguito per consentirti di assegnare il costo ai tuoi dispositivi, poiché è richiesta una frequenza di 30 minuti.
Da tenere a mente
Preparare un file CSV multicolonna
Formato del file
Il file deve essere in formato CSV con valori separati da virgole.
Frequenze disponibili
Il gateway accetta file contenenti dati ogni 15 minuti, 30 minuti o ogni ora, pertanto saranno necessarie esattamente 24, 48 o 96 colonne rispettivamente per le letture.
Campi del file
Il file deve contenere i seguenti campi affinché le informazioni CSV corrispondano alla configurazione del gateway.
- Nome del contatore: indica i nomi dei contatori in una colonna.
- Data: indica la data, nel formato G/M/A, del giorno a cui corrispondono i dati di ogni riga. (Es.: 21/02/2021 o 21/02/21).
- Identificatore del parametro: indica la chiave o l'identificatore del parametro dei dati che stai inserendo. Scopri come indicare il parametro qui.
- Righe e colonne dei dati: le letture dei dati di ogni giorno vengono aggiunte per riga. Ciò significa che un giorno di dati corrisponde a una riga. In questa riga devi indicare in tre colonne il nome del contatore, l'identificatore del parametro e la data. I dati occuperanno le successive 24, 48 o 96 colonne, a seconda della frequenza dei dati. Il formato dei dati deve essere un numero con separatore decimale "." o ",".
Specifiche dei parametri
Esistono diverse opzioni per indicare il parametro inserito. Innanzitutto, per inserire qualsiasi tipo di parametro disponibile sulla piattaforma devi indicarne l'identificatore (ID), disponibile in questo elenco.
L'indicazione dell'ID del parametro dell'energia attiva è facoltativa. Se non utilizzi alcuna colonna per indicarlo nella configurazione del CSV, devi indicare l'opzione Nessuno nell'opzione Colonna delle unità o dei parametri nella configurazione del gateway.
Nel caso in cui il parametro da inserire sia l'energia reattiva o l'energia reattiva capacitiva, come ID del parametro possono essere utilizzate anche le seguenti chiavi:
- LAG: Energia reattiva (parametro 404)
- LEAD: Energia reattiva capacitiva (parametro 408)
Esempio
Ecco un esempio per illustrare come configurare il gateway a partire dal file CSV. Qui puoi vedere un esempio di file CSV:
Nel file di esempio:
- Nome del contatore: colonna A (contatore 1, contatore 2)
- Data: colonna C (01/11/2020...)
- Identificatore del parametro: colonna B (402, energia attiva)
- Prima colonna dei dati: colonna D
- Prima riga contenente dati: riga 2
Il numero di colonne contenenti dati è 24, pertanto la frequenza dei dati è oraria.