Automatické exporty

🚀 Dostupné od verze Core 2025.2.

Automatické exporty umožňují automatizovaný sběr dat a reportování z vašeho TapHome systému. Tato funkce ukládá všechny parametry exportu a umožňuje vám:

• Nastavit automatické načítání dat v Google Sheets a Microsoft Excel (nebo v jiných nástrojích)
• Stahovat předdefinované reporty ručně z aplikace za poslední období
• Stahovat vlastní reporty ručně za vybrané časové rozsahy

Data jsou uložena v cloudovém úložišti na https://data.taphome.com/api/export/profile/<token>/ a jsou dostupná ve formátech CSV, JSON, XLSX nebo XML.

Typy exportů

Automatické exporty podporují tři různé typy dat:

Hodnoty zařízení

Export hodnot senzorů, stavů zařízení a vypočítaných statistik (teplota, spotřeba energie atd.). Toto je nejčastěji používaný typ exportu.

Jak to funguje

1. Zdroje dat (sloupce)

Určíte, ze kterých zařízení a jaké hodnoty chcete exportovat:

• Zařízení: např. termostat, snímač teploty
• Typ hodnoty: např. nastavená teplota, aktuální teplota
• Agregační funkce: Průměr , Minimum , Maximum

Statistiky se průběžně počítají a ukládají pro každé zařízení. Jejich vypnutí znemožní generování kompletního exportu, protože historická data není možné dodatečně vypočítat.

2. Interval vzorkování (řádky)

Určuje, jak často se zaznamenávají data. Každý řádek v exportu představuje jeden vzorkovací interval.

Dostupné intervaly: 5 minut, 10 minut, 15 minut, 30 minut, 1 hodina, 12 hodin, 1 den, 1 týden, 1 měsíc, 1 kvartál (3 měsíce), 1 rok.

Příklad: Při intervalu 1 hodina bude export obsahovat jeden řádek za každou hodinu.

3. Rozsah exportu

Definuje, kolik dat se vygeneruje při každém exportu (kolik historických dat).

[TIP] Pokud nastavíte:

• Rozsah exportu: 3 dny
• Interval vzorkování: 1 hodina

Export bude obsahovat: 72 řádků (3 dny × 24 hodin = 72 řádků)

4. Automatická aktualizace dat

Nastavte si, v jakém čase se generují nová data.

• Každý den : např. každé 2 dny ve 14:30
• Každý týden : např. každé 3 týdny v pondělí v 09:00
• Každý měsíc : např. každý měsíc, 15. den ve 12:00
• Každý rok : např. každý rok, 25. 12. v 18:00

Krok za krokem: Vytvoření exportu

Krok 1: Vytvořte nový export

1. Otevřete seznam exportů
2. Klikněte na Definovat nový export
3. Zadejte Název exportu

Krok 2: Nastavte zdroje dat

1. V sekci Zdroje dat (sloupce) klikněte na Přidat sloupec
2. Vyberte zařízení (např. termostat)
3. Vyberte typ hodnoty (např. nastavená teplota)
4. Vyberte agregační funkci (Průměr , Minimum , Maximum )
5. Opakujte pro všechny požadované sloupce

“Každý řádek obsahuje: termostat Nastavená teplota (1h průměr), termostat Teplota (1h minimum), snímač jasu Jas (1h maximum).”

Krok 3: Nastavte interval vzorkování

1. V sekci Interval vzorkování (řádky) vyberte interval
2. Doporučení:
   • 5–15 minut – pro detailní data (velký export)
   • 1 hodina – pro běžné použití
   • 1 den/týden – pro dlouhodobé trendy (malý export)

Krok 4: Nastavte rozsah exportu

1. V sekci Rozsah exportu zadejte počet období
2. Zkontrolujte počet řádků v součtu
3. Upozornění: export nesmí překročit 100 000 řádků

[TIP] “Exportovaná data budou obsahovat 1286 řádků za období 3 dny.”

Krok 5: Nastavte automatickou aktualizaci

1. V sekci Automatická aktualizace dat povolte export (Aktivní )
2. Nastavte frekvenci generování (např. každý měsíc, 1. den v 00:00)
3. Uložte export

Krok 6: Získejte URL exportu

Po uložení aplikace 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 aplikace automaticky.

Důležité upozornění

• Aktivace statistik: Když uložíte konfiguraci exportu, systém automaticky aktivuje všechny požadované statistiky pro exportovaná zařízení. Tyto statistiky se průběžně počítají a ukládají. Důležité: statistiky nelze spočítat zpětně do minulosti – pokud je vypnete, historická data se ztratí navždy.
• Internetové připojení: Řídicí jednotka dokáže bez internetového připojení uchovávat data několik hodin. Při dlouhodobém výpadku však musí starší data mazat, aby nedošlo k přeplnění paměti.
• Kritická data: U kritických údajů doporučujeme použít alternativní řešení sběru dat.
• Limit řádků: Maximální počet řádků v exportu je 100 000.

Přístupový systém

Export přístupového systému generuje chronologický záznam událostí – kdo, kdy, na které čtečce byl akceptován nebo zamítnut a z jakého důvodu.

Co obsahuje export

Každý řádek v exportu představuje jednu událost přístupového systému s následujícími údaji:

• Uživatel – jméno a příjmení
• Datum a čas – přesný čas události
• Čtečka karet – název a umístění čtečky
• Výsledek – povoleno / zamítnuto
• Důvod – důvod zamítnutí (pokud je relevantní)

Konfigurace exportu

1. Vytvořte nový export typu Protokol přístupu
2. Zadejte Název exportu
3. Vyberte časové období pro export (rozsah exportu)
4. Nastavte automatickou aktualizaci (volitelné)
5. Uložte export a získejte URL ke stažení

Export je dostupný ve formátech CSV, JSON, XLSX nebo XML.

Docházka

Export docházky na základě dat z přístupového systému vygeneruje přehledný report, který zobrazuje, kdy zaměstnanci přišli a odešli a kolik hodin odpracovali.

Předpoklady

Musíte mít nakonfigurované čtečky jako „příchodové“ (vstup do budovy) a „odchodové“ (výstup z budovy). Musí existovat alespoň jedna čtečka karet.

Uživatelé musí mít přiřazené přístupové karty se svým jménem.

Konfigurace exportu

1. Vytvořte nový export typu Docházka
2. Zadejte Název exportu
3. Příchodové čtečky :**
   • Vyberte čtečky, které slouží k příchodu do budovy (vstupní čtečky)
4. Odchodové čtečky :**
   • Vyberte čtečky, které slouží k odchodu z budovy (výstupní čtečky)
5. Vyberte časové období pro export
6. Nastavte automatickou aktualizaci (volitelné)
7. Uložte export a získejte URL

Co obsahuje export

Každý řádek představuje jeden pracovní den jednoho zaměstnance:

• Datum – pracovní den
• Jméno a příjmení – zaměstnanec
• První příchod – čas prvního vstupu do budovy
• Poslední odchod – čas posledního výstupu z budovy
• Čas uvnitř [hh:mm] – celkový čas strávený v budově
• Čas venku [hh:mm] – celkový čas přestávek mimo budovu

Výpočet času

Pokud má přístupová karta přiřazeného uživatele a uživatel v daný den vstoupil do budovy pomocí čtečky, v tabulce se vytvoří řádek. Bereme v úvahu pouze záznamy s úspěšným přístupem.

• Čas uvnitř [hh:mm] – součet časových rozdílů mezi příchody a odchody. Pokud měl uživatel příchod (bez odchodu) nebo odchod (bez příchodu) několikrát za sebou, potom se berou v úvahu pouze první.

• První příchod – čas prvního příchodu do budovy.

• Poslední odchod – čas posledního odchodu z budovy.

• Čas venku [hh:mm] – součet časových rozdílů mezi výstupy a vstupy.

Ve standardních případech, kdy po příchodu následuje odchod a po odchodu následuje dvojice příchod–odchod (může, ale nemusí), platí následující:

Čas uvnitř + Čas venku = Poslední odchod – První příchod

Formát

Export je dostupný ve formátu XLSX (doporučený) – obsahuje předformátovanou tabulku připravenou k dalšímu zpracování.

Integrace

Všechny tři typy exportů (Hodnoty zařízení, Přístupový systém, Docházka) lze integrovat s Google Sheets a Microsoft Excel pomocí URL adres generovaných aplikací.

Google Sheets

Postup:

1. V dialogu Stáhnout report v aplikaci zkopírujte CSV URL
2. Otevřete Google Sheets
3. Vložte tento vzorec do libovolné buňky:

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

4. Data se budou automaticky aktualizovat na pozadí

Microsoft Excel

Vyžaduje desktopový Excel s Power Query (není dostupný ve webové verzi Microsoft 365).