Zeitnachweismuster erzeugen (Test)
Wiederholt eine erste Woche über einen Zeitraum von bis zu zwei Jahren, damit eine Abrechnungsregel vor dem Livegang geprüft werden kann — für eine Person, eine Einheit oder alle. Der Job kann die erzeugten Perioden auch genehmigen, sodass sich eine gesamte Einrichtung von Anfang bis Ende prüfen lässt. Nur in Testarbeitsbereichen.
Wozu es ihn gibt
Ein im September konfigurierter Arbeitsbereich hat genau eine Genehmigungsperiode: September. Es gibt kein erstes und kein zweites Quartal, also keine Abrechnungskette, die man sich ansehen könnte — und Perioden können nie in der Vergangenheit angelegt werden, weil jede mit dem Endsaldo der vorherigen beginnt.
Dieser Job geht den umgekehrten Weg. Erfassen Sie eine repräsentative Woche — am Startdatum des Arbeitsbereichs oder in einer beliebigen späteren Woche — und lassen Sie den Job sie von dort aus wiederholen. Jede angelegte Periode ist die jeweils neueste, sodass die Kette in der Reihenfolge entsteht, in der sie tatsächlich entstanden wäre.
Bevor Sie ihn ausführen
- Konfigurieren Sie die Regeln, die Sie prüfen möchten — die Abrechnungsregel, die Stundenkonten, die Anstellungsbedingungen mit eingeschalteter Genehmigung von Zeitnachweisen.
- Stellen Sie sicher, dass der Feiertagskalender die Monate abdeckt, die Sie erzeugen möchten. Nicht abgedeckte Tage werden als normale Arbeitstage erzeugt.
- Geben Sie der Person ein Ziel für die automatische Erfassung — eine Standardaktivität oder eine prozentuale Aufteilung in ihrer Aktivitätsliste. Die automatische Erfassung in der Arbeitszeitregelung einzuschalten reicht allein nicht aus; ohne Ziel bricht der Job ab, statt ein Jahr leerer Tage zu füllen.
- Erfassen Sie als diese Person Ihre repräsentative Woche über den normalen Zeitnachweis. Echte Einträge auf echten Aktivitäten. Beginnen Sie am Startdatum des Arbeitsbereichs oder an einer beliebigen Stelle und teilen Sie dem Job diese über Startdatum mit.
Geben Sie der Woche ein Profil. Eine Woche mit exakt der Sollzeit ergibt in jeder Periode eine Differenz von null, sodass nie eine Obergrenze erreicht wird und nichts verfällt — das erzeugte Jahr würde nichts beweisen. Erfassen Sie in manchen Wochen mehr als die Sollzeit und in anderen weniger.
Das Muster
Das Muster ist das, was Sie erfasst haben, nichts, was Sie konfigurieren. Der Job liest ganze Wochen ab der Woche, in die das Startdatum fällt, und wiederholt sie bis zum Enddatum. Lassen Sie das Startdatum leer, beginnt er dort, wo der Arbeitsbereich beginnt — oder dort, wo die Anstellung der Person beginnt, falls das später ist, da vor beidem nichts erfasst werden kann:
| Musterwochen | Was sich wiederholt |
|---|---|
| 1 | Ein Wochenmuster |
| 2 | Ein zweiwöchiger Wechsel |
| 4 | Ein vierwöchiger Wechsel — ein Rufbereitschafts- oder Bereitschaftszyklus |
| Leer | Nichts: Die Einträge bleiben, wie sie sind — siehe Eine gesamte Einrichtung testen |
Eine Woche läuft hier von Montag bis Sonntag, das Muster ist also derselbe Wechsel, egal an welchem Wochentag der Zeitraum beginnt. Wochentage bleiben erhalten: Ein Dienstag im Muster wird immer auf einen Dienstag kopiert.
Optionen
| Option | Bedeutung |
|---|---|
| Mitarbeitende | Diese eine Person erzeugen. |
| Organisationseinheit | Jede Person in dieser Einheit und ihren Untereinheiten erzeugen. |
| Alle Mitarbeitenden | Jede Person im Arbeitsbereich erzeugen. |
| Startdatum | Wo der Zeitraum beginnt. Leer lassen, um am Startdatum des Arbeitsbereichs zu beginnen, oder am Beginn der Anstellung, falls das später ist. Ein Datum davor wird auf diesen Zeitpunkt vorgezogen. |
| Enddatum | Wo der Zeitraum endet. Leer lassen, um heute zu enden. Wird nach außen gerundet, sodass jede Genehmigungsperiode, die der Zeitraum berührt, vollständig erzeugt wird. Höchstens 24 Monate nach dem Startdatum. |
| Musterwochen | Aus wie vielen Wochen das Muster besteht, 1–8. Leer lassen, um nichts zu füllen: Der Job bearbeitet dann nur die Perioden, die der Zeitraum berührt, so wie sie sind — siehe Eine gesamte Einrichtung testen. |
| Bestehende Zeiteinträge überschreiben | Ersetzt Arbeitszeit, die an einem Zieltag bereits vorhanden ist. Standardmäßig aus. |
| Periodenabschlüsse automatisch genehmigen | Reicht jede erzeugte Periode ein und genehmigt sie, die älteste zuerst, im Namen der Person und ihrer Führungskraft. Standardmäßig aus. |
Wählen Sie genau eine der Optionen Mitarbeitende, Organisationseinheit und Alle Mitarbeitenden. Jede Person wird für sich erzeugt — mit ihrem eigenen Muster, ihren Anstellungsbedingungen und Perioden. Bei einer Einheit oder allen Mitarbeitenden wird eine Person, die nicht erzeugt werden kann (keine Anstellungsbedingungen mit Genehmigung von Zeitnachweisen, ein leeres Musterfenster …), übersprungen und mit dem Grund aufgeführt, und die übrigen werden erzeugt; bei einer einzelnen Person bricht der Lauf stattdessen ab.
Was der Job mit jedem Tag tut
Der Job geht den erzeugten Zeitraum Tag für Tag durch:
- Ein Feiertag bleibt unberührt.
- Ein Tag mit einer Abwesenheit bleibt unberührt — ein geplanter Urlaub im siebten Monat bleibt, wie er ist.
- Ein Tag, der bereits Arbeitszeit enthält, bleibt unverändert, es sei denn, Sie haben Überschreiben angekreuzt.
- Andernfalls wird der passende Tag des Musters übernommen: Einträge und Ein-/Ausstempelungen gleichermaßen, zu denselben Uhrzeiten.
- Ein Tag, den das Muster leer lässt, erhält seine erwartete Sollzeit. An einem Wochenende oder Feiertag ist diese null, diese Tage bleiben also leer.
Anschließend bewertet der Job Zuschläge und Überstunden an jedem Tag der abgedeckten Perioden — an den kopierten Tagen und an bereits vorhandenen, etwa an Einträgen aus einem Import, die sonst erst im nächtlichen Lauf bewertet werden. Schließlich legt er für jede abgedeckte Genehmigungsperiode die Periode an und setzt sie auf bereit.
Einreichen und Genehmigen bleibt Ihnen überlassen, es sei denn, Sie schalten Periodenabschlüsse automatisch genehmigen ein — die Perioden selbst durchzugehen ist oft genau der Zweck der Übung: Beobachten Sie die Saldokette vom Abschluss jeder Periode bis zum Anfang der nächsten. Mit eingeschalteter automatischer Genehmigung reicht der Job jede Periode der Reihe nach ein und genehmigt sie, sodass die Abrechnung läuft und die nächste Periode mit dem abgerechneten Saldo beginnt. Er hält bei einer Periode an, die nicht eingereicht werden kann (ein blockierender Verstoß oder eine frühere, noch offene Periode), und meldet, wo.
Die Ergebnisse des Laufs lesen
| Feld | Bedeutung |
|---|---|
source_window | Die Tage, aus denen das Muster gelesen wurde |
resolved_span | Die tatsächlich erzeugten Tage, nach dem Runden auf ganze Perioden |
days_written | Tage, die Einträge erhalten haben |
days_skipped | Unberührt gelassene Tage, nach Grund: holiday, leave, has_data, locked |
days_erased | Durch Überschreiben entfernte Einträge |
days_reconciled | Tage, deren Zuschläge oder Überstunden sich bei der Bewertung geändert haben |
periods_ready | Angelegte und auf bereit gesetzte Perioden |
periods_skipped | Unberührt gelassene Perioden — bereits bereit oder bereits eingereicht bzw. genehmigt |
periods_approved | Eingereichte und genehmigte Perioden (mit automatischer Genehmigung) |
employees, employees_skipped | Wie viele Mitarbeitende erzeugt und wie viele übersprungen wurden |
per_employee | Dieselben Anzahlen für jede Person, mit dem Grund, warum eine Person übersprungen wurde oder wo ihre Genehmigungen angehalten haben |
Bei mehreren Mitarbeitenden sind die Anzahlen Summen über alle.
Gleichen Sie days_skipped.holiday mit den Feiertagen ab, die Sie im erzeugten Jahr erwarten. Eine Anzahl von null über zwölf Monate bedeutet, dass der Feiertagskalender nicht so weit reicht.
Eine gesamte Einrichtung testen
Um zu prüfen, ob eine Konfiguration die richtigen Zahlen berechnet, legen Sie Testmitarbeitende mit einer ganzen Periode an Einträgen an — über einen Import oder durch Eintippen — und führen Sie den Job aus mit:
- Alle Mitarbeitenden (oder der zu testenden Einheit),
- Startdatum am ersten Tag der ersten Periode und Enddatum am letzten Tag der letzten,
- leeren Musterwochen, damit nichts gefüllt wird: Die Einträge bleiben, wie Sie sie erfasst haben, und ein leer gelassener Tag bleibt leer,
- eingeschaltetem Periodenabschlüsse automatisch genehmigen.
Der Job bewertet die Zuschläge, genehmigt die Perioden und führt die Abrechnung aus, sodass die Periodenabschlüsse die endgültigen Salden zeigen, bereit zum Vergleich mit dem, was die Regeln besagen. Das Implementierungsteam führt dies per Skript mit dem API-Schlüssel des Arbeitsbereichs aus.
Erneut ausführen
Ein zweiter Lauf mit denselben Optionen ändert nichts: Tage mit Daten werden übersprungen, und bestehende Perioden werden nicht neu angelegt. Um das Jahr umzugestalten, ändern Sie die Musterwoche und führen Sie den Job mit eingeschaltetem Überschreiben erneut aus.
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Der Job ist nicht in der Liste | Der Arbeitsbereich ist nicht als Testarbeitsbereich markiert |
| „no registrations between …“ | Das Musterfenster ist leer — erfassen Sie zuerst die Woche oder setzen Sie das Startdatum auf die Woche, die Sie erfasst haben |
| „months is no longer an option“ | Der Zeitraum hat Monate ersetzt: Geben Sie stattdessen ein Start- und ein Enddatum an |
| „nothing to register norm time on“ | Die Aktivitätsliste hat weder eine Standardaktivität noch eine prozentuale Aufteilung — legen Sie eine fest. Das eingeschaltete Plug-in zur automatischen Erfassung in der Arbeitszeitregelung gibt ihm allein noch kein Ziel |
| „do not enable timesheet approval“ | Schalten Sie in den Anstellungsbedingungen der Person die Genehmigung von Zeitnachweisen ein |
| „exactly one of employee_id, org_unit_id or all_employees“ | Wählen Sie einen Umfang: eine Person, eine Organisationseinheit oder Alle Mitarbeitenden |
| Eine Person wurde übersprungen | per_employee nennt den Grund — dieselben Meldungen wie in dieser Tabelle |
| Genehmigungen haben bei einer Periode angehalten | per_employee nennt die Periode und den Grund: einen blockierenden Verstoß (etwa einen Arbeitstag ohne Eintrag) oder eine frühere Periode, die noch nicht genehmigt ist |
| Die Differenz jeder Periode entspricht der gesamten gearbeiteten Zeit | Die erzeugten Tage haben keine erwartete Sollzeit — prüfen Sie, ob die Anstellungsbedingungen das erzeugte Jahr abdecken |
| Feiertage wurden als Arbeitstage erzeugt | Der Feiertagskalender deckt diese Monate nicht ab |
| Eine Periode wurde übersprungen | Sie war bereits eingereicht oder genehmigt; öffnen Sie sie zuerst wieder, wenn Sie sie neu erzeugen wollten |