Automatski izvozi

🚀 Dostupno od verzije centralne jedinice Core 2025.2.

Automatski izvozi omogućuju automatizirano prikupljanje podataka i izvješćivanje iz vašeg sustava TapHome. Ova funkcija sprema sve parametre izvoza i omogućuje vam da:

• Konfigurirate automatsko dohvaćanje podataka u Google Sheets i Microsoft Excel (ili druge alate)
• Ručno preuzmete unaprijed definirana izvješća iz aplikacije za najnovije razdoblje
• Ručno preuzmete prilagođena izvješća za odabrane vremenske raspone

Podaci se pohranjuju u oblaku na adresi https://data.taphome.com/api/export/profile/<token>/ i dostupni su u formatima CSV, JSON, XLSX ili XML.

Vrste izvoza#

Automatski izvozi podržavaju tri različite vrste podataka:

Vrijednosti uređaja#

Izvoz vrijednosti senzora, stanja uređaja i izračunatih statistika (temperatura, potrošnja energije itd.). Ovo je najčešće korištena vrsta izvoza.

Kako funkcionira#

1. Data Sources (Columns)#

Odredite iz kojih uređaja i koje vrijednosti želite izvoziti:

• Uređaj: npr. termostat, senzor temperature
• Vrsta vrijednosti: npr. zadana temperatura, trenutna temperatura
• Funkcija agregacije: prosječan, Minimum, Maksimum

Statistike se za svaki uređaj neprekidno izračunavaju i spremaju. Ako ih isključite, potpuni izvoz neće se moći generirati jer se povijesni podaci kasnije ne mogu ponovno izračunati.

2. Sampling Interval (Rows)#

Određuje koliko se često bilježe podaci. Svaki redak u izvozu predstavlja jedan interval uzorkovanja.

Dostupni intervali: 5 minuta, 10 minuta, 15 minuta, 30 minuta, 1 sat, 12 sati, 1 dan, 1 tjedan, 1 mjesec, 1 tromjesečje (3 mjeseca), 1 godina.

Primjer: uz interval od 1 sata izvoz sadrži jedan redak za svaki sat.

3. Export Range#

Određuje koliko se podataka generira za svaki izvoz (koliko povijesnih podataka).

Ako postavite:

• Raspon izvoza: 3 dana
• Interval uzorkovanja: 1 sat

Izvoz će sadržavati: 72 retka (3 dana × 24 sata = 72 retka)

4. Live data update#

Postavite kada se generiraju novi podaci.

• Svaki dan: npr. svaka 2 dana u 14:30
• Svaki tjedan: npr. svaka 3 tjedna, u ponedjeljak u 09:00
• Svaki mjesec: npr. svaki mjesec, 15. u mjesecu u 12:00
• Svake godine: npr. svake godine, 25. 12. u 18:00

Korak po korak: izrada izvoza#

Korak 1: Izradite novi izvoz#

1. Otvorite popis izvoza
2. Kliknite Define a new export
3. Unesite Naziv izvoza

Korak 2: Postavite izvore podataka#

1. U odjeljku Data Sources (Columns) kliknite Add column
2. Odaberite uređaj (npr. termostat)
3. Odaberite vrstu vrijednosti (npr. zadana temperatura)
4. Odaberite funkciju agregacije (prosječan, Minimum, Maksimum)
5. Ponovite za sve potrebne stupce

Primjer: svaki redak sadrži zadanu temperaturu termostata (prosjek za 1 h), temperaturu termostata (minimum za 1 h) i svjetlinu senzora svjetla (maksimum za 1 h).

Korak 3: Postavite interval uzorkovanja#

1. U odjeljku Sampling Interval (Rows) odaberite interval
2. Preporuke:
   • 5 – 15 min – za detaljne podatke (velik izvoz)
   • 1 sat – za opću upotrebu
   • 1 dan/tjedan – za dugoročne trendove (mali izvoz)

Korak 4: Postavite raspon izvoza#

1. U odjeljku Export Range unesite broj razdoblja
2. U sažetku provjerite broj redaka
3. Upozorenje: izvoz ne smije imati više od 100 000 redaka

Primjer: izvezeni podaci za razdoblje od 3 dana sadržavat će 1286 redaka.

Korak 5: Postavite automatsko ažuriranje#

1. U odjeljku Live data update uključite izvoz (Aktivno)
2. Postavite učestalost generiranja (npr. svaki mjesec, 1. dan u 00:00)
3. Spremite izvoz

Korak 6: Kopirajte URL izvoza#

Nakon spremanja aplikacija automatski generira 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

Token aplikacija generira automatski.

Važne napomene#

• Aktivacija statistika: Kada spremite konfiguraciju izvoza, sustav automatski uključuje sve potrebne statistike za izvezene uređaje. Te se statistike neprekidno izračunavaju i spremaju. Važno: statistike se ne mogu izračunati unatrag. Ako ih isključite, povijesni podaci trajno se gube.
• Internetska veza: Centralna jedinica može nekoliko sati spremati podatke bez internetske veze. U slučaju dužeg prekida stariji se podaci moraju izbrisati kako ne bi došlo do prepunjenja memorije.
• Ključni podaci: Za ključne podatke preporučujemo korištenje alternativnog rješenja za prikupljanje podataka.
• Ograničenje redaka: Izvoz može imati najviše 100 000 redaka.

Sustav kontrole pristupa#

Izvoz zapisnika pristupa generira kronološki zapis događaja: tko je, kada i na kojem čitaču bio prihvaćen ili odbijen te razlog.

Što izvoz sadrži#

Svaki redak u izvozu predstavlja jedan događaj sustava kontrole pristupa sa sljedećim podacima:

• Korisnik – ime i prezime
• Datum i vrijeme – točno vrijeme događaja
• Čitač kartica – naziv i mjesto čitača
• Rezultat – dopušteno / odbijeno
• Razlog – razlog odbijanja (ako je relevantno)

Konfiguracija izvoza#

1. Izradite novi izvoz vrste Zapisnik pristupa
2. Unesite Naziv izvoza
3. Odaberite vremensko razdoblje za izvoz (raspon izvoza)
4. Postavite automatsko ažuriranje (neobvezno)
5. Spremite izvoz i kopirajte URL za preuzimanje

Izvoz je dostupan u formatima CSV, JSON, XLSX ili XML.

Prisutnost#

Izvoz prisutnosti na temelju podataka sustava kontrole pristupa generira pregledno izvješće o tome kada su zaposlenici došli i otišli te koliko su sati radili.

Preduvjeti#

Morate imati čitače konfigurirane kao „prijava” (ulaz u zgradu) i „odjava” (izlaz iz zgrade). Mora postojati barem jedan čitač kartica.

Korisnicima moraju biti dodijeljene pristupne kartice s njihovim imenom.

Konfiguracija izvoza#

1. Izradite novi izvoz vrste Prisutnost
2. Unesite Naziv izvoza
3. Čitači kartica za prijavu:
   • Odaberite čitače koji se koriste za ulazak u zgradu (ulazni čitači)
4. Čitači kartica za odjavu:
   • Odaberite čitače koji se koriste za izlazak iz zgrade (izlazni čitači)
5. Odaberite vremensko razdoblje za izvoz
6. Postavite automatsko ažuriranje (neobvezno)
7. Spremite izvoz i kopirajte URL

Što izvoz sadrži#

Svaki redak predstavlja jedan radni dan jednog zaposlenika:

• Datum – radni dan
• Ime – zaposlenik
• Prva prijava – vrijeme prvog ulaska u zgradu
• Zadnja odjava – vrijeme zadnjeg izlaska iz zgrade
• Vrijeme unutra [hh:mm] – ukupno vrijeme provedeno u zgradi
• Vrijeme vani [hh:mm] – ukupno vrijeme stanki izvan zgrade

Izračun vremena#

Ako pristupna kartica ima dodijeljenog korisnika i korisnik je tog dana ušao u zgradu pomoću čitača, u tablici se stvara redak. Uzimaju se u obzir samo zapisi s uspješnim pristupom.

• Vrijeme unutra [hh:mm] – zbroj vremenskih razlika između dolazaka i odlazaka. Ako je za korisnika nekoliko puta zaredom zabilježen dolazak (bez odlaska) ili odlazak (bez dolaska), uzima se u obzir samo prvi.

• Prvi dolazak – vrijeme prvog dolaska u zgradu.

• Zadnji odlazak – vrijeme zadnjeg odlaska iz zgrade.

• Vrijeme vani [hh:mm] – zbroj vremenskih razlika između odlazaka i dolazaka.

U standardnim slučajevima, kada nakon dolaska slijedi odlazak, a nakon odlaska par dolazak–odlazak (ili više parova), vrijedi sljedeće:

Vrijeme unutra + Vrijeme vani = Zadnji odlazak – Prvi dolazak

Format#

Izvoz je dostupan u formatu XLSX (preporučeno) i sadrži unaprijed oblikovanu tablicu spremnu za daljnju obradu.

Integracije#

Sve tri vrste izvoza (vrijednosti uređaja, sustav kontrole pristupa, prisutnost) mogu se integrirati s Google Sheets i Microsoft Excelom pomoću URL-ova koje generira aplikacija.

Google Sheets#

Koraci:

1. U dijalogu Download report u aplikaciji kopirajte URL za CSV
2. Otvorite Google Sheets
3. U bilo koju ćeliju zalijepite ovu formulu:

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

4. Podaci će se automatski ažurirati u pozadini

Microsoft Excel#

Potreban je Excel za računalo s dodatkom Power Query (nije dostupan u web-verziji Microsoft 365).