Formato file delle pubblicazioni
Presentazione
Il formato dei file pubblicati dipende dalla scelta del metodo di pubblicazione:
-
Servizi cloud Schneider: formato file json
-
SFTP e HTTPS: selezionare il formato di file json o csv nelle pagine Web di Panel Server
Formato di file della pubblicazione CSV
Un file .csv contiene:
-
Dati relativi a un singolo dispositivo a valle
-
Tutte le misurazioni configurate con lo stesso periodo di campionamento per tale dispositivo
-
Dati relativi a un massimo di 24 ore di campionamento
Il nome dei file CSV esportati segue la convenzione di denominazione ReducedID_DeviceName_DateTime_IndexNumber.csv dove:
-
ReducedID
è l'identificativo interno del dispositivo, che garantisce che i file prodotti siano univoci per i dispositivi che condividerebbero lo stesso nome (ad esempio, 10_mb, 21_zd). -
DeviceName è il nome assegnato al dispositivo a valle.
-
DateTime è il timestamp corrispondente alla data di pubblicazione del file, espresso in millisecondi nel formato AAAAMMGGhmmssSSS.
-
IndexNumber nel formato _<nn> indica il numero del file nel numero totale di file per una singola pubblicazione (stesso ID, stesso nome dispositivo e stesso timestamp). Se nella pubblicazione sono presenti 20 file, essi verranno numerati da _1 a _20.
-
Nel nome file .csv sono consentiti solo i caratteri seguenti: UTF-8 e ASCII di base (da 32 a 7F, escluso \ / : * ? " < > |). Tutti i caratteri non supportati verranno sostituiti da ~.
Esempio: si consideri il seguente nome di
file:
11_mb_F160 3P 3P+N_202412161020_19.csv dove:
-
ReducedID è 11_mb.
-
DeviceName è F160 3P 3P+N, nome del dispositivo.
NOTA: Questo nome è il valore predefinito (modello prodotto) se l'utente non lo ha aggiornato. -
DateTime è 202412161020, il che significa che il fascicolo è stato pubblicato il 16 dicembre 2024 alle 10:20.
-
IndexNumber è _19, ossia il file è il 19° file della pubblicazione.
Il contenuto del file .csv supporta solo la codifica caratteri standard UTF-8 per nome dispositivo, nome evento, nome misura e nome file.
Le virgolette presenti in tutti i campi dati del file .csv garantiscono la compatibilità con i caratteri speciali.
Per informazioni ed esempi del file .csv, vedere Appendice D Formati dei file di pubblicazione SFTP e HTTPS.
Formato file della pubblicazione JSON
Un file .json contiene le misurazioni di più dispositivi a valle configurati con lo stesso periodo di campionamento.
Ogni file contiene i dati di 24 ore di campionamento, fino a un limite di 256 KB di dati.
Il nome del file JSON esportato segue la convenzione di denominazione DateTime_IndexNumber.json dove:
-
DateTime è il timestamp corrispondente alla data di pubblicazione del file, espresso in millisecondi nel formato AAAAMMGGhmmssSSS.
-
IndexNumber nel formato _<nn> indica il numero del file nel numero totale di file per una singola pubblicazione (stesso ID, stesso nome dispositivo e stesso timestamp). Se nella pubblicazione sono presenti 20 file, essi verranno numerati da _1 a _20.
Per un esempio di file .json, vedere Appendice D Formati dei file di pubblicazione SFTP e HTTPS.