Vergleichsreport

Der Job checkMaxWorkingTime prüft die aktuelle Arbeitszeit ausgewählter Personen gegen die im TA-System hinterlegte tägliche oder wöchentliche Höchstarbeitszeit. Im mitgelieferten Descriptor ist der Job derzeit nicht aktiv, aber konfigurierbar.

Verarbeitung

1. Die Zielpersonen werden aus der Auswahl von Personen, Gruppen und Mandanten ermittelt.
2. Über Höchstarbeitszeit wird zwischen täglicher und wöchentlicher Prüfung gewählt.
3. Der Job ermittelt zunächst die voraussichtliche Arbeitszeit. Liegt die Arbeitszeit zusammen mit der konfigurierten Schwelle bereits nahe am Limit, wird eine genauere Prüfung durchgeführt.
4. Eine Warnung wird nur erzeugt, wenn die Schwelle erreicht ist, die Höchstzeit voraussichtlich noch nicht überschritten wird und die Person aktuell anwesend oder produktiv abwesend ist.
5. Pro Job-Konfiguration und Person wird der Warnzustand für höchstens einen Tag zwischengespeichert. Dadurch wird nicht bei jedem Lauf erneut dieselbe Warnung versendet.

Konfiguration

• Personal-, Gruppen- und Mandantenauswahl: Personen, die geprüft werden sollen.
• Höchstarbeitszeit: Tägliche oder wöchentliche Prüfung.
• Schwelle in Stunden: Vorlaufzeit bis zum erwarteten Erreichen des Limits. Die Berechnung verwendet das Industriezeitformat. Ist kein Wert eingetragen, werden 2 Stunden verwendet.
• Mail Betreff und Mail Inhalt: Vorlagen der Warnmail.
• (Cc) Kopie an: Zusätzliche E-Mail-Adressen, getrennt durch Kommas.
• (Cc) Kopie an Inhaber der Rollen: Rollen, deren zuständige Personen eine Kopie erhalten.
• Parallele Verarbeitung verwenden? und Anzahl Threads für Verarbeitung: Optional parallele Prüfung mit 1 bis 5 Threads; der Standardwert für die Threadanzahl ist 2.

Platzhalter

In Betreff und Inhalt können für die Person folgende Platzhalter verwendet werdenThe checkMaxWorkingTime job checks the current working time of selected persons against the daily or weekly maximum working time stored in the TA system. In the supplied descriptor, the job is currently not active, but is configurable.

Processing

1. The target persons are determined from the selection of persons, groups, and clients.
2. The Maximum working time setting is used to choose between a daily and a weekly check.
3. The job first determines the expected working time. If the working time, together with the configured threshold, is already close to the limit, a more detailed check is performed.
4. A warning is only generated if the threshold has been reached, the maximum time is not yet expected to be exceeded, and the person is currently present or on a productive absence.
5. For each job configuration and person, the warning state is cached for at most one day. This prevents the same warning from being sent again on every run.

Configuration

• Person, group, and client selection: Persons to be checked.
• Maximum working time: Daily or weekly check.
• Threshold in hours: Lead time until the limit is expected to be reached. The calculation uses the industrial time format. If no value is entered, 2 hours are used.
• Email subject and Email content: Templates of the warning email.
• (Cc) Copy to: Additional email addresses, separated by commas.
• (Cc) Copy to holders of the roles: Roles whose responsible persons receive a copy.
• Use parallel processing? and Number of threads for processing: Optional parallel checking with 1 to 5 threads; the default value for the number of threads is 2.

Placeholders

The following placeholders can be used for the person in the subject and content: $first_name, $last_name, $full_name und , and $employee_id. Der technische Platzhalter The technical placeholder $employee_id steht für die Personalnummer. Im Mailinhalt stehen außerdem folgende formatierte Platzhalter zur Verfügung: $expectedTimeWhenReachingLimit (voraussichtlicher Zeitpunkt des Erreichens der Höchstarbeitszeit, Format stands for the personnel number.

The following formatted placeholders are also available in the email content: $expectedTimeWhenReachingLimit (expected time at which the maximum working time is reached, format HH:mm), $industryHoursUntilReachingLimit (verbleibende Industriestundenremaining industrial hours), $normalHoursUntilReachingLimit (verbleibende Normalstunden, z. B. remaining normal hours, e.g., 1:30) und , and $maxWorkingTime (Höchstarbeitszeitmaximum working time).

Im Mailinhalt stehen zusätzlich Velocity-Variablen für den erwarteten Zeitpunkt, die verbleibenden Industrie- und Normalstunden sowie die Höchstarbeitszeit zur Verfügung. Dazu gehören unter anderem In the email content, Velocity variables for the expected time, the remaining industrial and normal hours, and the maximum working time are also available. These include, among others, expectedTimeWhenReachingLimitUnformatted, industryHoursUntilReachingLimitUnformatted, normalHoursUntilReachingLimitUnformatted und , and maxWorkingTimeUnformatted.

Hinweise

Personen ohne TA-Zuordnung werden übersprungen. Fehler bei der Prüfung einer Person werden protokolliert und beeinflussen die übrigen Personen nicht. Die konkreten Höchstgrenzen liefert das TA-Konto beziehungsweise das Tages- oder Wochenprogramm.

Notes

Persons without a TA assignment are skipped. Errors when checking a person are logged and do not affect the other persons. The specific maximum limits are provided by the TA account or the daily or weekly program.

The general job parameters such as trigger and email notification apply as defined in central job management.