Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
Italian
US English (US)
ES Spanish
IT Italian
  • Home
  • Utilizzo della piattaforma
  • Esportazione dati

Esportazione lavori: configurazione

Written by Omri Landman

Updated at May 12th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Utilizzo della piattaforma
    Rapporti Applicazioni energetiche Trigger e Centro notifiche Iniziare Esportazione dati Importazione dati Amministrazione
  • Hardware e distribuzione
    Diagrammi di flusso per la risoluzione dei problemi Guida alla distribuzione del software Schede tecniche hardware e guide di distribuzione Domande frequenti (FAQ)
  • Demo interattive
  • Legal
+ More

È possibile impostare processi di esportazione dati sul software per creare processi di esportazione automatici che inviano misurazioni del sito, dati di avviso e approfondimenti analitici ad applicazioni di terze parti, per ulteriori analisi ed elaborazioni.

Il servizio di esportazione dati supporta diverse strategie di esportazione dati, formati di file e protocolli di rete. I processi di esportazione possono essere eseguiti periodicamente nei formati CSV su SFTP, CSV su FTPS o JSON su HTTPS.

Una volta completata la configurazione, l'esportazione verrà avviata automaticamente e i dati verranno inviati all'entità di destinazione.

Per accedere ai lavori di esportazione, vai alla Dashboard del tuo account e clicca su Esportazione automatica .

Una volta nelle Impostazioni Account, seleziona Esporta Job . Nota che utilizzando i tre puntini a destra di un job di esportazione esistente, puoi abilitare o disabilitare il job.

Crea un nuovo processo di esportazione

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.

  1. Inserisci un Nome lavoro e poi nel campo Stato lavoro puoi attivare o disattivare il lavoro, a seconda dello stato del lavoro.
  2. 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.

  1. 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 ).
  2. 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.
  3. 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.

  1. 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.

  1. Il campo Metodo HTTPS avrà tre opzioni: POST , PUT e POST (Multipart) .
  2. 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.

Esportazione lavori: interfaccia catalogo

Metadati - Catalogo

Esporta lavori: Interfaccia di misurazione

Misure

Esportazione lavori: Interfaccia di misurazione Pan-42

Misurazioni Pan-42

Esportazione lavori: Interfaccia di misurazione del misuratore di impulsi

Misurazioni del misuratore di impulsi

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Esportazione lavori: interfaccia catalogo
  • Esporta lavori: Interfaccia di misurazione
  • Esportazione lavori: Interfaccia di misurazione Pan-42
  • Esportazione lavori: Interfaccia di misurazione del misuratore di impulsi
  • Elenco di controllo per la connessione al server SFTP e FTP
Expand