Kjøre aktivering for en periode¶

Aktivering av timer kjører rapporten som danner grunnlaget for et regnskapsbilag i NXT. På /approval/timer-aktivering velger du periode (fra-/til-dato), trykker Kjør rapport, og får tilbake et rutenett med linjer per art, konto, avdeling og prosjekt. Ingenting er bokført før du eventuelt går videre og oppretter bilaget i samme fane.

Konsulent/administrator-oppgave: Siden er styrt av modultilgang (moduleId 18) og krever at varianten er konfigurert riktig i fanen Innstillinger. Sluttbrukere har normalt ikke tilgang.

Tilgang¶

Hvem	Hva trengs
Rolle	Administrator eller Konti-konsulent
Modul	Aktivering timer (moduleId 18, route `/approval/timer-aktivering`)
Guards	`ActivateService` + `ModuleGuard` med `objectType: 'Approval.TimerAktivering'` (approval-routing.module.ts:24)
Integrasjon	NXT-integrasjon (rapporten henter både timeregistreringer fra ePortal og regnskapsdata fra NXT i samme kjøring)

Sånn ser siden ut¶

Siden har tre faner (timer-aktivering.component.html:11-393):

Fane	i18n-nøkkel	Innhold
Rapport	`TimerAktivering.tabReport`	Periode-velger, Kjør rapport-knapp, rapport-grid, og — etter at rapporten er kjørt — inline kort for å opprette bilag
Innstillinger	`TimerAktivering.tabSettings`	Variant-valg og alle satser/kontoer for varianten
Bilagshistorikk	`TimerAktivering.tabHistory`	Tidligere kjøringer for valgt periode (status, bilag-ID, antall linjer, hvem som kjørte)

Forutsetninger¶

Aktiv NXT-integrasjon (rapporten henter regnskapsdata fra konto 5000–5989 og posterer mot NXT-konti)
Varianten i fanen Innstillinger er konfigurert ferdig (variant A–C/E–H med tilhørende ansattnr-intervaller, satser og kontoer — se Velge variant)
Du vet hvilken periode (fra-dato → til-dato) som skal aktiveres

Periode-vinduet er forhåndsutfylt basert på TimeConfig.cutOffDate fra localStorage og bruker samme cut-off-logikk som Kontroller timer (timer-aktivering.component.ts:103-186).

Periode-velger og navigasjon¶

Øverst i Rapport-fanen finner du:

Fra-dato og Til-dato — ngbDatepicker med format dd.mm.åååå (component.html:22-45)
Pil venstre / pil høyre — flytter både fra- og til-dato én måned bakover/fremover i kalenderen (component.html:46-52, implementert i changePeriod() på component.ts:328-338)
Kjør rapport — primærknapp, deaktiveres mens en kjøring pågår

Når du flytter perioden, settes også Bilagsdato og Valuteringsdato automatisk til den nye til-datoen.

En blå info-boks under linjen forklarer periode-regelen (no.json:11644): "Timeregistreringer fra ePortal hentes fra valgt fra-til periode. Regnskapsdata hentes for bokført lønnskost basert på til-perioden, og bokføres i til-periodens måned." Hvis perioden for eksempel er 21.05-20.06, hentes regnskapsdata for juni-perioden.

Slik gjør du¶

1. Åpne aktivering¶

Gå til Aktivering timer i hovedmenyen (route /approval/timer-aktivering). Fanen Rapport åpnes som standard.

2. Bekreft eller juster periode¶

Sjekk at Fra-dato og Til-dato matcher perioden du skal aktivere. Forhåndsutfylt verdi følger cut-off-regelen — juster med datovelgerne eller pil-knappene ved behov.

3. (Valgfritt) Bekreft varianten¶

Hvis du er usikker på om riktig variant er aktiv, åpne fanen Innstillinger. Den valgte varianten er markert med mørk venstrekant og badgen Valgt i variant-kortet til høyre (component.html:319-333). Varianten endres ikke her — kun vises. Se Velge variant for endring.

4. Klikk Kjør rapport¶

Trykk Kjør rapport (component.html:54-58). Knappen viser en spinner mens kjøringen pågår. Backend kalles via runReport() med dato-intervallet og en GUID-sessionID (component.ts:217-245).

5. Les KPI-bar og diagnostikk-logg¶

Etter at rapporten er kjørt vises (component.html:124-141):

KPI-linje med antall rader og sum beløp (totalBeloep)
Logg (NXT-henting) — sammenleggbar liste med Info/Warning/Error-meldinger fra backend. Logger med advarsler eller feil åpnes automatisk

6. Gå gjennom rapport-rutenettet¶

Rutenettet er en konti-smart-grid med disse kolonnene (component.ts:81-96): År, Periode, Dato, Art, Tekst, Antall, Debet, Kredit, Beløp, KontoX, Avdeling, Prosjekt, AO, Kilde (sourceType).

Du kan søke globalt, filtrere per kolonne og eksportere til Excel direkte fra grid-headeren (exportFilename="timeraktivering"). For konkrete sjekkpunkter, se Kontrollere rapport.

7. (Valgfritt) Opprett bilag i samme fane¶

Når rapporten er kjørt vises et eget kort Opprett aktiveringsbilag i samme rad som periode-velgeren (component.html:62-115). Her bekrefter du Bilagsdato og Valuteringsdato og trykker Opprett bilag. Detaljer i Opprette bilag.

Hvis perioden allerede er overført én eller flere ganger, vises en gul advarsel Denne perioden er allerede overført {{count}} gang(er). Kontroller Bilagshistorikk før ny overføring. (no.json:11654).

Resultat¶

Etter en vellykket kjøring av Kjør rapport (ingen bokføring):

reportRan = true — periode-kort for bilag og KPI-linje vises
Rapport-grid fylles med alle linjer (timeregistrering + evt. regnskapsposter)
Diagnostikk-logg viser advarsler/feil fra hentingen
Bilagshistorikk (fanen) oppdateres til samme periode

Ingen poster sendes til NXT før du trykker Opprett bilag.

Vanlige problemer¶

"Ingen rader funnet for valgt periode"¶

Vises som TimerAktivering.noRows når rapporten kjørte uten feil men ga 0 rader. Sannsynlige årsaker:

Periode-vinduet inneholder ingen godkjente timer
Ansattnr-intervallene (ansNrAdmFrom/To, ansNrMontFrom/To) ekskluderer alle ansatte — sjekk i fanen Innstillinger
Variant-valg passer ikke til datagrunnlaget (f.eks. variant uten investeringsblokk når kun regnskapsposter finnes)

Advarsler/feil i "Logg (NXT-henting)"¶

Loggen åpnes automatisk når det finnes en advarsel eller en feil (hasDiagIssue på component.ts:58-63). Hver linje viser nivå (Info/Warning/Error) og en melding fra backend. Korriger underliggende konfigurasjon (variant, satser, konto-intervall) før du oppretter bilag.

"Bilag opprettet" mangler — kun gul melding¶

Hvis createVoucher returnerer suksess men uten voucherID, vises batchResult.message (typisk TimerAktivering.voucherNoRows = "Ingen rader å bokføre.") i en gul boks. Sjekk filteret i rapporten og at perioden faktisk har rader før retry.

"Denne perioden er allerede overført N gang(er)"¶

currentPeriodSuccessfulCount > 0 (component.ts:344-356) — det finnes minst én tidligere SUCCESS-overføring for samme fra/til. Sjekk fanen Bilagshistorikk før du oppretter et nytt bilag, ellers risikerer du dobbel bokføring i NXT.

Generell feil-toast¶

Hvis backend returnerer success: false eller HTTP-feil, vises en rød toast med errorMessage fra responsen, eller General.error som fallback (component.ts:388-391).