Skip to content
Seed tidrapportmönster (test)

Seed tidrapportmönster (test)

Upprepar en startvecka framåt över ett helt år, så att en avstämningsregel kan valideras före driftsättning — för en medarbetare, en organisationsenhet eller alla. Jobbet kan också godkänna perioderna det seedar, så att en hel konfiguration kan kontrolleras från början till slut. Endast på testarbetsytor.

Varför det finns

En arbetsyta som konfigureras i september har exakt en godkännandeperiod: september. Det finns inget Q1 och inget Q2, så det finns ingen avstämningskedja att titta på — och perioder kan aldrig skapas bakåt, eftersom varje period öppnar på den föregåendes slutsaldo.

Det här jobbet går åt andra hållet. Mata in en representativ vecka — på arbetsytans startdatum eller vilken senare vecka som helst — och låt jobbet upprepa den framåt därifrån. Varje period det skapar är den senaste, så kedjan byggs i den ordning den faktiskt skulle ha uppstått.

Det här är ett simuleringsverktyg. Det visas bara på arbetsytor som är märkta som testarbetsyta under Admin › Arbetsyta och det körs aldrig enligt schema. Det är inte tillgängligt på en kundarbetsyta.

Innan du kör det

  1. Konfigurera reglerna du vill validera — avstämningspolicyn, tidbankskontona, anställningsvillkoren med tidrapportsgodkännande påslaget.
  2. Se till att helgdagskalendern täcker de månader du är på väg att seeda. Dagar den inte täcker seedas som vanliga arbetsdagar.
  3. Ge medarbetaren något att autofylla på — en standardaktivitet eller en procentfördelning i sin aktivitetslista. Det räcker inte att slå på autofyllning i arbetstidspolicyn; utan ett mål stannar jobbet i stället för att fylla ett år med tomma dagar.
  4. Mata in din representativa vecka som den medarbetaren, via den vanliga tidrapporten. Riktiga registreringar på riktiga aktiviteter. Börja den på arbetsytans startdatum — eller var du vill och tala om för jobbet var med Mönstrets startdatum.

Ge veckan form. En vecka med exakt normtid ger en differens på noll i varje period, så inget tak slår till och inget förfaller — det seedade året skulle inte bevisa någonting. Registrera över norm vissa veckor och under andra.

Mönstret

Mönstret är det du matade in, inte något du konfigurerar. Jobbet läser sjudagarsblock från mönstrets startdatum och upprepar dem framåt. Lämnar du datumet tomt börjar det där arbetsytan börjar — eller där medarbetarens anställning börjar om den är senare, eftersom inget kan registreras före någotdera:

MönsterveckorVad som upprepas
1Ett veckomönster
2En fjortondagsrotation
4En 4-veckorsrotation — en berednings- eller jourcykel

En ”vecka” är här sju dagar från startdatumet, inte måndag till söndag, så det fungerar oavsett vilken veckodag din arbetsyta börjar på. Veckodagarna bevaras: en tisdag i mönstret landar alltid på en tisdag.

Parametrar

ParameterBetydelse
MedarbetareSeeda den här enda medarbetaren.
OrganisationsenhetSeeda alla medarbetare i den här enheten och dess underenheter.
Alla medarbetareSeeda alla medarbetare i arbetsytan.
MånaderHur långt framåt det ska upprepas, 0–24. Avrundas utåt så att varje godkännandeperiod den berör fylls helt. 0 upprepar ingenting: jobbet arbetar bara med de perioder som mönstret självt täcker — se Testa en hel konfiguration.
MönsterveckorHur många sjudagarsblock mönstret består av, 1–8.
Mönstrets startdatumDagen mönstret läses från. Lämna det tomt för att läsa från arbetsytans startdatum — eller anställningens startdatum om det är senare. Ett datum före något av dem flyttas upp till det.
Skriv över befintliga tidregistreringarErsätter arbetstid som redan finns på en måldag. Avstängt som standard.
Godkänn sammanställningar automatisktLämnar in och godkänner varje seedad period, äldst först, för medarbetarens och chefens räkning. Avstängt som standard.

Välj exakt en av Medarbetare, Organisationsenhet och Alla medarbetare. Varje medarbetare seedas för sig — med sitt eget mönster, sina egna anställningsvillkor och perioder. Med en enhet eller alla medarbetare hoppas en medarbetare som inte kan seedas (inga anställningsvillkor med tidrapportsgodkännande, ett tomt mönsterfönster, …) över och listas med orsaken, medan de andra seedas; med en enda medarbetare stoppas körningen i stället.

Vad jobbet gör med varje dag

Dag för dag genom det seedade intervallet:

  1. En helgdag rörs inte.
  2. En dag med frånvaro eller ledighet rörs inte — en planerad semester i månad 7 överlever körningen oförändrad.
  3. En dag som redan har arbetstid lämnas i fred, om du inte har slagit på Skriv över.
  4. Annars kopieras motsvarande dag från mönstret: både registreringar och in-/utstämplingar, på samma klockslag.
  5. En dag som mönstret lämnar tom får sin förväntade norm. På en helg eller helgdag är den noll, så de dagarna förblir tomma.

Därefter beräknar jobbet tillägg och övertid för varje dag i de perioder det täcker — de kopierade dagarna och dagar som redan fanns, till exempel registreringar som kommit in via en import och som annars inte beräknas förrän vid den nattliga körningen. Till sist skapar jobbet varje berörd godkännandeperiod och för den till klar.

Inlämning och godkännande är fortfarande ditt om du inte slår på Godkänn sammanställningar automatiskt — att själv gå igenom perioderna är ofta hela poängen: se saldot kedjas från varje periods slut in i nästa periods början. Med automatiskt godkännande lämnar jobbet in och godkänner varje period i tur och ordning, så att avstämningen körs och nästa period öppnar på det avstämda saldot. Det stannar vid en period som inte kan lämnas in (en blockerande överträdelse, eller en tidigare period som fortfarande är öppen) och anger var.

Skriv över når bara arbetstid. Frånvaro, ledighet och helgdagar avgörs innan den ens konsulteras, så ingen inställning av den reglaget kan radera planerad ledighet. Den låser inte heller upp en period du redan har lämnat in eller godkänt.

Så läser du resultatet

FältBetydelse
source_windowDagarna mönstret lästes från
resolved_spanDagarna som faktiskt seedades, efter avrundning till hela perioder
days_writtenDagar som fick registreringar
days_skippedDagar som hoppades över, per orsak: holiday, leave, has_data, locked
days_erasedRegistreringar som togs bort av Skriv över
days_reconciledDagar vars tillägg eller övertid ändrades när de beräknades
periods_readyPerioder som skapades och fördes till klar
periods_skippedPerioder som hoppades över — redan klara, eller redan inlämnade eller godkända
periods_approvedPerioder som lämnades in och godkändes (med automatiskt godkännande)
employees, employees_skippedHur många medarbetare som seedades och hur många som hoppades över
per_employeeSamma siffror för varje medarbetare, med orsaken till att en medarbetare hoppades över eller var godkännandena stannade

Med flera medarbetare är siffrorna summor för alla.

Stäm av days_skipped.holiday mot de helgdagar du förväntar dig i det seedade året. Noll över tolv månader betyder att helgdagskalendern inte räcker så långt.

Testa en hel konfiguration

För att kontrollera att en konfiguration räknar fram rätt siffror tar du in testmedarbetare med en hel periods registreringar — via en import eller genom att mata in dem — och kör jobbet med:

  • Alla medarbetare (eller den enhet du testar),
  • Mönstrets startdatum på periodens första dag och Mönsterveckor som täcker större delen av den,
  • Månader satt till 0, så att ingenting upprepas utöver de registreringar du matade in,
  • Godkänn sammanställningar automatiskt påslaget.

Jobbet beräknar tilläggen, godkänner perioderna och kör avstämningen, så att sammanställningarna visar de slutliga saldona, redo att jämföras med vad reglerna säger. Implementeringsteamet kör det från ett skript med arbetsytans API-nyckel.

Om du kör det igen

En andra körning med samma parametrar ändrar ingenting: dagar som redan har data hoppas över, och perioder som redan finns skapas inte igen. Vill du forma om året ändrar du mönsterveckan och kör igen med Skriv över påslaget.

Felsökning

ProblemLösning
Jobbet finns inte i listanArbetsytan är inte märkt som testarbetsyta
”no registrations between …”Mönsterfönstret är tomt — mata in veckan först eller peka mönstrets startdatum mot den vecka du faktiskt matade in
”nothing to register norm time on”Aktivitetslistan har varken standardaktivitet eller procentfördelning — ange en. Att autofyllningen är påslagen i arbetstidspolicyn ger den inte i sig ett mål
”do not enable timesheet approval”Slå på tidrapportsgodkännande i medarbetarens anställningsvillkor
”exactly one of employee_id, org_unit_id or all_employees”Välj en omfattning: en medarbetare, en organisationsenhet eller Alla medarbetare
En medarbetare hoppades överper_employee anger orsaken — samma meddelanden som i den här tabellen
Godkännandena stannade vid en periodper_employee anger perioden och varför: en blockerande överträdelse (till exempel en arbetsdag utan registrering), eller en tidigare period som inte är godkänd än
Varje periods differens är hela den arbetade tidenDe seedade dagarna har ingen förväntad norm — kontrollera att anställningsvillkoren täcker det seedade året
Helgdagar seedades som arbetsdagarHelgdagskalendern täcker inte de månaderna
En period hoppades överDen var redan inlämnad eller godkänd; öppna den igen först om den skulle seedas om