Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning

Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.

Interne links (indhold i links ikke relevant for eksterne)

https://starwiki.atlassian.net/browse/DS-12140

https://starwiki.atlassian.net/browse/BI-2482

Indholdsfortegnelse

Afgrænsning af epic

Pakke FRAVÆR-1 i Knuds liste - Beta roadmap DFDG

Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.

(kopiér og indsæt manuelt i tabellen)

[12.06.2024+13.06.2024] ovenstående tabel opdateret. [13.09.2024] tabel opdateret

Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.

Beskrivelse af epic

Baggrund

Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til fravær (ekskl. ‘sygdom - sygemelding’) følgende:

• I DFDG et skift til REST snitflader - og i denne epic uden samtidige forretningsmæssige ændringer, men dog med finjustering af validering for overlappende fravær og ændret håndtering af “Fritaget for pligt til selvbook” (id 56) og “Frataget ret til selvbook” (id 57) i forhold til borger med en frist for selvbooking. Se nærmere under AC 2

• I Jobnet en overgang til ny REST snitflade samt ny frontend arkitektur (denne opgave er ikke en del af denne epic, men vil blive specificeret i en efterfølgende epic)  

Fraværsforholdet 'sygdom - sygemelding' flyttes til forretningsområdet VisiteringOgStatus i en særskilt epic (E 1005.17.26).

Regler

Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.

Der forventes ikke ændret på gældende indberetningsregler, jf. databekendtgørelsen, ift. fravær foranlediget af denne epic.

13.08.2024. A-kassen skal, jf. databkg. § 129, som hidtil ved medlemstilgang og ved tilmelding som arbejdssøgende hente/læse en række oplysninger i DFDG. Det gælder bl.a. oplysninger fravær og fritagelser.

Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer

Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Serviceaftager skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 2025-1) forblive på eksisterende SOAP service således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.

Perioden kan dog ændres, hvis der efterfølgende kommer forretningsændringer til servicen. En sådan efterfølgende ændring af perioden, vil fremgå i epic med de nye forretningsændringer.

1005.17.25.1 - Som STAR vil jeg have flyttet forretningsområde fravær (ekskl. ‘sygdom - sygemelding’) til forretningsdomænet (silo) VisiteringOgStatus inkl. at det lever op til de principper der er fastsat

Løsningsmodel (internt STAR acc.kr.)

• Etablering af database i VisiteringOgStatus

1005.17.25.2 - Som serviceaftager og STAR vil jeg have udstillet AbsenceRegistrationService, PersonVisitationRuleService og den interne AbsenceActiveStatusService via nye REST snitflader med samme forretningslogik og operationer som den eksisterende service

Løsningsmodel

• Nye REST services i VisiteringOgStatus  

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder 

FravaerService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4341205951

Ny REST service til registrering, opdatering og sletning af fravær (ekskl. ‘Sygdom - sygemelding’)

Registrering af fravær - CreateFravaer og CreateFravaerMedIdentifier [21.08.2024]

Nye metoder CreateFravaer og CreateFravaerMedIdentifier til at registrere fravær. Ved kald af metoden vælger aftager selv om man vil medsende optionelt id for fraværet førstnævnte metode tildeler DFDG et id til fraværet. Ved kald af sidstnævnte metode tildeler det kaldende system et id til fraværet.

Afløser SOAP-udgaven AbsenceRegistrationervice # CreateAbsence.

UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4365811804/VisiteringOgStatus.FravaerService+UDV+Version+1+2024-2+3+4#CreateFravaer-(POST-%2Fv1%2FFravaer%2F%7BfravaerIdentifier%7D)

Forfining af eksisterende validering mod overlappende fraværsforhold

For fraværstyper, der ikke må overlappe, finjusteres validering således, at overlappende registreringer heller ikke kan ske, hvis allerede registreret fraværstype aktuelt er inaktiv pga. samtidigt sygefravær eller sygedagpenge-KG.

Ændret forhold til frist til selvbooking

Hidtil har det været ulovligt at oprette fravær “Fritaget for pligt til selvbook” (id 56) og “Frataget ret til selvbook” (id 57) hvis borger havde en frist. Vi ensretter funktionaliteten så fristen til selvbooking lukkes når fraværene oprettes ligesom det sker ved fravær “Kontaktforløb i a-kassen” (id 75).

FravaerService validerer imod håndtering af fravær type 11 Sygdom

[31.05.2024] Fejlkode: 100035 - Det er ikke lovligt at oprette fravær id 11 sygdom med FravaerService [04.06.2024: fejlkodenummer inddateret]

Opdatering af fravær - UpdateFravaer

Ny metode til at opdatere fravær. Afløser SOAP-udgaven AbsenceRegistrationervice # UpdateAbsence.

UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4365811804

Sletning af fravær - DeleteFravaer

Ny metode til at slette (slettemarkere) fravær. Afløser SOAP-udgaven AbsenceRegistrationervice # DeleteAbsence.

UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4365811804

GetFravaer og GetSenesteFravær GetAlleFravaer

Nye metoder GetFravaer og GetSenesteFravær GetAlleFravaer til at læse fravær. Ved kald af førstnævnte kaldes med CPR nr og id på fravær. Ved kald af sidstnævnte kaldes med CPR nr [28.05.2024] og metoden returnerer alle ikke-slettede fravær for borgeren.

I VisiteringOgStatus.VisiteringOgStatusStatusService indeholder fravaerssamling alle aktuelle fravær, dvs. fravær hvis slutdato ikke er i fortiden (men incl. aktive, inaktive og fravær med fremtidig startdato).

Opdatering af om et fraværsforhold er aktivt - intern metode i DFDG

Den interne DFDG SOAP-service AbsenceActiveStatusService # UpdateAbsenceActiveStatus benyttes til inaktivere og aktivere fraværs i forbindelse med syge og raskmelding.

Ny intern metode til at aktivere og inaktivere fraværsforhold: XXXXX

UDV-version: XXXXX

VisiteringOgStatus.FritagelseService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4465754113

[31.05.2024] Ny REST service som erstatter PersonVisitationRuleService til udstilling af fritagelser, har metoden GetAlmeneFritagelser (tidl. GetGeneralExempts)

[17.10.2024] Input skifter fra at være body til at være request parametre. Illustreret på https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4468310019

VisiteringOgStatus.VisiteringOgStatusStatusService.GetFritagelser - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4463853570#VisiteringOgStatus.VisiteringOgStatusStatusService(2024-4)-GetFritagelser(Tidl.GetPersonExempts)

[31.05.2024] Ny REST metode som erstatter PersonVisitationStatusService.GetPersonExempts

[06.08.2024] Bemærk at GetFritagelser er en POST metode aht. at kunne medtage parametre og være REST API compliant

VisiteringOgStatus.VisiteringOgStatusStatusService.GetPersonVisiteringOgStatusStatus.Fravaerssamling

[12.06.2024] Mulighed for at hente alle aktuelle fravær, dvs. fravær hvis slutdato ikke er i fortiden (men incl. aktive, inaktive og fravær med fremtidig startdato).

VisiteringOgStatus.VisiteringOgStatusStatusService.GetPersonVisiteringOgStatusStatus.Fritagelser

[13.06.2024] Mulighed for at hente aktuelle fritagelser for en borger.

1005.17.25.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade

Løsningsmodel

• Eksisterende SOAP bevares som kalder mod de nye REST services 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2025-1.

AbsenceRegistrationService

Udgår til fordel for FravaerService. Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2025-1, da der ikke forventes ændringer i den periode, der ikke kan håndteres i en SOAP-REST converter.

1005.17.25.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne

Løsningsmodel (internt STAR acc.kr.)

• Initial load af data / Tilpasning af BI load til VisiteringOgStatus domænet.

• Tilpasning leverance af data til DOA.

1005.17.25.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet

Løsningsmodel (internt STAR acc.kr.)

• QA af regler fra kode mod dokumenteret regler og fejlkode

• Ajourfører dokumentation

Sider der skal rettes og QA er (liste er ikke udtømmende)

• Servicesnitflade 

1005.17.25.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer

Løsningsmodel (internt STAR acc.kr.)

• Tilpasning af regler af for pseudonymisering og aftale hvornår data skal med i dataløft

• Systemforvalter til retter pseudonymiseringsflow 

1005.17.25.7 VisiteringOgStatus udstiller kodelisterne fraværstyper og fraværsafslutningsårsager i VisiteringOgStatus.CodelistService

Løsningsmodel 

• VisiteringOgStatus.CodelistService udstiller kodelister for fraværstyper (AbsenceTypeIdentifierType) og fraværsafslutningsårsager (AbsenceCauseTypeIdentifierType)

VisiteringOgStatus.CodelistService

Kodelister flyttes 1 til 1 fra DFDG (classic).CodeListService

• AbsenceTypeIdentifierType og

• AbsenceCauseTypeIdentifierType

• AdditionalInformationOnAbsenceTypeIdentifierType [13.09.2024] flyttet til 1005.17.26 hvor den hører til da den er knyttet til sygdom-sygemelding

• FritagelseTypeCodeList [13.09.2024] tilføjet

[13.09.2024] Kodelisterne som VisiteringOgStatus overtager ansvaret for skifter til dansk navn i 2024-4 i alle REST services. Kodelistenavne og kontrakter er uændrede i SOAP og kodelisteværdierne berøres ikke af ændringen som dermed er non-breaking change.

1005.17.25.8 PersonStatusService og PersonHistoryService udstiller ikke mere fravær. I stedet returneres en tom liste

PersonStatusService

GetVariablePersonStatus

Udstiller fra release 2025-1 ikke mere fraværsforhold, herunder sygefraværsforhold. I stedet returneres en tom liste

Kollektionen med fraværsforhold har indhold fra VisiteringOgStatus indtil da.

PersonHistoryService

GetPersonHistory

Udstiller fra release 2025-1 ikke mere fraværsforhold, herunder sygefraværsforhold. I stedet returneres en tom liste.

Kollektionen med fraværsforhold har indhold fra VisiteringOgStatus indtil da.

1005.17.25.9 - udgået

Udgået

1005.17.25.10 - Død kode i DFDG, i forbindelse med fravær, fjernes

Løsningsmodel (internt STAR acc.kr.)

• Fjernelse af gammel og død kode i DFDG classic

1005.17.25.11 - Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i VisiteringOgStatus, i stedet for AbsenceRegistrationService, PSS og PHS

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug FravaerService ved brug af nyt ClientApi fra VisiteringOgStatus.

• Kode brugt i forbindelse med AbsenceRegistrationService  er fjernet fra LSS

1005.17.25.12 - DFDG udstiller nye webservicebeskeder vedr. fraværsforhold og danner i en overgangsperiode også fraværs WSRM’er

Løsning

• Hidtidige WSRM’er og fraværsforhold dannes fortsat i en overgangsperiode

  • WsrmMessageService (version 10).GetAbsenceVersion7

    WsrmMessageService (version 10).GetDeleteAbsenceVersion6

• Nye webservicebeskeder vedr. fraværsforhold

  • Den nye besked Fravaer.WSB anvendes både ved oprettelse, opdatering og sletning af fravær

• [28.05.2024] Tilføjelse af FravaerType til body af WSB’en

Fravaer.WSB

1005.17.25.13 - DFDG batchjobs, der håndterer fravær (ekskl. sygefraværsforhold) omlægges til VisiteringOgStatus

Bl.a. følgende batchjob i DFDG classic berøres:

• DFDG-TASS-CancelEnrollmentForRelevantAbsenceTypes

• DFDG-TASS-ProcessEndAbsence75DueEndOfMembership

• DFDG-TASS-ProcessAbsenceThatHasChanged

• Andre ?

Tjekliste modernisering DFDG:

• DFDG

  • Services

    • Er pakken af service snittet jf. behov i DFDG, Jobnet, eksterne m.f.

    • Er der behov for at bevare SOAP snitfladen

    • Er dansk navngivning QA'et

    • Er der teknisk gæld eller andet der skal rettes op på (evt. spike til team/arkitekt for at identificerer)

  • Konvertering

    • Initielt load / konvertering og i hvilke siloer

  • WSRM'er
    
    

    • Skal eksisterende WSRM udsendes og hvor længe

    • Skal ny besked etableres nu eller senere

  • Kodelister, er disse flyttet til ejende domæne, er der lavet slavekodelister

  • Eventbroker

    • Er nye beskeder der skal etableres, QA af indehold og navngivning

    • Er det dokumenteret hvilke beskeder, der anvendes, og hvilke forretningsregler der er i den forbindelse

  • StatusService

    • Udfasning i PersonStatusService (PSS) 

    • Udvidelser til domænespecifikke statusservices

    • Udfasning i PersonHistoryService (PHS)

    • Udvidelse til domænespecifikke historik services

  • LSS (Landssupportsystem) og/eller Datakanon og herunder Registerudtræk (hvis STAR har dataejerskab)

  • Datamonitor. ny eller ændret overvågninger

  • Dokumentation

    • QA i forhold til at alle forretningsregler / fejlkode er tilstede

    • Dokumentation følger nye principper

• Nye batchjobs / ændret behandling af events

  • Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon) 

• Dataløft

  • Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.

• Ændringer i forhold til aflevering at Rigsarkivet

• GDPR sletninger m.v.

• Interne afhængigheder idenitfiseret (Jobnet, VITAS, JobAG, BI integrationsplatform andre domæner m.v.)

• Eksterne afhængigheder indenitfiseret (Kommunalt sagsbehandlingssystem, A-kasse sagsbehandlingssystem, Kommunalt bookingsystem (WorkForcePlanner (WFP), M4 Booking, Schultz Booking). Kommunalt ydelsessystem (KY), Kommunalt sygedagpengesystem (KSD), EG kommune informatiom m.fl.)

Særlige krav til test

19.06.2024: Tabel opdateret

* Batchjobs

• bør testes både med delta og fuldt load,

• bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden

• bør testes i samarbejde med teams som har afhængigheder

• kørselstid, særligt hvis det er en del af NightlyBatch

Konsekvenser for drift/idriftsættelse

I forbindelse med idriftsættelse:

• Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres:  

• Skal der køres konvertering:  

• Skal der køres databasescripts for opdatering af tabeller i databasen:  

BI foretager initial load af forsørgelseshistorik i ydelsesudstilling silo. Der er ikke tale om konvertering i denne forbindelse da det er samme loadmodel som i den gamle forsørgelseshistorik på DFDG classic.

Efter idriftsættelse:

N/A

Arkitektur- og implementeringsnoter 

Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:

• Nye dataområder: Nej, flytning til domæne Ydelsesudstilling 

• Nye snitflader: Nej, flytning til domæne Ydelsesudstilling

• Nye komponenter: Nej 

• Nye miljøer: Nej 

• Nye teknologier: Modernisering 

• Nye aftagertyper: Nej 

• Eller afvigelser fra principperne: Nej 

• Eventuelle behov for reduktion af teknisk gæld skal afdækkes: N/A 

Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.

Husk GDPR stillingtagen

Ingen personfølsomme data i epics

Illustrationer, skærmdumps m.v. må ikke indeholde cpr.nr., CV. nr., rigtige personnavne på borgere eller deres kontaktoplysninger i form af e-mail, telefonnr., adresse m.v.

• Angiv hvem der har foretaget dette tjek: 

• Angiv dato for tjek: 

Opbevaring af oplysninger i STARs it-systemer

Ved oprettelse af nye dataområder skal der tages stilling til, hvornår formålet med data ophører og dermed fastlægges en slettepolitik.

Ved indførelse af nye data på eksisterende dataområder skal GDPR slettejobs opdateres.

Dette er ikke et nyt dataområde blot en flytning fra DFDG classic og til XXXXX. 

Hvem må tilgå oplysningerne?

Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.

Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.  

Korrekte sikkerhedsattributter på services

PO skal for hver enkelt servicemetode angive hvilke myndighedstyper, der må kalde de forskellige servicemetoder.

Tilladte organisationer (eksempel - se den fulde liste over myndighedstyper på siden DFDGs sikkerhedsmodel )

A-kasse filtrering

Hvis a-kassen må anvende metoden, må a-kassen så se / hente alle data? Eller skal der foretages filtrering ift. at a-kassen fx kun må se nogle udfaldsrum / kodelisteværdier? Husk at filtreringen skal ramme eventuel visning på Jobnet aht. sagsbehandlerlogin

XXXXX

Sagsbehandlerlogin på Jobnet - tag stilling til adgang!

En sagsbehandler i et jobcenter kan tilgå en borger tilknyttet det konkrete jobcenter.

En sagsbehandler i en a-kasse kan tilgå en borger, som er medlem af a-kassen og KG 1 (tilmeldt og ikke-tilmeldt) eller KG 8 og tilmeldekategori 5 - dimittend.

Begrænsninger kan foretages via (a-kasse-) filtrering, eller ved at afgrænse på action niveau på konkrete sider på Jobnet.

Stillingtagen: Beskriv kort, at der er taget stilling til sagsbehandlerlogin

XXXXX