--- title: "Esportazioni automatiche" description: "Esporta dati dispositivi, log di accesso e report da TapHome in Google Sheets ed Excel. Supporto CSV, JSON, XLSX e XML." url: "https://taphome.com/it/docs/exports/" language: it lastmod: 2026-11-01 generator: hugo ai: topics: ["automated-exports","data-export","device-statistics","access-log","attendance-tracking","google-sheets","microsoft-excel"] questions: ["Come esportare i dati dei dispositivi da TapHome a Google Sheets?","Quali formati di esportazione supporta TapHome?","Qual è il numero massimo di righe in un'esportazione TapHome?","Come configurare l'esportazione delle presenze in TapHome?","Come configurare l'esportazione del registro accessi?","Le statistiche possono essere ricalcolate se erano disattivate?","Quali intervalli di campionamento sono disponibili per l'esportazione dei valori dei dispositivi?"] --- # Esportazioni automatiche Ultimo aggiornamento: 2026-11-01 > [!NOTE] > 🚀 **Disponibile** — Core 2025.2 o più recente. Gli export automatici permettono la raccolta automatica dei dati e la generazione di report dal tuo sistema TapHome. Questa funzionalità salva tutti i parametri dell'export e ti permette di: - Impostare il caricamento automatico dei dati in Google Sheets e Microsoft Excel (o altri strumenti) - Scaricare manualmente dall'applicazione report predefiniti per l'ultimo periodo - Scaricare manualmente report personalizzati per intervalli di tempo selezionati I dati sono conservati in un archivio cloud su `https://data.taphome.com/api/export/profile//` e sono disponibili nei formati CSV, JSON, XLSX o XML. ### Tipi di export Gli export automatici supportano tre diversi tipi di dati: ### [Valori dei dispositivi](https://taphome.com/it/docs/exports/#hodnoty-zariadeni) Esportazione dei valori dei sensori, degli stati dei dispositivi e delle statistiche calcolate (temperatura, consumo energetico, ecc.) ### [Registro accessi](https://taphome.com/it/docs/exports/#pristupovy-system) Registro cronologico degli eventi del sistema di accesso (chi, quando, quale lettore, consentito/rifiutato, motivo) ### [Presenze](https://taphome.com/it/docs/exports/#dochadzka) Report di presenze preformattati basati sui dati del sistema di accesso, che mostrano gli orari di ingresso/uscita e le ore lavorate ### Valori dei dispositivi Esportazione dei valori dei sensori, degli stati dei dispositivi e delle statistiche calcolate (temperatura, consumo energetico, ecc.). Questo è il tipo di export più comunemente utilizzato. #### Come funziona #### 1. **Origini dati (Colonne)** Specifica da quali dispositivi e quali valori desideri esportare: - Dispositivo: es. termostato, sensore di temperatura - Tipo di valore: es. temperatura impostata, temperatura attuale - Funzione di aggregazione: **Media**, **Minimo**, **Massimo**; per i contatori **Somma/Integrale** (energia per riga) al posto della media > [!NOTE] > Le statistiche vengono calcolate e salvate periodicamente per ogni dispositivo. Disattivarle impedirà la generazione di un export completo, poiché i dati storici non possono essere ricalcolati retroattivamente. #### 2. **Intervallo di campionamento (righe)** Definisce con quale frequenza i dati vengono registrati. Ogni riga nell'export rappresenta un intervallo di campionamento. Intervalli disponibili: 5 minuti, 10 minuti, 15 minuti, 30 minuti, 1 ora, 12 ore, 1 giorno, 1 settimana, 1 mese, 1 trimestre (3 mesi), 1 anno. Esempio: con un intervallo di 1 ora l'export conterrà una riga per ogni ora. #### 3. **Intervallo di esportazione** Definisce quante righe di dati verranno generate in ogni export (quanti dati storici). > [!TIP] > Se imposti: > - Intervallo esportazione: 3 giorni > - Intervallo campionamento: 1 ora > > L'export conterrà: **72 righe** (3 giorni × 24 ore = 72 righe) #### 4. **Aggiornamento dati in tempo reale** Imposta quando verranno generati nuovi dati. - **Ogni giorno**: ad es. ogni 2 giorni alle 14:30 - **Ogni settimana**: ad es. ogni 3 settimane, di lunedì alle 09:00 - **Ogni mese**: ad es. ogni mese, il giorno 15 alle 12:00 - **Ogni anno**: ad es. ogni anno, il 25/12 alle 18:00 #### Passo passo: creare un export #### Passo 1: Crea un nuovo export 1. Apri l'elenco degli export 2. Clicca su **Definisci una nuova esportazione** 3. Inserisci il **Nome** dell'export #### Passo 2: Imposta le sorgenti dati 1. Nella sezione **Origini dati (Colonne)** clicca su **Aggiungi colonna** 2. Seleziona il dispositivo (es. termostato) 3. Seleziona il tipo di valore (es. temperatura impostata) 4. Seleziona la funzione di aggregazione (**Media**, **Minimo**, **Massimo**) 5. Ripeti per tutte le colonne necessarie > [!TIP] > "Ogni riga contiene: Termostato Temperatura impostata (media 1 h), Termostato Temperatura (minimo 1 h), Sensore di luminosità Luminosità (massimo 1 h)" #### Passo 3: Imposta l'intervallo di campionamento 1. Nella sezione **Intervallo di campionamento (righe)** scegli l'intervallo 2. Consigli: > - 5–15 minuti - per dati dettagliati (export di grandi dimensioni) > - 1 ora - per uso comune > - 1 giorno/1 settimana - per tendenze a lungo termine (export di piccole dimensioni) #### Passo 4: Imposta l'intervallo di esportazione 1. Nella sezione **Intervallo di esportazione** inserisci il numero di periodi 2. Controlla il numero di righe nel riepilogo 3. Avvertenza: l'export non deve superare 100 000 righe > [!TIP] > "I dati esportati conterranno 1286 righe per un periodo di 3 giorni." #### Passo 5: Imposta l'aggiornamento automatico 1. Nella sezione **Aggiornamento dati in tempo reale** abilita l'export (**Abilitato**) 2. Imposta la frequenza di generazione (es. ogni mese, il 1° giorno alle 00:00) 3. Salva l'export #### Passo 6: Ottieni l'URL dell'export Dopo il salvataggio l'app genera automaticamente l'URL: ``` https://data.taphome.com/api/export/profile//data.csv https://data.taphome.com/api/export/profile//data.json https://data.taphome.com/api/export/profile//data.xlsx https://data.taphome.com/api/export/profile//data.xml ``` Il token viene generato automaticamente dall'app. #### Avvertenze importanti - **Attivazione delle statistiche:** Quando salvi la configurazione dell'export, il sistema attiva automaticamente tutte le statistiche necessarie per i dispositivi esportati. Queste statistiche vengono calcolate e salvate periodicamente. Nota: le statistiche non possono essere ricalcolate retroattivamente: se le disattivi, i dati storici andranno persi definitivamente. - **Connettività Internet:** L'unità di controllo può conservare i dati senza connessione Internet per alcune ore. In caso di interruzione prolungata, però, deve eliminare i dati più vecchi per evitare sovraccarichi di memoria. - **Dati critici:** Per dati critici si consiglia di utilizzare una soluzione alternativa di raccolta dati. - **Limite di righe:** Il numero massimo di righe in un export è 100 000. ### Registro accessi L'export del registro accessi genera un registro cronologico degli eventi: chi, quando, su quale lettore è stato consentito o rifiutato e il motivo. #### Cosa contiene l'export Ogni riga nell'export rappresenta un evento del sistema di accesso con i seguenti dati: - Utente - nome e cognome - Data e ora - orario preciso dell'evento - Lettore di carte - nome e posizione del lettore - Risultato - Consentito / Rifiutato - Motivo - motivo del rifiuto (se pertinente) #### Configurazione dell'export 1. Crea un nuovo export di tipo **Registro accessi** 2. Inserisci il nome dell'export: **Nome** 3. Seleziona l'intervallo temporale per l'export (ampiezza dell'export) 4. Imposta l'aggiornamento automatico (facoltativo) 5. Salva l'export e ottieni l'URL per il download L'export è disponibile nei formati CSV, JSON, XLSX o XML. ### Presenze L'export delle presenze basato sui dati del sistema di accesso genera un report chiaro che mostra quando i dipendenti sono entrati e usciti e quante ore hanno lavorato. #### Requisiti > [!WARNING] > Devi aver configurato i lettori come "in ingresso" (entrata nell'edificio) e "in uscita" (uscita dall'edificio). Deve esserci almeno un lettore di carte. > [!WARNING] > Gli utenti devono avere assegnate carte di accesso con il proprio nome. #### Configurazione dell'export 1. Crea un nuovo export di tipo **Presenze** 2. Inserisci il nome dell'export: **Nome** 3. **Lettori di carte per ingresso**:** - Seleziona i lettori che servono per l'ingresso nell'edificio (lettori di ingresso) 4. **Lettori di carte per uscita**:** - Seleziona i lettori che servono per l'uscita dall'edificio (lettori di uscita) 5. Seleziona l'intervallo temporale per l'export 6. Imposta l'aggiornamento automatico (facoltativo) 7. Salva l'export e ottieni l'URL #### Cosa contiene l'export Ogni riga rappresenta un giorno lavorativo di un dipendente: - Data - giornata lavorativa - Nome e cognome - dipendente - Primo ingresso - ora del primo ingresso nell'edificio - Ultima uscita - ora dell'ultima uscita dall'edificio - Tempo interno [hh:mm] - tempo totale trascorso all'interno dell'edificio - Tempo esterno [hh:mm] - tempo totale delle pause al di fuori dell'edificio #### Calcolo del tempo Se una carta di accesso è assegnata a un utente e l'utente è entrato nell'edificio usando un lettore in quel giorno, verrà creata una riga nella tabella. Consideriamo solo i record con accesso riuscito. - Tempo interno [hh:mm] - somma delle differenze di tempo tra ingressi e uscite. Se l'utente effettua ingressi (senza uscite) o uscite (senza ingressi) più volte di seguito, vengono considerate solo le prime. - Primo ingresso - orario del primo ingresso nell'edificio. - Ultima uscita - orario dell'ultima uscita dall'edificio. - Tempo esterno [hh:mm] - somma delle differenze tra uscite e ingressi. In condizioni standard, quando dopo l'ingresso segue l'uscita e dopo l'uscita segue (eventualmente) una coppia ingresso-uscita, vale quanto segue: `Tempo interno + Tempo esterno = Ultima uscita - Primo ingresso` #### Formato L'export è disponibile nel formato XLSX (consigliato) e contiene una tabella preformattata pronta per ulteriori elaborazioni. ### Integrazioni Tutti e tre i tipi di export (Valori dei dispositivi, Registro accessi, Presenze) possono essere integrati con Google Sheets e Microsoft Excel tramite gli URL generati dall'app. #### Google Sheets Procedura: 1. Nella finestra di dialogo **Scarica report** nell'app copia l'URL CSV 2. Apri Google Sheets 3. Incolla questa formula in una qualsiasi cella: ``` =IMPORTDATA("https://data.taphome.com/api/export/profile//data.csv") ``` 4. I dati verranno aggiornati automaticamente in background #### Microsoft Excel > [!NOTE] > Richiede Excel desktop con Power Query (non disponibile nella versione web di Microsoft 365). **XLSX (Consigliato)** Formato consigliato: XLSX Procedura: 1. Dati → Ottieni dati → Da Web 2. Inserisci l’URL: [https://data.taphome.com/api/export/profile/](https://data.taphome.com/api/export/profile/)/data.xlsx 3. Clicca OK → Chiudi e carica **CSV** Formato alternativo: CSV Procedura: 1. Dati → Ottieni dati → Da Web 2. Inserisci l’URL: [https://data.taphome.com/api/export/profile/](https://data.taphome.com/api/export/profile/)/data.csv 3. Nell’Editor di Power Query imposta il delimitatore e i tipi di dati 4. Clicca Chiudi e carica **XML** Formato alternativo: XML Procedura: 1. Dati → Ottieni dati → Da Web 2. Inserisci l’URL: [https://data.taphome.com/api/export/profile/](https://data.taphome.com/api/export/profile/)/data.xml 3. Seleziona la tabella dati nel Navigatore 4. Clicca Chiudi e carica **Vedi anche** — [Esportazione delle descrizioni dei dispositivi TapHome](https://taphome.com/it/docs/configuration/export-description/), [Esempio di integrazione Make.com](https://taphome.com/it/docs/configuration/make-com-integration/).