Passarel·la CSV multicolumna

En aquest article aprendràs com funciona la passarel·la CSV multicolumna, disponible a la plataforma EMS.

Contingut d’aquest article: 

• Què és una passarel·la multicolumna?
• Registrar una passarel·la CSV multicolumna a la plataforma EMS
  • Inserir dades mitjançant una passarel·la CSV multicolumna
• Preparar un fitxer CSV multicolumna
  • Format del fitxer
  • Especificació dels paràmetres
• Exemple

Què és una passarel·la CSV multicolumna?

La passarel·la CSV multicolumna permet inserir dades a la plataforma mitjançant fitxers en format CSV multicolumna, organitzant les dades de cada dia en columnes. Aquesta passarel·la permet adaptar i mapar els fitxers de dades multicolumna de manera personalitzada, tal com s’explica aquí. Aquests fitxers es poden inserir mitjançant la passarel·la CSV multicolumna a través del correu electrònic, FTP o SFTP. 

Registrar una passarel·la CSV multicolumna a l’EMS

Per registrar aquesta passarel·la, segueix aquests passos i selecciona la passarel·la CSV multicolumna (FTP o correu electrònic).
 

Un cop a la configuració de la passarel·la, tria un nom i selecciona la teva zona horària. Tant les passarel·les multicolumna FTP com les de correu electrònic hi mostraran els detalls de connexió, que funcionen igual que les seves passarel·les genèriques FTP i de correu electrònic. Utilitza els detalls de connexió indicats per enviar les teves dades.

Un cop a la configuració de la passarel·la, omple els camps següents:

• Nom: tria el nom de la passarel·la.
• Zona horària: selecciona la zona horària corresponent.
• Mode d’inserció: Discret o acumulat. Més informació en aquesta secció.
• Format de data: local o UTC.
• Columna de data: indica el caràcter de la columna del fitxer csv on s’indica la data, el dia.
• Columna del comptador: indica el caràcter de la columna del fitxer csv on s’indica el nom del comptador.

• Columna d’unitats o paràmetres: indica el caràcter de la columna del fitxer csv on s’indica l’ID del paràmetre. Si no tens cap columna amb els paràmetres, selecciona «None» i, a Paràmetre predeterminat, selecciona el paràmetre desitjat, com ara Active Energy (402), Gas Energy (420) o Water (901), i se n’afegiran més! Més informació sobre els ID dels paràmetres aquí. 

  - Tingues en compte que seleccionar Gas farà que la plataforma utilitzi el paràmetre Gas Energy (420).

  
  
                        
   

• Primera columna de dades: indica el caràcter de la columna del fitxer csv on comencen les dades. 
• Primera fila de dades: indica el número de la fila de la columna del fitxer csv on comencen les dades.

Nota:  Si selecciones «None» al camp Paràmetre predeterminat, la nostra plataforma seleccionarà Active Energy (402) per defecte. Per tant, assegura’t de seleccionar el paràmetre desitjat. 

Aprèn a configurar el fitxer CSV en aquesta secció amb un exemple. 

Inserir dades mitjançant una passarel·la CSV multicolumna

Mode d’inserció

Hi ha 3 modes disponibles per seleccionar:

• Valors de tipus interval de temps (dades discretes): en aquest mode, la passarel·la inserirà el consum de cada període tal com apareix al fitxer CSV enviat.*
• Valors de tipus interval de temps: en aquest mode, la passarel·la acumularà les dades de consum de cada dia i inserirà la lectura acumulada a la plataforma, assumint que es reinicia a 0 cada dia a les 00:00. (p. ex.: consum elèctric de 15 min, consum d’aigua de 30 min).
• Valors instantanis/acumulats: per a dades importades amb valors acumulats (p. ex.: consum elèctric de 15 min acumulat al llarg del temps i inserit d’aquesta manera). 
  
  Els paràmetres amb el tipus de naturalesa «instantani» (com ara la temperatura, la potència, etc.) només s’inseriran en el mode d’inserció «valors instantanis/acumulats, inserir com a tals».
  
                 

* Nota:

Si envies dades horàries amb el mode d’inserció discreta, la passarel·la calcularà i inserirà els valors amb una freqüència de 30 min dividint el valor horari per 2.

Exemple: Imagina que tens un valor horari de 10 kWh a la 01:00, cosa que significa que el teu consum entre la 01:00 i les 02:00 és de 10 kWh. L’analitzador CSV multicolumna dividirà aquest valor per 2 (l’interpolarà) i l’inserirà a DEXMA:
- 5 kWh a la 01:30
- 5 kWh a les 02:00

Aquest procés es realitza perquè puguis assignar costos als teus dispositius, ja que cal una freqüència de 30 min.

Cal tenir en compte

Preparar un fitxer CSV multicolumna 

Format del fitxer

El fitxer ha de tenir el format CSV separat per comes.

Freqüències disponibles

La passarel·la accepta fitxers que tinguin dades cada 15 min, 30 min o cada hora, per la qual cosa necessitarà exactament 24, 48 o 96 columnes per a les lectures, respectivament.

Camps del fitxer

El fitxer ha de contenir els camps següents perquè la informació CSV correspongui a la configuració de la passarel·la.

• Nom del comptador: indica els noms dels comptadors en una columna.
• Data: indica la data, en format D/M/Y, del dia a què corresponen les dades de cada fila. (Ex.: 21/02/2021 o 21/02/21).
• Identificador del paràmetre: indica la clau o l’identificador del paràmetre de les dades que estàs inserint. Aprèn a indicar el paràmetre aquí.
• Files i columnes de dades: les lectures de dades de cada dia s’afegeixen per fila. És a dir, un dia de dades correspon a una fila. En aquesta fila, has d’indicar en tres de les columnes el nom del comptador, l’identificador del paràmetre i la data. Les dades ocuparan les 24, 48 o 96 columnes següents, segons la freqüència de les dades. El format de les dades ha de ser un número amb un separador decimal «.» o «,».

Especificació dels paràmetres

Exemple

Aquí tens un exemple per il·lustrar com configurar la passarel·la a partir del fitxer CSV. Aquí pots veure un exemple de fitxer CSV: