Sync-Agent
Automatische Synchronisierung von Anwesenheitsdaten von ZKTeco-Geräten zur AttendUX-Cloud.
Übersicht
Der AttendUX Sync-Agent ist eine leichtgewichtige Windows-Desktop-Anwendung, die Ihre lokalen ZKTeco-Geräte mit der AttendUX-Cloud-Plattform verbindet.
Er läuft im Hintergrund und ruft regelmäßig Anwesenheitsdaten von Ihren ZKTeco-Geräten ab und lädt sie automatisch auf Ihren AttendUX-Server hoch.
Download & Installation
Laden Sie den Sync-Agent-Installer herunter und folgen Sie dem Einrichtungsassistenten:
Installer herunterladen
Laden Sie die neueste Version des Sync-Agents herunter: Attendux-Sync-Agent.exe herunterladen
Installer ausführen
Doppelklicken Sie auf die heruntergeladene Datei und folgen Sie dem Installationsassistenten. Akzeptieren Sie die Standardeinstellungen.
Agent starten
Nach der Installation startet der Sync-Agent automatisch. Sie sehen sein Symbol in der Taskleiste.
AttendUX Sync Agent
v2.1.0 · Windows Desktop
Konfiguration
Konfigurieren Sie den Sync-Agent mit Ihren Serverdetails und Geräteinformationen:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Server-URL | Ihre AttendUX-Serveradresse | https://ihrfirma.attendux.com |
| Firmencode | Ihre eindeutige Firmenkennung | COMP-001 |
| API-Schlüssel | Authentifizierungsschlüssel aus Einstellungen → Integrationen | sk_live_xxx... |
| Sync-Intervall | Wie oft Daten synchronisiert werden (in Minuten) | 5 |
| Geräte-IP | Lokale IP-Adresse des ZKTeco-Geräts | 192.168.1.201 |
So funktioniert die Synchronisierung
Der Sync-Prozess folgt automatisch diesen Schritten:
Mit Gerät verbinden
Der Agent verbindet sich über das lokale Netzwerk per TCP/IP mit Ihrem ZKTeco-Gerät.
Neue Datensätze abrufen
Er ruft alle neuen Anwesenheitsstempel seit der letzten Synchronisierung ab.
In die Cloud hochladen
Datensätze werden sicher per HTTPS an Ihren AttendUX-Server gesendet und automatisch den Mitarbeitern zugeordnet.
Als Dienst ausführen
Für maximale Zuverlässigkeit können Sie den Sync-Agent als Windows-Dienst konfigurieren, damit er automatisch beim Computerstart startet.
Öffnen Sie die Sync-Agent-Einstellungen und aktivieren Sie "Als Windows-Dienst ausführen". Dies gewährleistet die Synchronisierung auch ohne angemeldeten Benutzer.
Fehlerbehebung
Häufige Sync-Probleme und deren Lösung:
Überprüfen Sie die Geräte-IP, stellen Sie sicher, dass das Gerät eingeschaltet ist und Computer und Gerät im selben Netzwerk sind. Versuchen Sie, die Geräte-IP anzupingen.
Stellen Sie sicher, dass der API-Schlüssel korrekt und nicht abgelaufen ist. Überprüfen Sie, ob die Server-URL https:// enthält. Prüfen Sie, ob neue Anwesenheitsdaten auf dem Gerät vorhanden sind.
Der Agent hat eine eingebaute Deduplizierung. Bei doppelten Einträgen leeren Sie den Agent-Cache und synchronisieren Sie erneut. Stellen Sie sicher, dass nur eine Agent-Instanz läuft.