Automatické exporty

🚀 Dostupné od verzie Core 2025.2.

Automatické exporty umožňujú automatizovaný zber dát a reportovanie z vášho TapHome systému. Táto funkcionalita ukladá všetky parametre exportu a umožňuje vám:

• Nastaviť automatické načítavanie dát v Google Sheets a Microsoft Excel (alebo iných nástrojoch)
• Sťahovať predefinované reporty manuálne z aplikácie za posledné obdobie
• Sťahovať vlastné reporty manuálne za vybrané časové rozsahy

Dáta sú uložené v cloudovom úložisku na https://data.taphome.com/api/export/profile/<token>/ a sú dostupné vo formátoch CSV, JSON, XLSX alebo XML.

Typy exportov

Automatické exporty podporujú tri rôzne typy dát:

Hodnoty zariadení

Export hodnôt senzorov, stavov zariadení a vypočítaných štatistík (teplota, spotreba energie, atď.). Toto je najčastejšie používaný typ exportu.

Ako to funguje

1. Zdroje dát (stĺpce)

Určíte, z ktorých zariadení a aké hodnoty chcete exportovať:

• Zariadenie: napr. Termostat, Snímač teploty
• Typ hodnoty: napr. Nastavená teplota, Aktuálna teplota
• Agregačná funkcia: Priemer , Minimum , Maximum

Štatistiky sa priebežne počítajú a ukladajú pre každé zariadenie. Ich vypnutie znemožní generovanie kompletného exportu, pretože historické dáta nie je možné dodatočne vypočítať.

2. Interval vzorkovania (riadky)

Určuje ako często sa zaznamenávajú dáta. Každý riadok v exporte predstavuje jeden interval vzorkovania.

Dostupné intervaly: 5 minút, 10 minút, 15 minút, 30 minút, 1 hodina, 12 hodín, 1 deň, 1 týždeň, 1 mesiac, 1 kvartál (3 mesiace), 1 rok.

Príklad: Pri intervale 1 hodina bude export obsahovať jeden riadok za každú hodinu.

3. Rozsah exportu

Definuje, koľko dát sa vygeneruje pri každom exporte (koľko historických dát).

Ak nastavíte:

• Rozsah exportu: 3 dni
• Interval vzorkovania: 1 hodina

Export bude obsahovať: 72 riadkov (3 dni × 24 hodín = 72 riadkov)

4. Automatická aktualizácia dát

Nastavte si, v akom čase sa generujú nové dáta.

• Každý deň : napr. každé 2 dni o 14:30
• Každý týždeň : napr. každé 3 týždne, v pondelok o 09:00
• Každý mesiac : napr. každý mesiac, 15. dňa o 12:00
• Každý rok : napr. každý rok, 25.12. o 18:00

Krok za krokom: Vytvorenie exportu

Krok 1: Vytvorte nový export

1. Otvorte zoznam exportov
2. Kliknite na Definovať nový export
3. Zadajte Názov exportu

Krok 2: Nastavte zdroje dát

1. V sekcii Zdroje dát (stĺpce) kliknite na Pridať stĺpec
2. Vyberte zariadenie (napr. Termostat)
3. Vyberte typ hodnoty (napr. Nastavená teplota)
4. Vyberte agregačnú funkciu (Priemer , Minimum , Maximum )
5. Opakujte pre všetky požadované stĺpce

“Každý riadok obsahuje: Termostat Nastavená teplota (1h priemer), Termostat Teplota (1 hodina minimum), Snímač jasu Jas (1h Maximum)”

Krok 3: Nastavte interval vzorkovania

1. V sekcii Interval vzorkovania (riadky) vyberte interval
2. Odporúčanie:
   • 5-15 min - pre detailné dáta (veľký export)
   • 1 hodina - pre bežné použitie
   • 1 deň/týždeň - pre dlhodobé trendy (malý export)

Krok 4: Nastavte rozsah exportu

1. V sekcii Rozsah exportu zadajte počet období
2. Skontrolujte počet riadkov v sumáre
3. Upozornenie: Export nesmie prekročiť 100 000 riadkov

“Exportované dáta budú obsahovať 1286 riadkov za obdobie 3 dni.”

Krok 5: Nastavte automatickú aktualizáciu

1. V sekcii Automatická aktualizácia dát povoľte export (Aktívne )
2. Nastavte frekvenciu generovania (napr. každý mesiac, 1. dňa o 00:00)
3. Uložte export

Krok 6: Získajte URL exportu

Po uložení aplikácia automaticky vygeneruje 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 vygeneruje aplikácia automaticky.

Dôležité upozornenia

• Aktivácia štatistík: Keď uložíte konfiguráciu exportu, systém automaticky aktivuje všetky požadované štatistiky pre exportované zariadenia. Tieto štatistiky sa priebežne počítajú a ukladajú. Dôležité: Štatistiky nie je možné vypočítať spätne do minulosti - ak ich vypnete, historické dáta sa stratia natrvalo.
• Internetové pripojenie: Riadiaca jednotka dokáže bez internetového pripojenia uchovávať dáta niekoľko hodín. Pri dlhodobom výpadku však musí staršie dáta mazať, aby nedošlo k preťaženiu pamäte.
• Kritické dáta: Pri kritických údajoch odporúčame použiť alternatívne riešenie zberu dát.
• Limit riadkov: Maximálny počet riadkov v exporte je 100 000.

Prístupový systém

Export prístupového systému generuje chronologický záznam udalostí - kto, kedy, na ktorej čítačke bol akceptovaný alebo zamietnutý a z akého dôvodu.

Čo obsahuje export

Každý riadok v exporte predstavuje jednu udalosť prístupového systému s nasledujúcimi údajmi:

• Používateľ - meno a priezvisko
• Dátum a čas - presný čas udalosti
• Čítačka kariet - názov a umiestnenie čítačky
• Výsledok - Povolený / Zamietnutý
• Dôvod - dôvod zamietnutia (ak relevantné)

Konfigurácia exportu

1. Vytvorte nový export typu Protokol prístupu
2. Zadajte Názov exportu
3. Vyberte časové obdobie pre export (rozsah exportu)
4. Nastavte automatickú aktualizáciu (voliteľné)
5. Uložte export a získajte URL na stiahnutie

Export je dostupný vo formátoch CSV, JSON, XLSX alebo XML.

Dochádzka

Export dochádzky na základe dát z prístupového systému vygeneruje prehľadný report, ktorý zobrazuje, kedy zamestnanci prišli a odišli, a koľko hodín odpracovali.

Predpoklady

Musíte mať nakonfigurované čítačky ako “príchodové” (vstup do budovy) a “odchodové” (výstup z budovy). Musí existovať aspoň jedna čítačka kariet.

Používatelia musia mať priradené prístupové karty so svojím menom.

Konfigurácia exportu

1. Vytvorte nový export typu Dochádzka
2. Zadajte Názov exportu
3. Príchodové čítačky :**
   • Vyberte čítačky, ktoré slúžia na príchod do budovy (vstupné čítačky)
4. Odchodové čítačky :**
   • Vyberte čítačky, ktoré slúžia na odchod z budovy (výstupné čítačky)
5. Vyberte časové obdobie pre export
6. Nastavte automatickú aktualizáciu (voliteľné)
7. Uložte export a získajte URL

Čo obsahuje export

Každý riadok predstavuje jeden pracovný deň jedného zamestnanca:

• Dátum - pracovný deň
• Meno a priezvisko - zamestnanec
• Prvý príchod - čas prvého vstupu do budovy
• Posledný odchod - čas posledného výstupu z budovy
• Čas vnútri [hh:mm] - celkový čas strávený v budove
• Čas vonku [hh:mm] - celkový čas prestávok mimo budovy

Výpočet času

Ak má prístupová karta prideleného užívateľa a užívateľ v daný deň vstúpil do budovy pomocou čítačky, v tabuľke sa vytvorí riadok. Berieme do úvahy iba záznamy s úspešným prístupom.

• Čas vnútri [hh:mm] - súčet časových rozdielov medzi príchodmi a odchodmi. Ak mal používateľ príchod (bez odchodu) alebo odchod (bez príchodu) niekoľkokrát za sebou, potom sa berú do úvahy iba prvé.

• Prvý príchod - čas prvého príchodu do budovy.

• Posledný odchod - čas posledného odchodu z budovy.

• Čas vonku [hh:mm] - súčet časových rozdielov medzi výstupmi a vstupmi.

V štandardných prípadoch, keď po príchode nasleduje odchod a po odchode nasleduje dvojica príchod-odchod (môže, ale nemusí), platí nasledovné:

Čas vnútri + Čas vonku = Posledný odchod - Prvý príchod

Formát

Export je dostupný vo formáte XLSX (odporúčaný) - obsahuje predformátovanú tabuľku pripravenú na ďalšie spracovanie.

Integrácie

Všetky tri typy exportov (Hodnoty zariadení, Prístupový systém, Dochádzka) je možné integrovať s Google Sheets a Microsoft Excel pomocou URL adries generovaných aplikáciou.

Google Sheets

Postup:

1. V dialógu Stiahnuť report v aplikácii skopírujte CSV URL
2. Otvorte Google Sheets
3. Vložte tento vzorec do ľubovoľnej bunky:

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

4. Dáta sa budú automaticky aktualizovať na pozadí

Microsoft Excel

Vyžaduje desktopový Excel s Power Query (nie je dostupné vo webovej verzii Microsoft 365).