Automatyczne eksporty

🚀 Dostępne od wersji Core 2025.2.

Automatyczne eksporty umożliwiają zautomatyzowany zbiór danych i raportowanie z Twojego systemu TapHome. Ta funkcjonalność zapisuje wszystkie parametry eksportu i umożliwia Ci:

• Ustawienie automatycznego pobierania danych w Google Sheets i Microsoft Excel (lub innych narzędziach)
• Ręczne pobieranie z aplikacji predefiniowanych raportów z ostatniego okresu
• Ręczne pobieranie z aplikacji raportów za wybrane zakresy czasowe

Dane są przechowywane w chmurowej przestrzeni pod adresem https://data.taphome.com/api/export/profile/<token>/ i są dostępne w formatach CSV, JSON, XLSX lub XML.

Typy eksportów

Automatyczne eksporty obsługują trzy różne typy danych:

Wartości urządzeń

Eksport wartości sensorów, stanów urządzeń i obliczonych statystyk (temperatura, zużycie energii itp.). Jest to najczęściej używany typ eksportu.

Jak to działa

1. Źródła danych (Kolumny)

Określasz, z których urządzeń i jakie wartości chcesz eksportować:

• Urządzenie: np. termostat, czujnik temperatury
• Rodzaj wartości: np. temperatura zadana, temperatura aktualna
• Funkcja agregująca: Średnia , Minimum , Maksimum

Statystyki są na bieżąco obliczane i zapisywane dla każdego urządzenia. Ich wyłączenie uniemożliwi wygenerowanie pełnego eksportu, ponieważ danych historycznych nie można później obliczyć.

2. Interwał próbkowania (wiersze)

Określa, jak często są zapisywane dane. Każdy wiersz eksportu reprezentuje jeden interwał próbkowania.

Dostępne interwały: 5 minut, 10 minut, 15 minut, 30 minut, 1 godzina, 12 godzin, 1 dzień, 1 tydzień, 1 miesiąc, 1 kwartał (3 miesiące), 1 rok.

Przykład: dla interwału 1 godzina eksport będzie zawierał jeden wiersz na każdą godzinę.

3. Zakres eksportu

Określa, ile danych zostanie wygenerowanych przy każdym eksporcie (ile danych historycznych zostanie uwzględnionych).

Jeśli ustawisz:

• Zakres eksportu: 3 dni
• Interwał próbkowania: 1 godzina

Eksport będzie zawierał: 72 wiersze (3 dni × 24 godziny = 72 wiersze)

4. Automatyczna aktualizacja danych

Ustaw, o której godzinie mają być generowane nowe dane.

• Każdego dnia : np. co 2 dni o 14:30
• Co tydzień : np. co 3 tygodnie, w poniedziałek o 09:00
• Co miesiąc : np. każdego miesiąca, 15. dnia o 12:00
• Co rok : np. każdego roku, 25.12. o 18:00

Krok po kroku: tworzenie eksportu

Krok 1: Utwórz nowy eksport

1. Otwórz listę eksportów
2. Kliknij Zdefiniuj nowy eksport
3. Wprowadź Nazwa eksportu

Krok 2: Ustaw źródła danych

1. W sekcji Źródła danych (Kolumny) kliknij Dodaj kolumnę
2. Wybierz urządzenie (np. termostat)
3. Wybierz typ wartości (np. temperatura zadana)
4. Wybierz funkcję agregującą (Średnia , Minimum , Maksimum )
5. Powtórz dla wszystkich wymaganych kolumn

„Każdy wiersz zawiera: Termostat temperatura zadana (średnia z 1 h), Termostat temperatura (minimum z 1 h), Czujnik jasności jasność (maksimum z 1 h)”

Krok 3: Ustaw interwał próbkowania

1. W sekcji Interwał próbkowania (wiersze) wybierz interwał
2. Rekomendacja:
   • 5–15 minut – dla szczegółowych danych (duży eksport)
   • 1 godzina – dla typowego użycia
   • 1 dzień / 1 tydzień – dla długoterminowych trendów (mały eksport)

Krok 4: Ustaw zakres eksportu

1. W sekcji Zakres eksportu wprowadź liczbę okresów
2. Sprawdź łączną liczbę wierszy
3. Uwaga: eksport nie może przekroczyć 100 000 wierszy

„Eksportowane dane będą zawierać 1286 wierszy za okres 3 dni.”

Krok 5: Ustaw automatyczną aktualizację

1. W sekcji Automatyczna aktualizacja danych włącz eksport (Włączone )
2. Ustaw częstotliwość generowania (np. każdego miesiąca, 1. dnia o 00:00)
3. Zapisz eksport

Krok 6: Uzyskaj URL eksportu

Po zapisaniu aplikacja automatycznie wygeneruje URL:

https://data.taphome.com/api/export/profile//data.csv
https://data.taphome.com/api/export/profile//data.json
https://data.taphome.com/api/export/profile//data.xlsx
https://data.taphome.com/api/export/profile//data.xml

Token jest generowany automatycznie przez aplikację.

Ważne uwagi

• Aktywacja statystyk: Po zapisaniu konfiguracji eksportu system automatycznie aktywuje wszystkie wymagane statystyki dla eksportowanych urządzeń. Statystyki te są na bieżąco obliczane i zapisywane. Ważne: statystyk nie da się obliczyć wstecz – jeśli je wyłączysz, dane historyczne zostaną trwale utracone.
• Połączenie z Internetem: Jednostka sterująca potrafi bez połączenia internetowego przechowywać dane przez kilka godzin. Przy długotrwałej awarii musi jednak usuwać starsze dane, aby nie doprowadzić do przeciążenia pamięci.
• Krytyczne dane: W przypadku danych krytycznych zalecamy użycie alternatywnego rozwiązania do zbierania danych.
• Limit wierszy: Maksymalna liczba wierszy w eksporcie to 100 000.

System dostępu

Eksport systemu dostępu generuje chronologiczny zapis zdarzeń – kto, kiedy, na którym czytniku został zaakceptowany lub odrzucony i z jakiego powodu.

Co zawiera eksport

Każdy wiersz eksportu reprezentuje jedno zdarzenie systemu dostępu z następującymi danymi:

• Użytkownik – imię i nazwisko
• Data i czas – dokładny czas zdarzenia
• Czytnik kart – nazwa i lokalizacja czytnika
• Wynik – zgoda / odmowa
• Powód – powód odmowy (jeśli dotyczy)

Konfiguracja eksportu

1. Utwórz nowy eksport typu Dziennik dostępu
2. Wprowadź Nazwa eksportu
3. Wybierz okres czasu dla eksportu (zakres eksportu)
4. Ustaw automatyczną aktualizację (opcjonalnie)
5. Zapisz eksport i uzyskaj URL do pobrania

Eksport jest dostępny w formatach CSV, JSON, XLSX lub XML.

Obecność

Eksport obecności na podstawie danych z systemu dostępu generuje przejrzysty raport, pokazujący, kiedy pracownicy przyszli i wyszli oraz ile godzin przepracowali.

Założenia

Musisz mieć skonfigurowane czytniki jako „wejściowy” (wejście do budynku) i „wyjściowy” (wyjście z budynku). Musi istnieć przynajmniej jeden czytnik kart.

Użytkownicy muszą mieć przypisane karty dostępu ze swoim imieniem i nazwiskiem.

Konfiguracja eksportu

1. Utwórz nowy eksport typu Obecność
2. Wprowadź Nazwa eksportu
3. Czytniki kart wejściowych :**
   • Wybierz czytniki, które służą do wejścia do budynku (czytniki wejściowe)
4. Czytniki kart wyjściowych :**
   • Wybierz czytniki, które służą do wyjścia z budynku (czytniki wyjściowe)
5. Wybierz okres czasu dla eksportu
6. Ustaw automatyczną aktualizację (opcjonalnie)
7. Zapisz eksport i uzyskaj URL

Co zawiera eksport

Każdy wiersz reprezentuje jeden dzień roboczy jednego pracownika:

• Data – dzień roboczy
• Imię i nazwisko – pracownik
• Pierwsze przyjście – czas pierwszego wejścia do budynku
• Ostatnie wyjście – czas ostatniego wyjścia z budynku
• Czas wewnątrz [hh:mm] – łączny czas spędzony w budynku
• Czas na zewnątrz [hh:mm] – łączny czas przerw poza budynkiem

Obliczanie czasu

Jeśli karta dostępu ma przypisanego użytkownika i użytkownik w danym dniu wszedł do budynku za pomocą czytnika, w tabeli zostanie utworzony wiersz. Uwzględniamy tylko wpisy z udanym dostępem.

• Czas wewnątrz [hh:mm] – suma różnic czasowych między przyjściami a wyjściami. Jeśli użytkownik miał przyjście (bez wyjścia) lub wyjście (bez przyjścia) kilka razy z rzędu, brane są pod uwagę tylko pierwsze zdarzenia.

• Pierwsze przyjście – czas pierwszego wejścia do budynku.

• Ostatnie wyjście – czas ostatniego wyjścia z budynku.

• Czas na zewnątrz [hh:mm] – suma różnic czasowych między wyjściami a wejściami.

W standardowych przypadkach, gdy po przyjściu następuje wyjście, a po wyjściu może (ale nie musi) nastąpić kolejna para przyjście–wyjście, obowiązuje:

Czas wewnątrz + Czas na zewnątrz = Ostatnie wyjście - Pierwsze wejście

Format

Eksport jest dostępny w formacie XLSX (zalecany) – zawiera predefiniowaną tabelę gotową do dalszego przetwarzania.

Integracje

Wszystkie trzy typy eksportów (Wartości urządzeń, System dostępu, Obecność) można zintegrować z Google Sheets i Microsoft Excel za pomocą adresów URL generowanych przez aplikację.

Google Sheets

Instrukcje:

1. W oknie dialogowym Pobierz raport w aplikacji skopiuj URL CSV
2. Otwórz Google Sheets
3. Wklej ten wzór do dowolnej komórki:

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

4. Dane będą się automatycznie aktualizować w tle

Microsoft Excel

Wymaga desktopowej wersji Excela z Power Query (niedostępne w przeglądarkowej wersji Microsoft 365).