Zum Inhalt springen
Zeitnachweismuster erzeugen (Test)

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.

Dies ist ein Simulationswerkzeug. Es erscheint nur in Arbeitsbereichen, die unter Administration › Arbeitsbereich als Testarbeitsbereich markiert sind, und läuft nie nach Zeitplan. In einem Kundenarbeitsbereich ist es nicht verfügbar.

Bevor Sie ihn ausführen

  1. Konfigurieren Sie die Regeln, die Sie prüfen möchten — die Abrechnungsregel, die Stundenkonten, die Anstellungsbedingungen mit eingeschalteter Genehmigung von Zeitnachweisen.
  2. Stellen Sie sicher, dass der Feiertagskalender die Monate abdeckt, die Sie erzeugen möchten. Nicht abgedeckte Tage werden als normale Arbeitstage erzeugt.
  3. 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.
  4. 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:

MusterwochenWas sich wiederholt
1Ein Wochenmuster
2Ein zweiwöchiger Wechsel
4Ein vierwöchiger Wechsel — ein Rufbereitschafts- oder Bereitschaftszyklus
LeerNichts: 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

OptionBedeutung
MitarbeitendeDiese eine Person erzeugen.
OrganisationseinheitJede Person in dieser Einheit und ihren Untereinheiten erzeugen.
Alle MitarbeitendenJede Person im Arbeitsbereich erzeugen.
StartdatumWo 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.
EnddatumWo 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.
MusterwochenAus 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 überschreibenErsetzt Arbeitszeit, die an einem Zieltag bereits vorhanden ist. Standardmäßig aus.
Periodenabschlüsse automatisch genehmigenReicht 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:

  1. Ein Feiertag bleibt unberührt.
  2. Ein Tag mit einer Abwesenheit bleibt unberührt — ein geplanter Urlaub im siebten Monat bleibt, wie er ist.
  3. Ein Tag, der bereits Arbeitszeit enthält, bleibt unverändert, es sei denn, Sie haben Überschreiben angekreuzt.
  4. Andernfalls wird der passende Tag des Musters übernommen: Einträge und Ein-/Ausstempelungen gleichermaßen, zu denselben Uhrzeiten.
  5. 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.

Überschreiben betrifft nur Arbeitszeit. Abwesenheiten und Feiertage werden behandelt, bevor die Option überhaupt geprüft wird, sodass keine Stellung dieses Schalters geplante Abwesenheiten löschen kann. Sie entsperrt auch keine Periode, die Sie bereits eingereicht oder genehmigt haben.

Die Ergebnisse des Laufs lesen

FeldBedeutung
source_windowDie Tage, aus denen das Muster gelesen wurde
resolved_spanDie tatsächlich erzeugten Tage, nach dem Runden auf ganze Perioden
days_writtenTage, die Einträge erhalten haben
days_skippedUnberührt gelassene Tage, nach Grund: holiday, leave, has_data, locked
days_erasedDurch Überschreiben entfernte Einträge
days_reconciledTage, deren Zuschläge oder Überstunden sich bei der Bewertung geändert haben
periods_readyAngelegte und auf bereit gesetzte Perioden
periods_skippedUnberührt gelassene Perioden — bereits bereit oder bereits eingereicht bzw. genehmigt
periods_approvedEingereichte und genehmigte Perioden (mit automatischer Genehmigung)
employees, employees_skippedWie viele Mitarbeitende erzeugt und wie viele übersprungen wurden
per_employeeDieselben 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

ProblemLösung
Der Job ist nicht in der ListeDer 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 übersprungenper_employee nennt den Grund — dieselben Meldungen wie in dieser Tabelle
Genehmigungen haben bei einer Periode angehaltenper_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 ZeitDie erzeugten Tage haben keine erwartete Sollzeit — prüfen Sie, ob die Anstellungsbedingungen das erzeugte Jahr abdecken
Feiertage wurden als Arbeitstage erzeugtDer Feiertagskalender deckt diese Monate nicht ab
Eine Periode wurde übersprungenSie war bereits eingereicht oder genehmigt; öffnen Sie sie zuerst wieder, wenn Sie sie neu erzeugen wollten