--- title: "Automatyczne eksporty" description: "Eksport wartości urządzeń, systemu dostępu i obecności z TapHome przez URL do Google Sheets i Excela, z automatyczną aktualizacją. CSV, JSON, XLSX lub XML." url: "https://taphome.com/pl/docs/exports/" language: pl lastmod: 2026-11-01 generator: hugo ai: topics: ["automated-exports","data-export","device-statistics","access-log","attendance-tracking","google-sheets","microsoft-excel"] questions: ["Jak eksportować dane z urządzeń TapHome do Google Sheets?","Jakie formaty eksportu obsługuje TapHome?","Jaka jest maksymalna liczba wierszy w eksporcie TapHome?","Jak skonfigurować eksport obecności w TapHome?","Jak skonfigurować eksport dziennika dostępu?","Czy statystyki mogą być przeliczone, jeśli były wyłączone?","Jakie interwały próbkowania są dostępne dla eksportu wartości urządzeń?"] --- # Automatyczne eksporty Ostatnia aktualizacja: 2026-11-01 > [!NOTE] > 🚀 **Dostępność** — Core 2025.2 lub nowszy. 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//` 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ń](https://taphome.com/pl/docs/exports/#wartosci-urzadzen) Eksport wartości sensorów, stanów urządzeń i obliczonych statystyk (temperatura, zużycie energii itp.) ### [Dziennik dostępu](https://taphome.com/pl/docs/exports/#system-dostepu) Chronologiczny zapis zdarzeń systemu dostępu (kto, kiedy, który czytnik, dozwolony/odrzucony, powód) ### [Obecność](https://taphome.com/pl/docs/exports/#obecnosc) Przygotowane raporty obecności na podstawie danych z systemu dostępu, pokazujące czasy przyjść/wyjść i przepracowane godziny ### 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**; dla liczników **Suma/Całka** (energia w wierszu) zamiast średniej > [!NOTE] > 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). > [!TIP] > 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. - **Codziennie**: 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 roku**: 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 > [!TIP] > „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 > [!TIP] > „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 > [!WARNING] > Musisz mieć skonfigurowane czytniki jako „wejściowy” (wejście do budynku) i „wyjściowy” (wyjście z budynku). Musi istnieć przynajmniej jeden czytnik kart. > [!WARNING] > 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: ``` =IMPORTDATA("https://data.taphome.com/api/export/profile//data.csv") ``` 4. Dane będą się automatycznie aktualizować w tle #### Microsoft Excel > [!NOTE] > Wymaga desktopowej wersji Excela z Power Query (niedostępne w przeglądarkowej wersji Microsoft 365). **XLSX (Zalecane)** Preferowany format: XLSX Instrukcje: 1. Dane → Pobierz dane → Z sieci Web 2. Wprowadź URL: [https://data.taphome.com/api/export/profile/](https://data.taphome.com/api/export/profile/)/data.xlsx 3. Kliknij OK → Zamknij i załaduj **CSV** Alternatywny format: CSV Instrukcje: 1. Dane → Pobierz dane → Z sieci Web 2. Wprowadź URL: [https://data.taphome.com/api/export/profile/](https://data.taphome.com/api/export/profile/)/data.csv 3. W Edytorze Power Query ustaw separator i typy danych 4. Zamknij i załaduj **XML** Alternatywny format: XML Instrukcje: 1. Dane → Pobierz dane → Z sieci Web 2. Wprowadź URL: [https://data.taphome.com/api/export/profile/](https://data.taphome.com/api/export/profile/)/data.xml 3. Wybierz tabelę danych w oknie Nawigatora 4. Zamknij i załaduj **Zobacz też** — [Eksport opisów urządzeń](https://taphome.com/pl/docs/configuration/export-description/), [Przykład integracji Make.com](https://taphome.com/pl/docs/configuration/make-com-integration/).