Automatikus exportok

🚀 Elérhető a Core 2025.2 verziótól.

Automatikus exportok lehetővé teszik az adatok automatikus gyűjtését és jelentéskészítését a TapHome rendszeréből. Ez a funkció minden exportparamétert tárol és lehetővé teszi Önnek:

• az adatok automatikus betöltésének beállítását Google Sheetsbe és Microsoft Excelbe (vagy más eszközökbe)
• előre definiált jelentések kézi letöltését az alkalmazásból az utolsó időszakra
• saját jelentések kézi letöltését tetszőlegesen választott időtartamokra

Az adatok a felhőalapú tárhelyen találhatók a https://data.taphome.com/api/export/profile/<token>/ címen, és CSV, JSON, XLSX vagy XML formátumban érhetők el.

Exporttípusok

Az automatikus exportok három különböző adattípust támogatnak:

Eszközértékek

Szenzorértékek, eszközállapotok és kiszámított statisztikák exportja (hőmérséklet, energiafogyasztás stb.). Ez a leggyakrabban használt exporttípus.

Hogyan működik

1. Adatforrások (Oszlopok)

Határozza meg, mely eszközöktől és milyen értékeket szeretne exportálni:

• Eszköz: pl. termosztát, hőmérséklet-érzékelő
• Értéktípus: pl. beállított hőmérséklet, aktuális hőmérséklet
• Aggregációs funkció: Átlag , Minimum , Maximum

A statisztikákat folyamatosan számítják és tárolják minden eszközre. Ha kikapcsolja őket, akkor nem lesz lehetőség a teljes export generálására, mert a történeti adatok utólag nem számolhatók ki.

2. Mintavételi intervallum (sorok)

Határozza meg, milyen gyakran rögzítik az adatokat. Minden sor az exportban egy mintavételi intervallumot képvisel.

Elérhető intervallumok: 5 perc, 10 perc, 15 perc, 30 perc, 1 óra, 12 óra, 1 nap, 1 hét, 1 hónap, 1 negyedév (3 hónap), 1 év.

Példa: Ha az intervallum 1 óra, az export tartalmaz egy sort minden órára.

3. Exportálási tartomány

Meghatározza, mennyi adat kerül generálásra minden export során (mennyi történeti adat).

Ha:

• exporttartomány: 3 nap
• mintavételi intervallum: 1 óra

az export 72 sort fog tartalmazni (3 nap × 24 óra = 72 sor)

4. Automatikus adatfrissítés

Állítsa be, mikor generálódnak az adatok.

• Minden nap : pl. minden 2. nap 14:30-kor
• Minden hét : pl. minden 3. héten hétfőn 09:00-kor
• Minden hónap : pl. minden hónapban a 15-én 12:00-kor
• Minden év : pl. minden évben 12.25-én 18:00-kor

Lépésről lépésre: export létrehozása

Lépés 1: Hozzon létre egy új exportot

1. Nyissa meg az exportok listáját
2. Kattintson a Új exportálás definiálása gombra
3. Adja meg az export nevét az Név mezőben

Lépés 2: Adatforrások beállítása

1. A Adatforrások (Oszlopok) szekcióban kattintson az Oszlop hozzáadása gombra
2. Válassza ki a készüléket (pl. termosztát)
3. Válassza ki az értéktípust (pl. beállított hőmérséklet)
4. Válassza ki az aggregációs funkciót (Átlag , Minimum , Maximum )
5. Ismételje meg a műveletet a kívánt oszlopokhoz

„Minden sor tartalmazza: termosztát – beállított hőmérséklet (1h átlag), termosztát – hőmérséklet (1h minimum), fényérzékelő – fényesség (1h maximum).”

Lépés 3: Mintavételi intervallum beállítása

1. A Mintavételi intervallum (sorok) szekcióban válasszon intervallumot
2. Ajánlott:
   • 5–15 perc – részletes adatokhoz (nagy export)
   • 1 óra – általános használatra
   • 1 nap / 1 hét – hosszú távú trendekhez (kisebb export)

Lépés 4: Exporttartomány beállítása

1. Az Exportálási tartomány szekcióban adja meg az időszakok számát
2. Ellenőrizze a sorok számát az összegzésben
3. Figyelem: az export nem haladhatja meg a 100 000 sort

„Az exportált adatok 1286 sort fognak tartalmazni 3 napos időszakban.”

Lépés 5: Automatikus frissítés beállítása

1. Az Automatikus adatfrissítés szekcióban engedélyezze az exportot (Engedélyezve )
2. Állítsa be a generálás gyakoriságát (pl. minden hónapban az 1. napon 00:00-kor)
3. Mentse el az exportot

Lépés 6: Szerezze meg az export URL-jét

Mentés után az alkalmazás automatikusan generálja az URL-t:

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

A tokent az alkalmazás automatikusan generálja.

Fontos figyelmeztetések

• Statisztikák aktiválása: amikor menti az export konfigurációját, a rendszer automatikusan aktiválja az exportált eszközökre a kért statisztikákat. Ezeket a statisztikákat folyamatosan számítják és tárolják. Fontos: a statisztikákat nem lehet visszamenőleg kiszámítani – ha kikapcsolja őket, a történeti adatok véglegesen elvesznek.
• Internetkapcsolat: a vezérlőegység internetkapcsolat nélkül néhány órán át képes adatokat tárolni. Hosszabb kimaradás esetén azonban törölnie kell a régebbi adatokat, hogy elkerülje a memória túlterhelését.
• Kritikus adatok: kritikus adatok esetén javasoljuk alternatív adatgyűjtési megoldás használatát.
• Sorkorlát: az export maximális sorainak száma 100 000.

Hozzáférési napló

A hozzáférési rendszer exportja a kronológiai események sorozatát generálja – ki, mikor, melyik olvasónál történt elfogadás vagy elutasítás, és mi volt az indok.

Mit tartalmaz az export

Minden sor az exportban egy hozzáférési eseményt jelent a következő adatokkal:

• Felhasználó – név és vezetéknév
• Dátum és idő – az esemény pontos időpontja
• Kártyaolvasó – az olvasó neve és helye
• Eredmény – engedélyezett / elutasított
• Indok – az elutasítás indoka (ha releváns)

Export konfiguráció

1. Hozzon létre egy új exporttípust: Hozzáférési napló
2. Adja meg az export nevét az Név mezőben
3. Válassza ki az export időszakát (exporttartomány)
4. Állítsa be az automatikus frissítést (nem kötelező)
5. Mentse el az exportot és szerezze meg a letöltési URL-t

Az export CSV, JSON, XLSX vagy XML formátumban érhető el.

Jelenlét

A jelenléti export a hozzáférési rendszer adataira alapozva egy áttekinthető jelentést készít, amely megmutatja, mikor érkeztek és távoztak az alkalmazottak, és mennyi időt töltöttek a munkahelyen.

Előfeltételek

Legalább egy be- és egy kilépő olvasó legyen konfigurálva (bejárati és kilépő olvasók). Legalább egy kártyaolvasónak lennie kell.

A felhasználókhoz hozzáférési kártyákat kell társítani.

Export konfiguráció

1. Hozzon létre egy új exporttípust: Jelenlét
2. Adja meg exportja nevét az Név mezőben
3. Bejelentkezési kártyaolvasók :**
   • válassza ki azokat az olvasókat, amelyek a bejárathoz (bejárati olvasók) tartoznak
4. Kijelentkezési kártyaolvasók :**
   • válassza ki azokat az olvasókat, amelyek a kilépéshez (kilépő olvasók) tartoznak
5. Válassza ki az export időszakát
6. Állítsa be az automatikus frissítést (nem kötelező)
7. Mentse el az exportot és szerezze meg az URL-t

Mit tartalmaz az export

Minden sor egy alkalmazott egy munkanapját tartalmazza:

• Dátum – munkanap
• Név és keresztnév – alkalmazott
• Első belépés – az első belépés ideje a bejárati ajtónál
• Utolsó kilépés – az utolsó kilépés ideje
• Benti idő [hh:mm] – a bent töltött idő összesen a munkaidő alatt
• Kint töltött idő [hh:mm] – a munkahelyen kívül töltött idő összesen a szünetek alatt

Idő kiszámítása

Ha a hozzáférési kártyához rendelt felhasználó adott napon belépett az épületbe a belépő olvasón keresztül, a táblázatban egy sor jelenik meg. Csak a sikeres hozzáférési bejegyzéseket vesszük figyelembe.

• Benti idő [hh:mm] – az érkezések és kilépések közötti időtartamok összege. Ha a felhasználónak egymás után többször csak belépései (kilépés nélkül), vagy csak kilépései (belépés nélkül) voltak, akkor csak az elsőt vesszük figyelembe.

• Első belépés – az első belépés ideje a bejáratnál

• Utolsó kilépés – az utolsó kilépés ideje

• Kint töltött idő [hh:mm] – a kilépések és belépések közötti időtartamok összege

Általános esetben, amikor a belépést kilépés követi, majd a kilépés után ismét egy belépés–kilépés pár következik (ez lehetséges, de nem kötelező), a következő érvényes:

Benti idő + Kint töltött idő = Utolsó kilépés - Első belépés

Formátum

Az export XLSX formátumban érhető el (ajánlott) – előre formázott táblázatot tartalmaz, amely készen áll a további feldolgozásra.

Integrációk

Mindhárom exporttípus (Eszközértékek, Hozzáférési napló, Jelenlét) összekapcsolható a Google Sheets-szel és a Microsoft Excellel az alkalmazás által generált URL-címek segítségével.

Google Sheets

Eljárás:

1. Az alkalmazásban a Riport letöltése párbeszédablakban másolja a CSV URL-t
2. Nyissa meg a Google Sheets-et
3. Illessze be ezt a képletet bármelyik cellába:

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

4. Az adatok a háttérben automatikusan frissülni fognak

Microsoft Excel

Asztali Excel és Power Query szükséges (nem érhető el a webes Microsoft 365 verzióban).