Automatische Exporte

🚀 Verfügbar ab Core-Version 2025.2.

Automatische Exporte ermöglichen die automatisierte Datenerfassung und Berichterstattung aus Ihrem TapHome-System. Diese Funktion speichert alle Exportparameter und ermöglicht Ihnen:

• Automatisches Laden von Daten in Google Sheets und Microsoft Excel (oder anderen Tools)
• Vordefinierte Berichte manuell aus der Anwendung für den letzten Zeitraum herunterladen
• Eigene Berichte manuell für ausgewählte Zeiträume herunterladen

Die Daten werden im Cloud-Speicher unter https://data.taphome.com/api/export/profile/<token>/ abgelegt und sind in den Formaten CSV, JSON, XLSX oder XML verfügbar.

Exporttypen

Automatische Exporte unterstützen drei verschiedene Datentypen:

Gerätewerte

Export von Sensorwerten, Gerätezuständen und berechneten Statistiken (Temperatur, Energieverbrauch usw.). Dies ist der am häufigsten verwendete Exporttyp.

Wie es funktioniert

1. Datenquellen (Spalten)

Bestimmen Sie, aus welchen Geräten und welchen Werten Sie exportieren möchten:

• Gerät: z. B. Thermostat, Temperatursensor
• Werttyp: z. B. Eingestellte Temperatur, Aktuelle Temperatur
• Aggregationsfunktion: Durchschnitt , Minimum , Maximum

Statistiken werden fortlaufend berechnet und für jedes Gerät gespeichert. Wenn Sie sie deaktivieren, ist die Generierung eines vollständigen Exports nicht mehr möglich, da historische Daten nicht nachträglich berechnet werden können.

2. Abtastintervall (Zeilen)

Bestimmt, wie oft Daten aufgezeichnet werden. Jede Zeile im Export entspricht einem Abtastintervall.

Verfügbare Intervalle: 5 Minuten, 10 Minuten, 15 Minuten, 30 Minuten, 1 Stunde, 12 Stunden, 1 Tag, 1 Woche, 1 Monat, 1 Quartal (3 Monate), 1 Jahr.

Beispiel: Bei einem Intervall von 1 Stunde enthält der Export eine Zeile pro Stunde.

3. Exportbereich

Definiert, wie viele Daten bei jedem Export generiert werden (wie viele historische Daten).

Wenn Sie einstellen:

• Exportbereich: 3 Tage
• Abtastintervall: 1 Stunde

enthält der Export: 72 Zeilen (3 Tage × 24 Stunden = 72 Zeilen)

4. Automatische Datenaktualisierung

Legen Sie fest, wann neue Daten generiert werden.

• Jeden Tag : z. B. jeden 2. Tag um 14:30
• Jede Woche : z. B. alle drei Wochen, montags um 09:00
• Jeden Monat : z. B. jeden Monat, am 15. Tag um 12:00
• Jedes Jahr : z. B. jedes Jahr, am 25.12. um 18:00

Schritt für Schritt: Export erstellen

Schritt 1: Neuen Export erstellen

1. Exportliste öffnen
2. Auf Neuen Export definieren klicken
3. Unter Name den Exportnamen eingeben

Schritt 2: Datenquellen festlegen

1. Im Abschnitt Datenquellen (Spalten) auf Spalte hinzufügen klicken
2. Gerät auswählen (z. B. Thermostat)
3. Werttyp auswählen (z. B. Eingestellte Temperatur)
4. Aggregationsfunktion auswählen (Durchschnitt , Minimum , Maximum )
5. Für alle gewünschten Spalten wiederholen

„Jede Zeile enthält: Thermostat Eingestellte Temperatur (1h-Durchschnitt), Thermostat Temperatur (1h-Minimum), Helligkeitssensor Helligkeit (1h-Maximum).“

Schritt 3: Abtastintervall festlegen

1. Im Abschnitt Abtastintervall (Zeilen) das Intervall auswählen
2. Empfehlungen:
   • 5–15 Minuten – für detaillierte Daten (großer Export)
   • 1 Stunde – für den normalen Gebrauch
   • 1 Tag/Woche – für langfristige Trends (kleiner Export)

Schritt 4: Exportbereich festlegen

1. Im Abschnitt Exportbereich die Anzahl der Perioden eingeben
2. Die Gesamtanzahl der Zeilen prüfen
3. Hinweis: Der Export darf nicht mehr als 100.000 Zeilen umfassen

„Exportierte Daten enthalten 1286 Zeilen für den Zeitraum von 3 Tagen.“

Schritt 5: Automatische Aktualisierung festlegen

1. Im Abschnitt Automatische Datenaktualisierung den Export aktivieren (Aktiviert )
2. Generierungsfrequenz festlegen (z. B. jeden Monat, am 1. Tag um 00:00)
3. Export speichern

Schritt 6: Export-URL erhalten

Nach dem Speichern generiert die Anwendung automatisch die 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

Der Token wird von der Anwendung automatisch generiert.

Wichtige Hinweise

• Aktivierung von Statistiken: Wenn Sie die Exportkonfiguration speichern, aktiviert das System automatisch alle benötigten Statistiken für die exportierten Geräte. Diese Statistiken werden fortlaufend berechnet und gespeichert. Wichtig: Statistiken können nicht rückwirkend in die Vergangenheit berechnet werden – wenn Sie sie deaktivieren, gehen historische Daten dauerhaft verloren.
• Internetverbindung: Die Steuereinheit kann Daten ohne Internetverbindung für einige Stunden speichern. Bei längerem Ausfall muss sie jedoch ältere Daten löschen, um eine Überlastung des Speichers zu vermeiden.
• Kritische Daten: Bei kritischen Daten empfiehlt es sich, eine alternative Datenerfassungslösung zu verwenden.
• Zeilenlimit: Die maximale Anzahl von Zeilen im Export beträgt 100.000.

Zugangsprotokoll

Der Export des Zugangsprotokolls generiert eine chronologische Aufzeichnung der Ereignisse – wer, wann, an welchem Kartenleser akzeptiert oder abgelehnt wurde und aus welchem Grund.

Was enthält der Export

Jede Zeile im Export repräsentiert ein Ereignis des Zugangssystems mit den folgenden Daten:

• Benutzer – Vorname und Nachname
• Datum und Uhrzeit – genaue Uhrzeit des Ereignisses
• Kartenleser – Name und Standort des Lesers
• Ergebnis – Erlaubt / Abgelehnt
• Grund – Grund der Ablehnung (falls relevant)

Exportkonfiguration

1. Einen neuen Export des Typs Zugangsprotokoll erstellen
2. Den Exportnamen eingeben
3. Zeitraum für den Export (Exportbereich) auswählen
4. Automatische Aktualisierung festlegen (optional)
5. Export speichern und URL erhalten

Der Export ist in den Formaten CSV, JSON, XLSX oder XML verfügbar.

Anwesenheit

Der Anwesenheitsexport auf Basis der Daten des Zugangssystems erzeugt einen übersichtlichen Bericht, der zeigt, wann Mitarbeiter gekommen und gegangen sind und wie viele Stunden sie gearbeitet haben.

Voraussetzungen

Sie müssen Kartenleser als „Ankunft“ (Zutritt ins Gebäude) und „Abfahrt“ (Ausgang aus dem Gebäude) konfiguriert haben. Es muss mindestens ein Kartenleser vorhanden sein.

[!WARNING] Benutzern müssen Zugriffskarten mit ihrem Namen zugewiesen sein.

Exportkonfiguration

1. Einen neuen Export des Typs Anwesenheit erstellen
2. Den Exportnamen eingeben
3. Einchecken-Kartenleser :**
   • Kartenleser auswählen, die für den Eintritt in das Gebäude dienen (Eingangskartenleser)
4. Auschecken-Kartenleser :**
   • Kartenleser auswählen, die für das Verlassen des Gebäudes dienen (Ausgangskartenleser)
5. Zeitraum für den Export auswählen
6. Automatische Aktualisierung festlegen (optional)
7. Export speichern und URL erhalten

Was enthält der Export

Jede Zeile repräsentiert einen Arbeitstag eines Mitarbeiters:

• Datum – Arbeitstag
• Vorname und Nachname – Mitarbeiter
• Erster Eintritt – Zeit des ersten Eintritts in das Gebäude
• Letzter Abgang – Zeit des letzten Austritts aus dem Gebäude
• Innenzeit [hh:mm] – Gesamtzeit im Gebäude
• Zeit außerhalb des Gebäudes [hh:mm] – Gesamtzeit außerhalb des Gebäudes

Zeitberechnung

Ist einer Zugriffskarte ein Benutzer zugewiesen und hat der Benutzer an diesem Tag das Gebäude über einen Kartenleser betreten, wird eine Zeile in der Tabelle erstellt. Es werden nur Datensätze mit erfolgreichem Zugriff berücksichtigt.

• Innenzeit [hh:mm] – Summe der Zeitunterschiede zwischen Eintritt und Austritt. Wenn der Benutzer mehrmals nacheinander eintritt (ohne Austritt) oder austritt (ohne Eintritt), wird nur das erste Ereignis berücksichtigt.

• Erster Eintritt – Zeit des ersten Eintritts in das Gebäude.

• Letzter Abgang – Zeit des letzten Austritts aus dem Gebäude.

• Zeit außerhalb des Gebäudes [hh:mm] – Summe der Zeitunterschiede zwischen Austritten und Eintritten.

In Standardfällen gilt Folgendes: Wenn nach dem Eintritt ein Ausgang folgt und nach dem Ausgang ein Paar Eintritt–Ausgang folgt (kann, muss aber nicht):

Innenzeit + Zeit außerhalb des Gebäudes = Letzter Abgang - Erster Eintritt

Format

Der Export ist im XLSX-Format verfügbar (empfohlen) – enthält eine vorkonfigurierte Tabelle, bereit für die weitere Verarbeitung.

Integrationen

Alle drei Exporttypen (Gerätewerte, Zugangsprotokoll, Anwesenheit) können über von der Anwendung generierte URLs mit Google Sheets und Microsoft Excel integriert werden.

Google Sheets

Vorgehen:

1. Im Dialog Report herunterladen in der Anwendung die CSV-URL kopieren
2. Google Sheets öffnen
3. In eine beliebige Zelle folgendes Schema eingeben:

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

4. Die Daten werden im Hintergrund automatisch aktualisiert

Microsoft Excel

Erfordert Desktop-Excel mit Power Query (nicht verfügbar in der Web-Version von Microsoft 365).