Esportazione lavori: configurazione
Una volta aperta la schermata Esporta lavori , puoi modificare un lavoro esistente selezionandone uno dall'elenco oppure crearne uno nuovo cliccando su Crea nuovo lavoro di esportazione nella parte inferiore della schermata.

- Inserisci un Nome lavoro e poi nel campo Stato lavoro puoi attivare o disattivare il lavoro, a seconda dello stato del lavoro.
- Nel campo Categoria lavoro , seleziona una delle seguenti opzioni descritte di seguito:
- Catalogo - metadati che descrivono i dati utente e la topologia della rete elettrica
- Misurazioni : letture del livello del dispositivo misurate dai sensori Panoramic Power.
- Misurazioni del misuratore di impulsi – Letture del misuratore di impulsi misurate tramite logger o Bridge
- Misurazioni PAN-42 - letture effettive dei contatori PAN-42
Nota: un esempio di ogni tipo verrà mostrato a destra.
Nota: quando si seleziona Misurazioni, Misurazioni con misuratore di impulsi o Misurazioni PAN-42 , viene visualizzato un campo aggiuntivo, Risoluzione punti di misura , con opzioni di 30 minuti o 1 ora (a meno che non si selezioni l'opzione oraria, in tal caso è disponibile solo 1 ora) . Le opzioni di risoluzione punti disponibili dipendono dalla Frequenza di esecuzione del processo e dal Formato e trasporto selezionati.
- Nella sezione Siti è possibile selezionare i processi che elaborano i dati per l'intero account (opzione Tutti ) oppure scegliere da un elenco di siti selezionati nell'account (opzione Specifici ).
- Sono disponibili due versioni (solo per il tipo di lavoro Catalogo ):
- V1.0 : Inclusione dei dati dei siti e dei dispositivi in un sito specifico.
- V1.1 : Inclusi i dati a livello di account, siti e dispositivi sotto un sito specifico.
- Il campo Frequenza di esecuzione del processo può essere impostato in modo che il processo includa dati per un periodo di tempo specifico. Questo campo viene automaticamente impostato su Ogni giorno quando si seleziona Catalogo come tipo di categoria di processo. Quando si seleziona Misurazioni o come tipo di categoria di processo, il campo Frequenza di esecuzione del processo può essere impostato su Ogni giorno o Ogni ora .
Nota: se è richiesta una frequenza maggiore, ad esempio 15 minuti o 5 minuti , invia un ticket di supporto con tutti i dettagli e potremo aiutarti a soddisfare la richiesta dopo una revisione interna.
- Nel campo Formato e trasporto , è possibile eseguire periodicamente processi di esportazione in formato JSON su HTTPS, CSV su SFTP o CSV su FTPS . Queste opzioni sono descritte di seguito.
Nota: se si seleziona il formato CSV su FTP o CSV su SFTP , è necessario inviare un ticket di supporto per richiedere la creazione delle credenziali per l'account. Inserire le credenziali nei campi Nome utente e Password una volta ricevute. Le credenziali per FTP sono identiche a quelle per SFTP .
JSON su HTTPs
Selezionando l'opzione JSON su HTTPS si configura un processo di esportazione che formatta i dati raccolti come file JSON. I dati vengono quindi inviati tramite REST (HTTP/s) a un URL impostato.
- Il campo Metodo HTTPS avrà tre opzioni: POST , PUT e POST (Multipart) .
- Nel campo URL HTTPS puoi specificare l'URL del tuo servizio REST.
Nota : per ricevere correttamente i dati, è necessario impostare il limite della dimensione del payload su almeno 1 MB sul server HTTP
Dopo aver ricevuto correttamente i dati JSON tramite REST, il programma dovrebbe restituire lo stato HTTP 200 OK. Se lo stato HTTP 200 OK non viene ricevuto e viene restituito un codice di errore (errore HTTP 400, 500) o in caso di timeout, i dati del job verranno aggiunti all'esecuzione del job successivo. Il job di esportazione inizierà la modalità di ripetizione dei tentativi e riproverà ogni 5 minuti per 1 ora e 15 minuti consecutivi, indipendentemente dalla frequenza configurata per il job di esportazione. Se il job di esportazione non viene consegnato correttamente entro tale periodo, verrà automaticamente disabilitato dal sistema. Se il job di esportazione è stato consegnato correttamente entro tale periodo, il sistema invierà quindi ogni minuto ogni iterazione persa durante la modalità di ripetizione dei tentativi, fino al recupero.
Per esempio
- Se la frequenza di esecuzione del lavoro è di 15 minuti, il lavoro delle 10:15 conterrà tutte le misurazioni effettuate tra le 10:00 e le 10:15.
- Se il tentativo fallisce, verrà effettuato un altro tentativo alle 10:20.
- L'esecuzione del lavoro delle 10:20 conterrà tutte le misurazioni tra le 10:00 e le 10:15
- Ciò continuerà ogni 5 minuti finché non verrà ricevuto lo stato HTTP 200 OK.
- Se il lavoro ha esito positivo alle 11:00, i dati tra le 10:15 e le 10:30 verranno inviati alle 11:01, i dati tra le 10:30 e le 10:45 verranno inviati alle 11:02 e i dati tra le 10:45 e le 11:00 verranno inviati alle 11:03
- La prossima iterazione sarà alle 11:15
I file JSON sono limitati a 2.000 misurazioni (se è abilitato il padding con zeri, la dimensione del file potrebbe aumentare). Se il processo include più di 2.000 misurazioni, queste verranno suddivise in più transazioni consecutive. È previsto uno stato HTTP 200 OK per transazione.
Gli indirizzi IP da inserire nella whitelist per consentire l'uscita dei file JSON su HTTPS sono 34.237.64.143 e 54.205.225.22
CSV su SFTP o FTP
Selezionando il campo CSV su SFTP si configura un processo di esportazione per inviare i dati in formato CSV a una directory predefinita situata nel servizio SFTP del software e specificata nel campo Directory di output SFTP.
Ti verrà richiesto di inserire il nome utente e la password SFTP ricevuti via e-mail dal nostro team di assistenza professionale, per consentire al lavoro di inviare il suo output alla posizione desiderata.
Nota: se disponi delle credenziali per i tipi di lavoro di esportazione CSV su SFTP, si tratta delle stesse credenziali che utilizzeresti per il tipo di lavoro di esportazione CSV su SFTP, quindi non è necessario richiedere nuovamente le credenziali in questi casi.
Il servizio SFTP è gestito da AWS. Si tratta di un servizio resiliente e sicuro.
Per iniziare a utilizzare il servizio SFTP, aggiungere una regola firewall per le connessioni in uscita per l'intervallo di porte 8192-8200. I server FTP per Transfer Family operano sulla porta 22 (canale di controllo) e sull'intervallo di porte 8192-8200 (canale dati).
Il servizio SFTP AWS supporta la modalità binaria (il tipo di dati ASCII non è supportato).
Per capire come impostare il tuo account SFTP, leggi la nostra guida rapida alla connessione al server FTP allegata di seguito (l'unico dettaglio modificato è il canale di controllo, ovvero la porta 22).
Guida rapida alla connessione al server FTP - Documento del prodotto - GB.pdf
SFTP vs. FTP
Per comprendere le differenze tra SFTP e FTP, consultare la tabella seguente:
Parametro | Protocollo di trasferimento file Secure Shell (SFTP) | Protocollo di trasferimento file sicuro (FTPS) |
Approccio alla comunicazione di rete | SFTP si basa sul protocollo Secure Shell (SSH) e aggiunge funzionalità di trasferimento file. | FTPS si basa sul protocollo di trasferimento file (FTP) e aggiunge un livello di sicurezza e crittografia. |
Supporto firewall | Utilizza una singola connessione attraverso una sola porta, semplificando l'installazione di soluzioni firewall. | Richiede una connessione dati secondaria e l'utilizzo di più porte rende difficile il funzionamento dei firewall. |
Velocità di trasferimento | Comporta un elevato sovraccarico di risorse e rallenta la distribuzione dei file. | È semplice, diretto e snello, il che lo rende molto più veloce. |
Binario e ASCII | Supporta solo la trasmissione binaria e gli utenti non possono scegliere tra diverse modalità. | Supporta sia le trasmissioni binarie che ASCII, semplificando la gestione dei registri. |
Compatibilità .NET | Gli sviluppatori non possono creare programmi .NET con funzionalità SFTP, poiché manca la compatibilità. | .NET include numerosi comandi per supportare il caricamento di file in modalità FTPS. |
Meccanismo di autenticazione | Utilizza l'autenticazione out-of-band e non necessita di certificati firmati, poiché i dati sono intrinsecamente crittografati. | Il server FTP deve obbligatoriamente fornire un certificato a chiave pubblica per approvare l'autenticazione. |
Comandi di utilizzo | Supporta un lungo elenco di comandi con controlli granulari, come la definizione dei permessi dei file. | Supporta un elenco di comandi relativamente limitato, con meno controllo su file e directory remoti. |
Adozione | È ampiamente adottato e la maggior parte dei server e delle soluzioni di archiviazione cloud supportano SFTP. | È basato su FTP, che sta gradualmente venendo sostituito da HTTPS e altri protocolli. |