Esportazioni automatiche

🚀 Disponibile dalla versione Core 2025.2.

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/<token>/ 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

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

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

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

“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

“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:

1
2
3
4

https://data.taphome.com/api/export/profile/<token>/data.csv
https://data.taphome.com/api/export/profile/<token>/data.json
https://data.taphome.com/api/export/profile/<token>/data.xlsx
https://data.taphome.com/api/export/profile/<token>/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

Devi aver configurato i lettori come “in ingresso” (entrata nell’edificio) e “in uscita” (uscita dall’edificio). Deve esserci almeno un lettore di carte.

Gli utenti devono avere assegnate carte di accesso con il proprio nome.

Configurazione dell’export

1. Crea un nuovo export di tipo Presenza
2. Inserisci il nome dell’export: Nome
3. Lettori tessere ingresso :**
   • Seleziona i lettori che servono per l’ingresso nell’edificio (lettori di ingresso)
4. Lettori tessere 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:

   1	=IMPORTDATA("https://data.taphome.com/api/export/profile/<token>/data.csv")

4. I dati verranno aggiornati automaticamente in background

Microsoft Excel

Richiede Excel desktop con Power Query (non disponibile nella versione web di Microsoft 365).