Exporturi automate

🚀 Disponibil începând cu versiunea Core 2025.2.

Exporturile automate permit colectarea și raportarea automată a datelor din sistemul TapHome. Această funcție stochează toți parametrii exportului și vă permite:

• Configurarea preluării automate a datelor în Google Sheets și Microsoft Excel (sau în alte instrumente)
• Descărcarea manuală, din aplicație, a rapoartelor predefinite pentru perioada cea mai recentă
• Descărcarea manuală a rapoartelor personalizate pentru intervalele de timp selectate

Datele sunt stocate în cloud la adresa https://data.taphome.com/api/export/profile/<token>/ și sunt disponibile în formatele CSV, JSON, XLSX sau XML.

Tipuri de export#

Exporturile automate acceptă trei tipuri diferite de date:

Valorile dispozitivelor#

Exportul valorilor senzorilor, al stărilor dispozitivelor și al statisticilor calculate (temperatură, consum de energie etc.). Acesta este tipul de export folosit cel mai des.

Cum funcționează#

1. Data Sources (Columns)#

Specificați din ce dispozitive și ce valori doriți să exportați:

• Dispozitiv: de exemplu Termostat, Senzor de temperatură
• Tipul valorii: de exemplu Temperatură setată, Temperatură actuală
• Funcția de agregare: In medie, Minim, Maxim

Statisticile se calculează și se stochează continuu pentru fiecare dispozitiv. Dacă le dezactivați, nu se mai poate genera un export complet, deoarece datele istorice nu se pot recalcula ulterior.

2. Sampling Interval (Rows)#

Stabilește cât de des se înregistrează datele. Fiecare rând din export reprezintă un interval de eșantionare.

Intervale disponibile: 5 minute, 10 minute, 15 minute, 30 de minute, 1 oră, 12 ore, 1 zi, 1 săptămână, 1 lună, 1 trimestru (3 luni), 1 an.

Exemplu: La un interval de 1 oră, exportul conține un rând pentru fiecare oră.

3. Export Range#

Definește câte date se generează la fiecare export (câte date istorice).

Dacă setați:

• Intervalul exportului: 3 zile
• Intervalul de eșantionare: 1 oră

Exportul va conține: 72 de rânduri (3 zile × 24 de ore = 72 de rânduri)

4. Live data update#

Setați când se generează datele noi.

• În fiecare zi: de exemplu, la fiecare 2 zile la 14:30
• În fiecare săptămână: de exemplu, la fiecare 3 săptămâni, lunea la 09:00
• În fiecare lună: de exemplu, în fiecare lună, pe data de 15 la 12:00
• În fiecare an: de exemplu, în fiecare an, pe 25.12 la 18:00

Pas cu pas: crearea unui export#

Pasul 1: Creați un export nou#

1. Deschideți lista de exporturi
2. Faceți clic pe Define a new export
3. Completați câmpul Nume al exportului

Pasul 2: Setați sursele de date#

1. În secțiunea Data Sources (Columns), faceți clic pe Add column
2. Selectați dispozitivul (de exemplu, Termostat)
3. Selectați tipul valorii (de exemplu, Temperatură setată)
4. Selectați funcția de agregare (In medie, Minim, Maxim)
5. Repetați pentru toate coloanele necesare

Exemplu: Fiecare rând conține: Temperatura setată a termostatului (media pe 1 h), Temperatura termostatului (minimul pe 1 h), Luminozitatea senzorului de lumină (maximul pe 1 h).

Pasul 3: Setați intervalul de eșantionare#

1. În secțiunea Sampling Interval (Rows), alegeți intervalul
2. Recomandări:
   • 5–15 min – pentru date detaliate (export mare)
   • 1 oră – pentru utilizare generală
   • 1 zi/săptămână – pentru tendințe pe termen lung (export mic)

Pasul 4: Setați intervalul exportului#

1. În secțiunea Export Range, introduceți numărul de perioade
2. Verificați numărul de rânduri în rezumat
3. Atenție: exportul nu trebuie să depășească 100 000 de rânduri

Exemplu: Datele exportate vor conține 1286 de rânduri pentru o perioadă de 3 zile.

Pasul 5: Setați actualizarea automată#

1. În secțiunea Live data update, activați exportul (Activat)
2. Setați frecvența de generare (de exemplu, în fiecare lună, în prima zi la 00:00)
3. Salvați exportul

Pasul 6: Obțineți adresa URL a exportului#

După salvare, aplicația generează automat adresa 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

Tokenul este generat automat de aplicație.

Atenționări importante#

• Activarea statisticilor: La salvarea configurației exportului, sistemul activează automat toate statisticile necesare pentru dispozitivele exportate. Aceste statistici se calculează și se stochează continuu. Important: statisticile nu se pot calcula retroactiv; dacă le dezactivați, datele istorice se pierd definitiv.
• Conexiunea la internet: Unitatea de control poate stoca datele câteva ore fără conexiune la internet. În cazul unei întreruperi îndelungate, datele mai vechi trebuie șterse pentru a evita umplerea memoriei.
• Date critice: Pentru datele critice recomandăm o soluție alternativă de colectare a datelor.
• Limita de rânduri: Numărul maxim de rânduri dintr-un export este 100 000.

Sistem de acces#

Exportul jurnalului de acces generează o înregistrare cronologică a evenimentelor: cine, când și la ce cititor a primit sau nu acces și din ce motiv.

Ce conține exportul#

Fiecare rând din export reprezintă un eveniment al sistemului de acces, cu următoarele date:

• Utilizator – numele complet
• Data și ora – momentul exact al evenimentului
• Cititor de carduri – numele și amplasarea cititorului
• Rezultat – Permis / Refuzat
• Motiv – motivul refuzului (dacă este cazul)

Configurarea exportului#

1. Creați un export nou de tipul Jurnal de acces
2. Completați câmpul Nume al exportului
3. Alegeți perioada de timp pentru export (intervalul exportului)
4. Setați actualizarea automată (opțional)
5. Salvați exportul și obțineți adresa URL de descărcare

Exportul este disponibil în formatele CSV, JSON, XLSX sau XML.

Prezență#

Exportul de prezență, bazat pe datele din sistemul de acces, generează un raport clar care arată când au sosit și când au plecat angajații și câte ore au lucrat.

Condiții prealabile#

Trebuie să aveți cititoare configurate ca „check-in” (intrare în clădire) și „check-out” (ieșire din clădire). Trebuie să existe cel puțin un cititor de carduri.

Utilizatorii trebuie să aibă atribuite carduri de acces cu numele lor.

Configurarea exportului#

1. Creați un export nou de tipul Prezență
2. Completați câmpul Nume al exportului
3. Cititoare de carduri de check-in:
   • Selectați cititoarele folosite la intrarea în clădire (cititoare de intrare)
4. Cititoare de carduri de check-out:
   • Selectați cititoarele folosite la ieșirea din clădire (cititoare de ieșire)
5. Alegeți perioada de timp pentru export
6. Setați actualizarea automată (opțional)
7. Salvați exportul și obțineți adresa URL

Ce conține exportul#

Fiecare rând reprezintă o zi de lucru a unui angajat:

• Data – ziua de lucru
• Nume – angajatul
• Primul check-in – ora primei intrări în clădire
• Ultimul check-out – ora ultimei ieșiri din clădire
• Timp în interior [hh:mm] – timpul total petrecut în clădire
• Timp în exterior [hh:mm] – durata totală a pauzelor petrecute în afara clădirii

Calculul timpului#

Dacă cardul de acces are un utilizator atribuit și utilizatorul a intrat în acea zi în clădire printr-un cititor, în tabel se creează un rând. Se iau în considerare numai înregistrările cu acces reușit.

• Timp în interior [hh:mm] – suma diferențelor de timp dintre sosiri și plecări. Dacă pentru utilizator s-au înregistrat de mai multe ori la rând sosiri (fără plecare) sau plecări (fără sosire), se ia în considerare numai prima.

• Prima sosire – ora primei sosiri în clădire.

• Ultima plecare – ora ultimei plecări din clădire.

• Timp în exterior [hh:mm] – suma diferențelor de timp dintre ieșiri și intrări.

În cazurile standard, când după o sosire urmează o ieșire, iar după ieșire urmează o pereche sosire–ieșire (sau mai multe perechi), este valabil:

Timp în interior + Timp în exterior = Ultima plecare – Prima sosire

Format#

Exportul este disponibil în format XLSX (recomandat) și conține un tabel preformatat, pregătit pentru prelucrare ulterioară.

Integrări#

Toate cele trei tipuri de export (Valorile dispozitivelor, Sistem de acces, Prezență) se pot integra cu Google Sheets și Microsoft Excel prin adresele URL generate de aplicație.

Google Sheets#

Pași:

1. În dialogul Download report din aplicație, copiați adresa URL pentru CSV
2. Deschideți Google Sheets
3. Lipiți această formulă în orice celulă:

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

4. Datele se actualizează automat în fundal

Microsoft Excel#

Este necesar Excel pentru desktop cu Power Query (nu este disponibil în versiunea web Microsoft 365).