Threads

Uhren-Leitfaden

Version
R2024.1.1
Threads

Threads steuern, wann die Uhr Routineaufgaben wie das Senden von Zeiteinträgen oder die Suche nach Software-Updates ausführt. Jede Aufgabe (Thread) kann in Intervallen oder nach einem festgelegten Zeitplan ausgeführt werden.

Diese Werte sollten nicht ohne Rücksprache geändert werden.

Sofern unten nicht anders angegeben, hat jeder Thread die folgenden Attribute:

  • name: Der eindeutige Name, der jeden Thread kennzeichnet. Die verfügbaren Threads werden in den folgenden Abschnitten beschrieben. Bearbeiten Sie diese Werte nicht.
  • active: Setzen Sie diesen Wert auf ja, um den Thread zu aktivieren, oder auf nein, um ihn zu deaktivieren.
  • interval: Gibt die Anzahl von Sekunden an, die die Uhr wartet, bis der Thread erneut ausgeführt wird.
  • retries: Gibt an, wie oft die Uhr versucht, den Thread auszuführen, nachdem er fehlgeschlagen ist. Um beispielsweise anzugeben, dass die Uhr den Thread zweimal wiederholen soll, geben Sie retries="2" an.
  • retry_interval: Gibt die Zeit an, die die Uhr wartet, bevor sie versucht, den Thread erneut auszuführen. Wenn Sie beispielsweise festlegen möchten, dass die Uhr 60 Sekunden warten soll, bevor sie es erneut versucht, geben Sie retry_interval="60" an.

Bei Bedarf können Sie einen Thread so planen, dass er zu einer bestimmten Zeit statt in einem Intervall ausgeführt wird. Löschen Sie dazu das Attribut interval="#" und geben Sie vor dem abschließenden Tag des Threads </thread> ein:

<schedules randomization="3600">
<schedule>3:00</schedule>
</schedules>

Ersetzen Sie 3600 mit der Anzahl von Sekunden, um die die Uhr die geplante Startzeit zufällig anpasst. Dies trägt dazu bei, dass mehrere Uhren an einem Standort nicht gleichzeitig einen Thread ausführen und das Netzwerk belasten.

Ersetzen Sie 3:00 mit der Uhrzeit, zu der der Thread täglich ausgeführt werden soll, im 24-Stunden-Format.

Die verfügbaren Threads sind wie folgt:

„CallHome“

Steuert, wie oft die Uhr mit dem Admin-Server kommuniziert.

„SubmitOfflinePunches“

Steuert, wie oft die Uhr Zeiteinträge sendet, die aufgezeichnet wurden, als die Uhr offline war. Dieser Thread wird nur im Online-Modus verwendet.

„SendHeartbeat“

Bestimmt, wie oft die Uhr ihren „Heartbeat“ sendet, der der Anwendung mitteilt, dass die Uhr online ist.

„SynchronizeTime“

Bestimmt, wie oft die Uhr ihre Zeit mit der Anwendung synchronisiert.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • timediff: Stellt die Zeitdifferenz dar, in der keine Synchronisierung stattfindet.
  • timesynch: Wenn hier Nein eingestellt ist, synchronisieren die Uhren ihre Zeit über einen NTP-Server.
  • Hinweis: Die Synchronisierung nach NTP muss während des Bereitstellungsprozesses ausgewählt werden.

„UpdateSoftware“

Bestimmt, wann die Uhr automatisch nach Software-Updates sucht und das Update installiert, wenn neue Software gefunden wird. Diese Aufgabe ist in der Regel so geplant, dass sie zu einer bestimmten Zeit oder kurz davor stattfindet.

In diesem Fall gibt es kein Intervallattribut. Stattdessen wird dieser Thread mit der oben beschriebenen Methode täglich ausgeführt.

Standardmäßig ist dieser Thread so konfiguriert, dass die geplante Startzeit um 2 Stunden (oder 7.200 Sekunden) randomisiert wird.

„UpdateFirmware“

Bestimmt, wie oft die Uhr nach Firmware-Updates sucht. Wenn ein Update gefunden wird, installiert die Uhr es automatisch.

„SubmitLogFiles“

Bestimmt, wann die Protokolldateien der Uhr an die Anwendung gesendet werden. Wenn das Intervall auf 0 gesetzt ist, wird die Aufgabe nur ausgeführt, wenn sie zu Diagnose- oder Fehlerbehebungszwecken ausgelöst wird.

Hinweis: Wenn das Intervall nicht auf 0 gesetzt ist, könnten die Uhren die Server überlasten.

„UpdateDatabase“

Bestimmt, wie oft die Uhr ihre Datenbank mit der Anwendung synchronisiert. Zu den synchronisierten Daten gehören die Liste der Arbeitnehmer, die Schichtpläne, Tätigkeitszuweisungen und Laufzettel, die für die Validierung an der Uhr erforderlich sind.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • <incremental_update>: Begrenzt die Menge der Informationen, die die Uhr bei der Aktualisierung der Datenbank erhält. Standardmäßig ist dieser Parameter aktiviert und die Uhr empfängt nur Informationen, die seit der letzten Ausführung des Threads aktualisiert wurden. Ist diese Funktion deaktiviert, erhält die Uhr alle Informationen aus der Datenbank, unabhängig davon, ob sie geändert wurden oder nicht.

Dieser Thread ist für Uhren, die im Online-Modus arbeiten, nicht erforderlich.

„SubmitPunches“

Bestimmt, wie oft Uhren im Standalone-Modus Zeiteinträge senden.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • <page_size>: Steuert die Anzahl der gleichzeitig übermittelten Zeiteinträge, um eine Überlastung des Servers zu vermeiden. Es wird ein Wert von 100 empfohlen.

„ExchangeBioTemplates“

Legt fest, wie häufig die Uhren kürzlich angemeldete oder geänderte biometrische Vorlagen an den Server senden und auf anderen Uhren angemeldete Vorlagen empfangen.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • <page_size>: Steuert die Menge der gleichzeitig übermittelten Daten, um eine Überlastung des Servers zu vermeiden.

„CleanupDatabase“

Bestimmt, wann die Uhr ihre Datenbank bereinigen kann. Diese Aufgabe muss zu einer Zeit mit geringer Aktivität geplant werden und nicht, während die Software aktualisiert wird.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • <punch_age>: Das Alter (in Tagen) vor der Löschung der bereinigten Zeiteinträge aus der Datenbank der Uhr.
  • <checkpoint>: Dieser Parameter darf nicht geändert werden.

„SubmitPictureTemplates“

Bestimmt, wann die Uhr die Bildvorlagen an die Anwendung überträgt. Bei diesen Bildvorlagen handelt es sich um die Bilder, die die Uhr bei der Foto-Anmeldung aufgenommen hat.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • <page_size>: Steuert die Anzahl der gleichzeitig übermittelten Vorlagen, um den Server nicht zu überlasten.

„SubmitPunchPicture“

Bestimmt, wann die Uhr Uhranzeigenbilder an die Anwendung überträgt. Es handelt sich dabei um die Bilder, die die Uhr aufnimmt, wenn sich Arbeitnehmer ein- und ausstempeln, und nicht um die Bilder, die bei der Foto-Anmeldung aufgenommen wurden.

Hinweis: Dieser Thread hat kein Intervallattribut und sollte nur so konfiguriert werden, dass er zu einem geplanten Zeitpunkt ausgeführt wird.

Diese Funktion hat die folgenden zusätzlichen Parameter:

  • <page_size>: Legt die Anzahl der gleichzeitig übermittelten Zeiterfassungsbilder fest, um eine Überlastung des Servers zu vermeiden.

„SendMessages“

Legt fest, wann die Uhr Informationen an ihre Gegenstellen sendet, wenn Uhren für die gegenseitige Kommunikation konfiguriert sind. Weitere Informationen finden Sie unter Kommunikation zwischen Uhren konfigurieren.

„SyncPeers“

Bestimmt, wie oft die Uhr aktualisierte IP-Adressen von Uhren erhält, mit denen sie für die Kommunikation konfiguriert ist. Wenn die IP-Adresse veraltet ist, speichert die Uhr alle fehlgeschlagenen Nachrichten und sendet sie erneut, sobald die Adresse aktualisiert wurde.

„EssMessageSync“

Ermittelt die Anzahl der ungelesenen Nachrichten für aktive Arbeitnehmer, die Zeiterfassungen an der Uhr vornehmen, und sendet die ungelesenen Nachrichten an die Uhr, damit sie angezeigt werden, wenn der Arbeitnehmer eine Zeiterfassung vornimmt.

„NetworkReboot“

Legt fest, wann die Uhr nach einer Unterbrechung der Netzwerkverbindung automatisch neu gestartet wird.